Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mjpieters/adventofcode

Advent of Code solutions 2015-2023
https://github.com/mjpieters/adventofcode

advent-of-code advent-of-code-2015 advent-of-code-2016 advent-of-code-2017 advent-of-code-2018 advent-of-code-2019 advent-of-code-2020 advent-of-code-2021 advent-of-code-2022 advent-of-code-2023 aoc aoc2015 aoc2016 aoc2017 aoc2018 aoc2019 aoc2020 aoc2021 aoc2022 aoc2023

Last synced: 20 days ago
JSON representation

Advent of Code solutions 2015-2023

Awesome Lists containing this project

README 

        
# Advent of code solutions



**Author**: [Martijn Pieters](https://www.zopatista.com)  

**Twitter**: [@zopatista](https://twitter.com/zopatista)  

**GitHub**: [mjpieters](https://github.com/mjpieters)  



These are my [Advent of Code][AoC] (AoC) puzzle solutions.



Most recent solutions use [Python 3.12][pydotorg], and are presented in [Jupyter notebooks][jupyter] for easy [viewing on GitHub][github] or the [online Jupyter notebook viewer][nbviewer]. The latter is the better viewer, especially as Github's notebook rendered often breaks or at the very least filters out a lot of the interesting bits like animations.



I don't aim to be first on any leaderboard. I aim to have fun solving the coding puzzles and playing with the concepts, and I try to include explanations of my thinking in the notebooks. Sometimes that means I'll include an animation or graph to show off some aspect of the puzzle.



## Running locally



Everything here is run through Jupyter notebooks. If you check out this repository locally everything is included to recreate my environment.



I use [Pipenv][pipenv] to manage dependencies, make sure you [have it installed][pipenv_install] before continuing. Once installed, run



```sh

$ pipenv install

$ ./start

```



and the jupyter notebook interface is automatically opened in your default browser. You can stop the server with the *Quit* button in the web interface, or with the `./stop` script.



Everything is organised in per-year folders. I tend to update all the libraries and Python release each year, but I don't test if these updates caused issues with solutions for preceding years. If something broke, so be it.



## Additional dependencies



* Animations are produced using [matplotlib's animation API][mplanimation], which requires [ffmpeg][ffmpeg] to be installed. On Mac OS X just use `brew install ffmpeg`.



* Graphs are plotted using [graphviz](http://www.graphviz.org/) command-line tools such as `dot`, `neato`, and `tred`. On Mac OS X, just use `brew install graphviz`.



## Puzzle input data



I use Wim Glenn's [`advent-of-code-data` package][aocdata] to load data directly from the AoC website. This library requires your AoC session cookie. You'll have create your own [Advent of Code][AoC] account, then use your browser development tools to retrieve the session cookie value. Store the value according to the `advent-of-code-data` instructions (either in `~/.config/aocd/token` or in the `AOC_SESSION` environment variable).



Since this project uses poetry, I use [poetry-dotenv-plugin][] and I store the session cookie in a `.env` file in the root directory of this project:



```sh

AOC_SESSION=deadbeafdeadbeafdeadbeafdeadbeafdeadbeafdeadbeafdeadbeafdeadbeaf

```



Do make sure to restart the jupyter notebook server after updating this file.



## 2015 and 2016 solutions



The 2015 and 2016 solutions are not IPython notebooks; they pre-date this repository, but were added later, and have not been updated or tested to work still. These don't use the `advent-of-code-data` library either so you need to download inputs manually for these.



They are included purely for completion's sake.



## Rust solutions



I'm trying out implementing solutions in Rust as well. I can't promise I'm going to keep this up or that I'll implement Rust versions of all solutions.



I'm using the [cargo-aoc project](https://lib.rs/crates/cargo-aoc) as the runner; you'll need to run `cargo install cargo-aoc` to install it. Then, set your AoC credentials (`cargo aoc credentials -p ...`), move your working directory to a specific year (`cd rust/`, fetch inputs `cargo aoc input -y  -d ` and you can run the solution for that day with `cargo aoc -d `.



Like with my Python solutions, I did not include my own puzzle inputs in the repository.



## License



See the [LICENSE file](LICENSE) in the same directory.



---



[jupyter]: http://jupyter.org/

[AoC]: https://adventofcode.com/

[pydotorg]: https://python.org

[github]: https://github.com/mjpieters/adventofcode/tree/master/

[nbviewer]: https://nbviewer.jupyter.org/github/mjpieters/adventofcode/tree/master/

[pipenv]: https://pipenv.readthedocs.io/

[pipenv_install]: https://pipenv.readthedocs.io/en/latest/install/#installing-pipenv

[mplanimation]: https://matplotlib.org/api/animation_api.html

[ffmpeg]: https://www.ffmpeg.org/

[aocdata]: https://pypi.org/project/advent-of-code-data/

[poetry-dotenv-plugin]: https://github.com/mpeteuil/poetry-dotenv-plugin