Advent of Code Compendium

What am I doing and why am I doing it?

I am challenging myself to improve my problem-solving abilities and creativity. In this compendium, I will share my codes and notes for every day. This project is public to help not only myself but also others. See the The Unlicense License for more details.

This project means a lot to me, especially because it helps others when they're stuck in AoC. You can follow me along with the project if you want.

Structure

In this section, I will explain the structure of the repo and how to make a proper pull request. Each year has its own folder (e.g., 2015), and each day contains a Python file and a markdown file with thoughts or notes.

Example Structure

advent-of-code
├── 2015/
│   ├── day01/
│   │   ├── solution.py
│   │   └── notes.md
│   ├── day01-pull_request01/
│   │   ├── solution.py
│   │   └── notes.md
│   ├── day01-pull_request02/
│   │   ├── solution.py
│   │   └── notes.md
│   └── ...
├── LICENSE
└── README.md

How to Submit a Pull Request

As I mentioned it the structure section each year has its own folder and iside each folder there are another folder called day01 or day02 or day03 or day... This folders called main code and they are submitted by repo owner (in this case it is me. And there are other folders called day01-pull_request01 or day01-pull_request02 ... If you want to submit a PR, you should use the following structure: day01-pull_request01.

Also look at this PR template and Contributing rules

Personal Goals

I have some goals that I want to follow during the challenge. Here is the list:

• I want to finish all years (2015-2024 in this case) within 2 years (Until I graduate the highschool).
• I want to take notes on what I learned today, and at the end of the challenge, I will review them. I will look at them.
• I want to solve at least 1 problem every day.

Setup & Running

In this section I will tell what tools, versions, modules I am using.

I will be using Python 3.13 along the project. And I will not use and Modules or Libraries in any code, pure Python.

How to Use Them

It is very basic just download Python and run this command if you are on Windows: python solution.py or if you are on Linux use this: python3 solution.py I have no idea about Mac.

Progress

Year	Days Completed	Notes	Status
2015		✅	In Progress
2016		❌	Not Started
2017		❌	Not Started
2018		❌	Not Started
2019		❌	Not Started
2020		❌	Not Started
2021		❌	Not Started
2022		❌	Not Started
2023		❌	Not Started
2024		❌	Not Started

✅: Notes available | ❌: Not yet written