README.md

🏒 hockey pool picker

This is a tool to pick an optimal hockey team alignment for competing in Marqueur's hockey pool using OR-Tools's CP-SAT solver. It handles trades as the season progresses, and different strategies to evaluate players' value.

Data for this project is sourced from:

• Hockey Reference, for player and game statistics across seasons.
• Puckpedia, for player statistics and cap hits across seasons.
• Marqueur, for player cap hits across seasons.

Note

I've intentionally left out the crawled or downloaded data to avoid any legal issues. Feel free to use the crawlers here or manually download the data.

Usage

All commands offer a --help flag to display their usage.

Running the solver

uv run src/hockey_pool_picker/backtest.py

Picking a pool for an upcoming season

uv run src/hockey_pool_picker/pick_pool.py

Crawling

The Hockey Reference, and Marqueur crawlers are ran with:

uv run src/hockey_pool_picker/crawl.py

Testing

pytest

Linting and formatting

uv run ruff format src
uv run ruff check --fix src