This repository contains YAML files with official information on state, county and municipal jurisdictions, such as county government, city councils and school boards.

Setup Instructions (using uv)

Requirements

• Python 3.12 or higher
• uv (for dependency and environment management)

Installation

1. Install uv (if not already installed):

   brew install uv
   # or
   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Create and activate a virtual environment:

   uv venv .venv
   source .venv/bin/activate

3. Install dependencies:

   uv sync --all-extras

Running

To run the main script:

uv run python main.py

Development

To install development dependencies (for testing, linting, etc):

uv sync --all-extras

Run tests with:

uv run pytest

Run linter with:

uv run ruff .

Project Dependencies

• Runtime: pydantic>=2.11.9
• Development: polars>=1.33.1, pytest>=8.4.2, ruff>=0.13.2

For more details on using uv, see docs/setup_uv.md.

ENVIRONMENT