Advent of Code ⭐️

Collection of my Advent of Code solutions in an overkill project setup I forked 👻🎄.

Features ✨

• Solutions are timed with the help of a decorator using time.perf_counter
• Solution and time are printed to console using the rich package with truecolor
• Solution profiler decorator using Cprofile and pstats
• Automatic listing of completed solutions in the README
• Automatic changelog, using semantic versioning and the conventional commit specification
• Pip installable (pip install -e .) with:
  • A run-all script, which dynamically calls every solution in every adventofcode.year_*.day_* module
  • An add-day script, which add a solution day file using a template and downloads the input data from the AOC site automatically
• Type checked (mypy) and linted (flake8)
• Tested against multiple python versions using tox on each push to master and pull request

Decorators

What's Christmas without decorations? 🎄

Solution timer

The solution timer times the solution using time.perf_counter and outputs the answer and the duration to the console

Example:

@solution_timer(2015, 9, 1)  # year, day, part
def part_one(input_data: List[str]) -> int:
    ...

Output:

2015 day 09 part 01: 251 in 0.1356 ms

Solution profiler

The solution profiler runs the cProfiler against the solution and outputs the profiler stats using pstats to the console. It takes an optional amount kwarg to set the amount of stats to display, and an optional sort kwarg to set the sorting to either time or cumulative.

Example:

@solution_profiler(2015, 9, 1)  # year, day, part
def part_one(input_data: List[str]) -> int:
    ...

Output:

91416 function calls (90941 primitive calls) in 0.159 seconds

Ordered by: internal time
List reduced from 217 to 3 due to restriction <10>

ncalls  tottime  percall  cumtime  percall filename:lineno(function)
    1    0.133    0.133    0.136    0.136 /Users/marcelblijleven/.../day_09_2015.py:39(_get_route_distances)
    1    0.012    0.012    0.015    0.015 /Users/marcelblijleven/.../day_09_2015.py:30(get_all_routes)
82182    0.006    0.000    0.006    0.000 {method 'append' of 'list' objects}

Scripts

add-day

The add-day script creates a file based on a 'solution day' template into the correct year module. If no input is found for that day, it will automatically download the input and save it in the inputs directory. Note: this only works if the session cookie is stored in .session. To get this value:

1. Go to the AOC site.
2. Make sure you're logged in, every user has unique input data
3. View the cookies and copy the value of the session cookie.
4. Paste the cookie value into the .session file

If you run the command without arguments, it will add input of the current day.

Example:

(venv) add-day --year 2015 --day 14

Output:

(venv) [adventofcode] add-day 2015 14                                                                                                                                                                   master  ✗ ✭ ✱
Creating solution day file for year 2015 day 14
Wrote template to /Users/marcelblijleven/code/github.com/marcelblijleven/adventofcode/src/adventofcode/year_2015/day_14_2015.py
Input data already exists for year 2015 day 14, skipping download

clean-repo

The clean-repo script is used to delete all solutions and inputs from the project. This can be useful if you want to start over, or if you've just forked this repo. The clean-repo command is run in 'dry run mode' by default, to disable it and actually start deleting directories and files, use:

(venv) clean-repo --dry-run false