advent_of_code

Advent of code — Programming Christmas Puzzles

★ - both the first and the second parts are solved

☆ - only the first part is solved

• 2015 - ★★★★★ ★★★★★ ★★★★★
• 2016 - ★★★★★ ★★
• 2017 - ★★★★★ ★★★★★ ★★
• 2018 - ★★★★★ ★★★★★ ★★
• 2019 - ★★★★★ ★★★★★ ★★★
• 2020 - ★★★★★ ★★★★★ ★★★★★ ☆
• 2021 - ★★★★★ ★★★★★ ★★★★★ ★★★
• 2022 - ★★★★★ ★★★★★ ★★★★★ ★☆
• 2023 - ★★★★★ ★★★★★ ★★★★★ ★★★☆
• 2024 - ★★★★★ ★★★★★ ★★★★★ ☆

How to use

To launch the Puzzle Solver on 2017 year day 5 part “A” puzzle:

python main.py solve 2017 5 a

Requirements

Solver uses advent-of-code-data to fetch tasks from the server. You need to set up a token for it to work. See the instruction.

For Python version used for development see .python-version. The code should work fine with older versions, but it is not guaranteed.

To install requirements, uv needs to be installed first

uv sync

To update uv.lock with the newest package versions

uv sync --upgrade

Tests

I store all the tests in tests folder and use pytest as a test runner

make test

Linters

basedpyright and ruff are used to check the project

make check

Merry Christmas and Happy New Year!