https://github.com/xhyrom/aoc
my advent of code solutions and tooling
https://github.com/xhyrom/aoc
2023 2024 advent adventofcode aoc christmas programming puzzles year
Last synced: about 1 month ago
JSON representation
my advent of code solutions and tooling
- Host: GitHub
- URL: https://github.com/xhyrom/aoc
- Owner: xhyrom
- Created: 2023-12-02T07:40:15.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-11T17:19:09.000Z (4 months ago)
- Last Synced: 2025-02-07T16:51:26.461Z (3 months ago)
- Topics: 2023, 2024, advent, adventofcode, aoc, christmas, programming, puzzles, year
- Language: Python
- Homepage: https://aoc.xhyrom.dev
- Size: 598 KB
- Stars: 9
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Advent of Code
In this repository, you can find all my solutions to the [Advent of Code](http://adventofcode.com/) puzzles mostly written in Python.
### 🌟 What is Advent of Code?
[Advent of Code](http://adventofcode.com/) is an annual coding event featuring 25 programming
puzzles, one for each day from December 1st to December 25th. These puzzles can be solved in
any programming language, offering a fun and engaging way to test your skills and learn new
concepts during the holiday season.
### Usage
To use the tools in this repository, follow these steps:
1. Clone the repository
2. Setup a virtual environment and install dependencies
```bash
python -m venv .env
pip install -r requirements.txt
```
3. Create a `.env` file in the root of the repository with your session token
```bash
echo "AOC_SESSION=" > .env
```
Replace `` with your session token from the [Advent of Code](http://adventofcode.com/) website.
After that, you can use the provided tool to set up the folder and input file for a new day:
```bash
./jolt
```
To run the tests for current day, use:
```bash
./jolt run
```
### Commands
The tool `jolt` provides the following commands:
```bash
Usage: [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
bench Benchmark solution(s) for specified day(s) and year(s).
calendar Prints the calendar for the specified year.
puzzle Create a new puzzle solution template.
run Run solution(s) for specified day and year.
```