Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mebeim/aoc

🎄 My solutions and walkthroughs for Advent of Code and more related stuff.
https://github.com/mebeim/aoc

advent-of-code algorithm-challenges competitive-programming programming-challenges programming-puzzles python python3

Last synced: 1 day ago
JSON representation

🎄 My solutions and walkthroughs for Advent of Code and more related stuff.

Awesome Lists containing this project

README 

        
Advent of Code

==============



Personal repository of [Advent of Code](#about-advent-of-code) solutions.



### Quick links



- **[How to run my solutions on your inputs][how-to-run]**

- **AoC 2024: [walkthrough][2024-wal], [clean][2024-sol] / [original][2024-ori] solutions**

- AoC 2023: [walkthrough][2023-wal], [clean][2023-sol] / [original][2023-ori] solutions, complete [calendar][2023-cal] and [leaderboard][2023-lea]

- AoC 2022: [walkthrough][2022-wal], [clean][2022-sol] / [original][2022-ori] solutions, complete [calendar][2022-cal] and [leaderboard][2022-lea]

- AoC 2021: [walkthrough][2021-wal], [clean][2021-sol] / [original][2021-ori] solutions, complete [calendar][2021-cal] and [leaderboard][2021-lea]

- AoC 2020: [walkthrough][2020-wal], [clean][2020-sol] / [original][2020-ori] solutions, complete [calendar][2020-cal] and [leaderboard][2020-lea]

- AoC 2019: [walkthrough][2019-wal], [clean][2019-sol] / [original][2019-ori] solutions, complete [calendar][2019-cal] and [leaderboard][2019-lea]

- AoC 2018: [clean][2018-sol] / [original][2018-ori] solutions, complete [calendar][2018-cal] and [leaderboard][2018-lea]



About Advent of Code

--------------------



[Advent of Code][aoc-about] is an Advent calendar of small programming puzzles

for a variety of skill sets and skill levels that can be solved in any

programming language you like. One programming puzzle a day is released from 1st

to 25th December, divided in two parts (the second of which is unlocked after

solving the first). Advent of Code is created by [Eric Wastl][aoc-eric], and is

100% free. If you like Advent Of Code and want to support its creator, you can

donate to him [here][aoc-support]. If you want to hang out with other fellow

coders, discuss about puzzles and solutions, or just have a look around, you can

join the official subreddit: [r/adventofcode][aoc-reddit], or the unofficial IRC

channel: `#adventofcode` on `irc.libera.chat`, where you can also find me at the

right time of the year.



About this repository

---------------------



I discovered Advent of Code in 2017, and played my first edition in 2018. In

this repository you can find my solutions and walkthroughs for the puzzles as

well as other miscellaneus stuff like visualizations and other scripts.



**In each year's directory** you will find:



- `README.md`: an in depth walkthrough of my (clean) solutions for the puzzle,

  day by day, with references to used algorithms and data structures and

  sometimes also comments/reflections.

- `solutions/`: clean solutions for the puzzles. I usually rewrite, polish and

   optimize my original solutions whenever I have time after my first solve,

   along with a detailed walkthrough.

- `original_solutions/`: my *almost unedited* original solutions for the

  puzzles, written as fast as I could while trying to solve puzzles for the

  first time. These solutions may use helpers I defined in my own `utils`

  module, as well as other external modules to make things easier. Do not expect

  the code in here to be sane/readable/fast**[1]**.

- `lib/`: small library of utilities written for this specific year. There are

  recurring concepts and problems each year. If needed, this directory will hold

  common code used by multiple solutions.

- `misc/`: anything else interesting. This includes image/video visualizations

  of puzzles, additional interesting scripts, alternative solutions, and so on.



   - `full_leaderboard.md`: a complete leaderboard of all participants of

     Advent of Code for the year, including those who did not make it to the top

     100, built by scraping each day's leaderboard.

   - `calendar.gif`: a GIF of the animated complete calendar for the year.

     That is, if I managed to finish all puzzles.



**[1]** I chose to upload "original" versions of solutions for two reasons:

they are a good and fun way to see how I code, and they can be uploaded as soon

as the leaderboard for the day is complete, as I often don't have time to

rewrite them more cleanly right away.



How to run my solutions

-----------------------



You can provide your input from standard input:



```bash

2022/solutions/day01.py

# Paste input here and type CTRL+D when done...

```



You can save your input to file and pass its path as argument:



```bash

2022/solutions/day01.py path/to/your/input.txt

```



Or you can directly download your input from the AoC website. You will need to

extract your session cookie from your browser and replace `VALUE` below with the

real value, please *only do this if you understand what you are doing*.



```bash

curl -s --cookie 'session=VALUE' 'https://adventofcode.com/2022/day/1/input' | 2022/solutions/day01.py

```



Contributing

------------



If you have question or spotted a typo/bug/mistake, you are most welcome to

[submit a new issue][new-issue]. For pull reqeusts and other kinds of

contributions, please read [`CONTRIBUTING.md`][contributing].



Licensing

---------



The content of this repository, *with the exception of walkthroughs* (as defined

in and linked at the top of this document), is licensed under the

[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) license, which

you can find in the file [`LICENSE.Apache-2.0`](/LICENSE.Apache-2.0).

Walkthroughs are licensed under the

[Creative Commons BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)

license, which you can find in the file

[`LICENSE.CC-BY-NC-SA-4.0`](/LICENSE.CC-BY-NC-SA-4.0).



---



*Copyright © 2018-2024 Marco Bonelli.*



[2024-wal]: 2024/README.md

[2024-sol]: 2024/solutions

[2024-ori]: 2024/original_solutions



[2023-wal]: 2023/README.md

[2023-sol]: 2023/solutions

[2023-ori]: 2023/original_solutions

[2023-cal]: 2023/misc/calendar.gif

[2023-lea]: 2023/misc/full_leaderboard.md



[2022-wal]: 2022/README.md

[2022-sol]: 2022/solutions

[2022-ori]: 2022/original_solutions

[2022-cal]: 2022/misc/calendar.gif

[2022-lea]: 2022/misc/full_leaderboard.md



[2021-wal]: 2021/README.md

[2021-sol]: 2021/solutions

[2021-ori]: 2021/original_solutions

[2021-cal]: 2021/misc/calendar.gif

[2021-lea]: 2021/misc/full_leaderboard.md



[2020-wal]: 2020/README.md

[2020-sol]: 2020/solutions

[2020-ori]: 2020/original_solutions

[2020-cal]: 2020/misc/calendar.gif

[2020-lea]: 2020/misc/full_leaderboard.md



[2019-wal]: 2019/README.md

[2019-sol]: 2019/solutions

[2019-ori]: 2019/original_solutions

[2019-cal]: 2019/misc/calendar.gif

[2019-lea]: 2019/misc/full_leaderboard.md



[2018-wal]: 2018/README.md

[2018-sol]: 2018/solutions

[2018-ori]: 2018/original_solutions

[2018-cal]: 2018/misc/calendar.gif

[2018-lea]: 2018/misc/full_leaderboard.md



[how-to-run]:   #how-to-run-my-solutions

[contributing]: /CONTRIBUTING.md

[new-issue]:    https://github.com/mebeim/aoc/issues/new



[aoc-about]:   https://adventofcode.com/2019/about

[aoc-eric]:    https://twitter.com/ericwastl

[aoc-support]: https://adventofcode.com/2019/support

[aoc-reddit]:  https://www.reddit.com/r/adventofcode/



[paypal-donate-btn]: https://www.paypal.com/donate/?hosted_button_id=FFGV44B3SLHBL&locale.x=en_IT