Voter Participation Data Extractor for Portland, Maine

The City of Portland distributes voter participation info in PDF format. This makes it a CSV.

Prerequisites

To run this code, you'll need to have Python 3.11+ installed on your machine. You'll also need to install the required packages by running the following command from inside the project folder:

pip install uv
uv sync

Usage

1. Clone the repository and navigate to the project folder.
2. Add the city-provided PDF of voter participation data to the folder as a file titled "Voter Participation History.pdf".
3. Open a terminal and run the following command to extract data:

python -m src\voter_participation_parser.py

3. Unless there is a problem, you output will be saved as "Voter Participation History.csv".