Election Tokens

This tool is used to generate secure tokens for voter verification in elections.

Install

git clone https://github.com/socrse/election-tokens.git
cd election-tokens
poetry install

Usage

First, export the membership list from WildApricot and then run the following command to filter the results:

poetry run election-tokens filter-wildapricot --people [members.csv] -o subs.csv

Then copy and fill in the example settings.ini file. The missing values are the email address and name of the sender, and an email password. To generate an email password, see the Google documentation on Using the Gmail SMTP server.

cp example-settings.ini settings.ini
nano settings.ini

Finally, generate and send tokens for each address in the membership list:

poetry run election-tokens generate -i subs.csv -o tokens.txt

Notes

The process will probably fail at some point, but a checkpoint.txt file will be created to track progress. Run the generate command again, and it will continue from where it left off.

If you send out a test email and want to test again, but nothing happens, delete checkpoint.txt and try again.

License

MIT © Society of Research Software Engineering