Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hbiede/voter-tokens

A Ruby tool to generate tokens for voters based on delegate counts for online elections and then validate those tokens when counting votes
https://github.com/hbiede/voter-tokens

ballots counting-votes google-sheets latex online-elections parse-ballots pdfs voter-tokens

Last synced: 6 days ago
JSON representation

A Ruby tool to generate tokens for voters based on delegate counts for online elections and then validate those tokens when counting votes

Host: GitHub
URL: https://github.com/hbiede/voter-tokens
Owner: hbiede
License: mit
Created: 2020-03-17T20:03:28.000Z (almost 5 years ago)
Default Branch: main
Last Pushed: 2024-06-25T19:21:13.000Z (6 months ago)
Last Synced: 2024-06-25T21:11:44.013Z (6 months ago)
Topics: ballots, counting-votes, google-sheets, latex, online-elections, parse-ballots, pdfs, voter-tokens
Language: Ruby
Size: 14.1 MB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

[![Test and Lint](https://github.com/hbiede/Voter-Tokens/actions/workflows/main.yaml/badge.svg)](https://github.com/hbiede/Voter-Tokens/actions/workflows/main.yaml)
[![codecov](https://codecov.io/gh/hbiede/Voter-Tokens/graph/badge.svg)](https://codecov.io/gh/hbiede/Voter-Tokens)
[![Ruby Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg)](https://github.com/rubocop/rubocop)

# Voter-Tokens
A Ruby tool to generate tokens for voters based on delegate counts for online elections
and then validate those tokens when counting votes

## How-To

### Requirements
- [Ruby](https://www.ruby-lang.org/en/)
- [GNU Make](https://www.gnu.org/software/make/) (optional but recommended)

### Usage
Clone this repo from Github

#### Installation
```
git clone https://github.com/hbiede/Voter-Tokens.git
cd Voter-Tokens
```

#### Generate Tokens
Update data/delegates.csv with the names of groups/individuals and how many tokens should
be generated for each. The header for the column with the group/individual must be school,
chapter, organization, or name. The header for the column with the number of votes must be
delegate, vote, or voter. Plurals of the approved headers also work (eg. voters is
allowed).

##### PDFs
To generate PDFs of your organizations' passwords (one per organization), modify
pdfs/voting.tex. This file must be valid LaTeX. PDFs can be disabled by modifying
gen\_tokens.rb so that generate\_pdfs = false and reenabled by returning it to true.

##### Run Token Generation
```
ruby gen_tokens.rb data/delegates.csv data/tokens.csv
```

#### Parse Ballots
Download the CSV of your ballots to data/votes.csv and then run the following command:
```
ruby vote_parser.rb data/votes.csv data/tokens.csv
```