Advent of Code ⭐️

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

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
• A badge that is updated automatically with the amount of stars I've collected
• A svg image that is updated automatically with the amount of stars in the style of Advent of Code
  • Has a dark mode and light mode version which are visible only when their respective mode is used by the user
  • Has an animated star emoji which helps the Elves save Christmas
• Pip installable (pip install -e .) with:
  • A generate-readme script, which updates the readme
  • A generate-benchmarks script, which runs all solutions and saves the duration of each solution to these tables
  • 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 on each push to master and pull request

<!-- start completed section -->

Completed ⭐️

2015

<details><summary>Solutions for 2015</summary> <p>

| day | part one | part two | | :---: | :------: | :------: | | 01 | ⭐️ | ⭐️ | | 02 | ⭐️ | ⭐️ | | 03 | ⭐️ | ⭐️ | | 04 | ⭐️ | ⭐️ | | 05 | ⭐️ | ⭐️ | | 06 | ⭐️ | ⭐️ | | 07 | ⭐️ | ⭐️ | | 08 | ⭐️ | ⭐️ | | 09 | ⭐️ | ⭐️ | | 10 | ⭐️ | ⭐️ | | 11 | ⭐️ | ⭐️ | | 12 | ⭐️ | ⭐️ | | 13 | ⭐️ | ⭐️ | | 14 | ⭐️ | ⭐️ | | 15 | ⭐️ | ⭐️ | | 16 | ⭐️ | ⭐️ | | 17 | ⭐️ | ⭐️ | | 18 | ⭐️ | ⭐️ | | 19 | ⭐️ | ⭐️ | | 20 | ⭐️ | ⭐️ | | 21 | ⭐️ | ⭐️ | | 22 | ⭐️ | ⭐️ | | 23 | ⭐️ | ⭐️ | | 24 | ⭐️ | ⭐️ | | 25 | ⭐️ | ⭐️ |

</p> </details>

2020

<details><summary>Solutions for 2020</summary> <p>

| day | part one | part two | | :---: | :------: | :------: | | 01 | ⭐️ | ⭐️ | | 02 | ⭐️ | ⭐️ | | 03 | ⭐️ | ⭐️ | | 04 | ⭐️ | ⭐️ | | 05 | ⭐️ | ⭐️ | | 06 | ⭐️ | ⭐️ | | 07 | ⭐️ | ⭐️ | | 08 | ⭐️ | ⭐️ | | 09 | ⭐️ | ⭐️ | | 10 | ⭐️ | ⭐️ | | 11 | ⭐️ | ⭐️ | | 12 | ⭐️ | ⭐️ | | 13 | ⭐️ | ⭐️ | | 14 | ⭐️ | ⭐️ | | 15 | ⭐️ | ⭐️ | | 16 | ⭐️ | ⭐️ |

</p> </details>

2021

<details><summary>Solutions for 2021</summary> <p>

| day | part one | part two | | :---: | :------: | :------: | | 01 | ⭐️ | ⭐️ | | 02 | ⭐️ | ⭐️ | | 03 | ⭐️ | ⭐️ | | 04 | ⭐️ | ⭐️ | | 05 | ⭐️ | ⭐️ | | 06 | ⭐️ | ⭐️ | | 07 | ⭐️ | ⭐️ | | 08 | ⭐️ | ⭐️ | | 09 | ⭐️ | ⭐️ | | 10 | ⭐️ | ⭐️ | | 11 | ⭐️ | ⭐️ | | 12 | ⭐️ | ⭐️ | | 13 | ⭐️ | ⭐️ | | 14 | ⭐️ | ⭐️ | | 15 | ⭐️ | ⭐️ | | 16 | ⭐️ | ⭐️ | | 17 | ⭐️ | ⭐️ | | 18 | ⭐️ | ⭐️ | | 19 | ⭐️ | ⭐️ | | 20 | ⭐️ | ⭐️ | | 21 | ⭐️ | ⭐️ | | 22 | ⭐️ | ⭐️ | | 25 | ⭐️ | - |

</p> </details>

2022

<details><summary>Solutions for 2022</summary> <p>

| day | part one | part two | | :---: | :------: | :------: | | 01 | ⭐️ | ⭐️ | | 02 | ⭐️ | ⭐️ | | 03 | ⭐️ | ⭐️ | | 04 | ⭐️ | ⭐️ | | 05 | ⭐️ | ⭐️ | | 06 | ⭐️ | ⭐️ | | 07 | ⭐️ | ⭐️ | | 08 | ⭐️ | ⭐️ | | 09 | ⭐️ | ⭐️ | | 10 | ⭐️ | ⭐️ | | 11 | ⭐️ | ⭐️ | | 13 | ⭐️ | ⭐️ | | 14 | ⭐️ | ⭐️ | | 15 | ⭐️ | ⭐️ |

</p> </details>

2023

<details><summary>Solutions for 2023</summary> <p>

| day | part one | part two | | :---: | :------: | :------: | | 01 | ⭐️ | ⭐️ | | 02 | ⭐️ | ⭐️ | | 03 | ⭐️ | ⭐️ | | 04 | ⭐️ | ⭐️ | | 05 | ⭐️ | ⭐️ | | 06 | ⭐️ | ⭐️ | | 07 | ⭐️ | ⭐️ | | 08 | ⭐️ | ⭐️ | | 09 | ⭐️ | ⭐️ |

</p> </details>

2024

<details><summary>Solutions for 2024</summary> <p>

| day | part one | part two | | :---: | :------: | :------: | | 01 | ⭐️ | ⭐️ |

</p> </details> <!-- end completed section --> <!-- start benchmark section -->

Benchmarks 🚀

2015

<details><summary>Benchmarks for 2015</summary> <p>

| day | part | duration | | :---: | :---: | -------: | | 01 | part one | 0.18 ms | | 01 | part two | 0.07 ms | | 02 | part one | 0.82 ms | | 02 | part two | 0.81 ms | | 03 | part one | 1.43 ms | | 03 | part two | 1.84 ms | | 04 | part one | 63.88 ms | | 04 | part two | 2104.66 ms | | 05 | part one | 0.82 ms | | 05 | part two | 1.23 ms | | 06 | part one | 3644.99 ms | | 06 | part two | 4009.98 ms | | 07 | part one | 0.79 ms | | 07 | part two | 1.50 ms | | 08 | part one | 0.75 ms | | 08 | part two | 0.26 ms | | 09 | part one | 70.58 ms | | 09 | part two | 69.41 ms | | 10 | part one | 163.72 ms | | 10 | part two | 2324.85 ms | | 10 | part two method 2 | 1818.54 ms | | 11 | part one | 0.01 ms | | 11 | part two | 0.01 ms | | 12 | part one | 0.67 ms | | 12 | part two | 0.58 ms | | 13 | part one | 62.37 ms | | 13 | part two | 591.21 ms | | 14 | part one | 10.78 ms | | 14 | part two | 10.91 ms | | 15 | part one | 354.25 ms | | 15 | part two | 122.69 ms | | 16 | part one | 0.56 ms | | 16 | part two | 0.54 ms | | 17 | part one | 89.65 ms | | 17 | part two | 62.17 ms | | 18 | part one | 1556.96 ms | | 18 | part two | 1652.36 ms | | 19 | part one | 1.81 ms | | 19 | part two | 0.20 ms | | 20 | part one | 2908.12 ms | | 20 | part two | 808.20 ms | | 21 | part one | 1.96 ms | | 21 | part two | 1.97 ms | | 22 | part one | 137.49 ms | | 22 | part two | 92.94 ms | | 23 | part one | 0.45 ms | | 23 | part two | 0.59 ms | | 24 | part one | 44.01 ms | | 24 | part two | 1.58 ms | | 25 | part one | 1147.08 ms | | 25 | part two | 0.00 ms |

</p> </details>

2020

<details><summary>Benchmarks for 2020</summary> <p>

| day | part | duration | | :---: | :---: | -------: | | 01 | part one | 0.09 ms | | 01 | part two | 60.98 ms | | 02 | part one | 12.48 ms | | 02 | part two | 1.67 ms | | 03 | part one | 0.07 ms | | 03 | part two | 0.32 ms | | 04 | part one | 0.47 ms | | 04 | part two | 0.92 ms | | 05 | part one | 4.97 ms | | 05 | part two | 2.05 ms | | 05 | part one binary version | 0.21 ms | | 06 | part one | 0.69 ms | | 06 | part two | 0.86 ms | | 07 | part one | 36.14 ms | | 07 | part two | 0.75 ms | | 08 | part one | 0.31 ms | | 08 | part two | 16.61 ms | | 09 | part one | 0.44 ms | | 09 | part two | 630.06 ms | | 10 | part one | 0.02 ms | | 10 | part two | 0.04 ms | | 11 | part one | 1984.17 ms | | 11 | part two | 1681.29 ms | | 12 | part one | 0.22 ms | | 12 | part two | 0.20 ms | | 13 | part one | 0.12 ms | | 13 | part two | 0.05 ms | | 14 | part one | 1.04 ms | | 14 | part two | 324.63 ms | | 15 | part one | 0.12 ms | | 15 | part two | 4429.71 ms | | 16 | part one | 0.88 ms | | 16 | part two | 4.57 ms |

</p> </details>

2021

<details><summary>Benchmarks for 2021</summary> <p>

| day | part | duration | | :---: | :---: | -------: | | 01 | part one | 0.15 ms | | 01 | part two | 0.58 ms | | 01 | part two reuse part one | 0.48 ms | | 02 | part one | 0.28 ms | | 02 | part two | 0.28 ms | | 03 | part one | 0.57 ms | | 03 | part two | 1.28 ms | | 04 | part one | 6.66 ms | | 04 | part two | 14.70 ms | | 05 | part one | 25.71 ms | | 05 | part two | 47.82 ms | | 06 | part one | 0.05 ms | | 06 | part two | 0.08 ms | | 06 | part two faster | 0.06 ms | | 07 | part one | 0.18 ms | | 07 | part two | 0.32 ms | | 08 | part one | 0.15 ms | | 08 | part two | 1.34 ms | | 09 | part one | 8.81 ms | | 09 | part two | 8.72 ms | | 09 | part two async | 10.15 ms | | 09 | part two mp | 98.82 ms | | 10 | part one | 0.60 ms | | 10 | part two | 1.27 ms | | 11 | part one | 3.75 ms | | 11 | part two | 8.69 ms | | 12 | part one | 10.94 ms | | 12 | part two | 346.55 ms | | 13 | part one | 0.51 ms | | 13 | part two | 0.80 ms | | 14 | part one | 0.34 ms | | 14 | part two | 1.18 ms | | 15 | part one | 17.03 ms | | 15 | part two | 579.16 ms | | 16 | part one | 0.39 ms | | 16 | part two | 0.36 ms | | 17 | part one | 94.93 ms | | 17 | part two | 869.35 ms | | 17 | part one quick maths | 0.01 ms | | 18 | part one | 87.66 ms | | 18 | part two | 1414.66 ms | | 19 | part one | 280.30 ms | | 19 | part two | 282.99 ms | | 20 | part one | 34.43 ms | | 20 | part two | 1869.81 ms | | 21 | part one | 0.20 ms | | 21 | part two | 122.34 ms | | 22 | part one | 305.43 ms | | 22 | part two | 1282.90 ms | | 25 | part one | 12702.95 ms |

</p> </details>

2022

<details><summary>Benchmarks for 2022</summary> <p>

| day | part | duration | | :---: | :---: | -------: | | 01 | part one | 0.15 ms | | 01 | part two | 0.17 ms | | 02 | part one | 0.86 ms | | 02 | part two | 0.87 ms | | 02 | part one with mapping | 0.10 ms | | 02 | part two with mapping | 0.08 ms | | 03 | part one | 0.39 ms | | 03 | part two | 0.32 ms | | 04 | part one | 0.51 ms | | 04 | part two | 1.73 ms | | 05 | part one | 0.64 ms | | 05 | part two | 0.49 ms | | 06 | part one | 0.31 ms | | 06 | part two | 1.15 ms | | 07 | part one | 6.53 ms | | 07 | part two | 6.40 ms | | 08 | part one | 108.32 ms | | 08 | part two | 11.82 ms | | 09 | part one | 4.74 ms | | 09 | part two | 23.88 ms | | 10 | part one | 0.04 ms | | 10 | part two | 0.07 ms | | 11 | part one | 0.62 ms | | 11 | part two | 288.57 ms | | 13 | part one | 1.11 ms | | 13 | part two | 67.07 ms | | 14 | part one | 11.72 ms | | 14 | part two | 423.37 ms | | 15 | part one | 1856.95 ms | | 15 | part two | 3149.72 ms |

</p> </details>

2023

<