Advent of Code

Advent of Code is an annual coding event that takes place every December. It consists of 25 daily programming puzzles of increasing difficulty, designed to challenge and entertain participants of all skill levels.

Getting Started

To get started with Advent of Code, simply visit the Advent of Code website and sign in with your account or create a new one if you haven't already. Once logged in, you'll be able to access the current year's puzzles as well as previous years' puzzles.

What can you find in here ?

Here you can find the collection of python solutions for each year and day that I have done for AOC.

Files structure

The repository is organised by year, and we can find a python file for each day. Each file has a method for part_one() and part_two().

└── 2015/
    ├── day01/
    │   ├── day01.py
    │   day02/
    │   ├── day02.py
    │   ├── ...
    └── ...

NOTE: the input data is not in the repository, you will need to use your own input file if you want to test it.

Development setup

1 - Install uv and synchronize the dependencies with Python 3.14. uv creates the .venv environment automatically:

uv sync

2 - Have fun! Run commands with uv run (no activation needed).

Quick start template

NOTE: We are using AOCD python package, the token needs to be setup in order to work .config/aocd/token

Run make run to be prompted for the year and day:

make run

To create a directory for the year and day and download the input data, use:

uv run aocx create -y 2024 -d 5

Omit -y or -d to be prompted only for the missing value. Use uv run aocx --help to see the available commands.