1# tof-voters
2
3This tool is used for determining who is qualified for voting in a TOF election,
4based on the
5[requirements](https://github.com/openbmc/docs/blob/master/tof/membership-and-voting.md#metrics)
6set out by the TOF.
7
8The tool will query Gerrit for commits and reviews, process them, and generate a
9report of qualified individuals.
10
11The typical use of the tool is something like this:
12
13```sh
14./voters dump-gerrit --after=2021-06-30
15./voters analyze-commits --before "2022-01-01" --after "2021-06-30"
16./voters analyze-reviews --before "2022-01-01" --after "2021-06-30"
17./voters report
18cat data/report.json | \
19    jq "with_entries(select(.value.qualified) | .value = .value.points)"
20```
21
22The above will yield a JSON dictionary of "users:points" where 'qualified' is
23set in the users' dictionary from `report.json` like:
24
25```json
26{
27    "user1": 16,
28    "user2": 19,
29    ...
30}
31```
32