Advent of Code 2023 solutions in Python. It uses uv for dependencies management, typer for CLI commands, and pyinstrument for profiling. My goal is to write the most readable, understandable and maintainable solutions IMO, which are not necessarily the most performant ones.
The project comes with a dotenv file in which you can specify an AOC_SESSION_ID if you wish to automate your input retrieval, and make an answer from CLI directly.
The project uses uv for dependencies management, install it first : https://docs.astral.sh/uv/getting-started/installation/
Then, install dependencies with uv sync
Global usage
Usage: aoc.py [OPTIONS] COMMAND [ARGS]...
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy it or customize the installation. │
│ --help Show this message and exit. │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ run Run the solution for a given day. │
│ create-next-day Create the folder structure and files for the next day │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Run solution for a given day
Usage: aoc.py run [OPTIONS] DAY
Run the solution for a given day.
If --benchmark is used, pyinstrument will profile the process.
If --submit is used, solution will be submitted on AoC website using your AOC_SESSION_ID.
╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ * day INTEGER RANGE Day of solution to run (ex: 1 for day01) [default: None] [required] │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --data-type [example|input] Data type: 'input' for user data, or 'example' for example data [default: input] │
│ --benchmark --no-benchmark Activate benchmark mode is specified [default: no-benchmark] │
│ --submit --no-submit Submit the solution on AoC (AOC_SESSION_ID needed) [default: no-submit] │
│ --help Show this message and exit. │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
| Day | Part 1 | Part 2 |
|---|---|---|
| Day 1 | ⭐ | ⭐ |
| Day 2 | ⭐ | ⭐ |
| Day 3 | ⭐ | ⭐ |
| Day 4 | ⭐ | ⭐ |
| Day 5 | ⭐ | ⭐ |
| Day 6 | ⭐ | ⭐ |
| Day 7 | ⭐ | ⭐ |
| Day 8 | ⭐ | ⭐ |
| Day 9 | ⭐ | ⭐ |
| Day 10 | ⭐ | ⭐ |
| Day 11 | ⭐ | ⭐ |
| Day 12 | ⭐ | ⭐ |
| Day 13 | ⭐ | ⭐ |
| Day 14 | ⭐ | |
| Day 15 | ||
| Day 16 | ||
| Day 17 | ||
| Day 18 | ||
| Day 19 | ||
| Day 20 | ||
| Day 21 | ||
| Day 22 | ||
| Day 23 | ||
| Day 24 | ||
| Day 25 | ||
| Legend: ⭐ = Star won (solution implemented) |