Solutions to Advent of Code challenges implemented in Python
Advent of Code has been an annual gift to programmers since 2015. It takes place for 25 days every December. A new coding challenge is released every day (like an advent calendar) and consists of two parts. You don't necessarily need to write code to solve the challenge, but most of the time, you'll want to.
This repository contains my collection of Advent of Code solutions implemented in Python. The solutions here are intentionally written in as functional a style as possible without deviating too far from idiomatic python. I've tried to avoid mutable state and unnecessary objects/classes whenever I can.
While this is not a professional project by any means, I've tried over time to improve the readability, performance, and testability of my solutions as a means of "sharpening the saw." I've implemented quite a few modules that solve common patterns of problems that tend to pop up again and again.
This project uses https://pdm-project.org/. Follow its
installation guidelines.
Once installed, cd into aoc-py and issue
pdm install
You can execute any day's implemented solutions, either with my puzzle input files or you can provide your own.
pdm aoc # (or pdm run aoc)
For example, to execute the solution for the 2022 Day 1 puzzle, just execute
pdm aoc 2022 1 -v
The -v is purely optional, but will help print what the values are supposed
to mean in the context of the puzzle narrative.
You can specify your own puzzle input file with the -i command-line option.
Full usage:
usage: aoc.py [-h] [-i INPUT] [-v] year day
positional arguments:
year Puzzle year
day Puzzle day
options:
-h, --help show this help message and exit
-i INPUT, --input INPUT
[Optional] puzzle input
-v, --verbose [Optional] verbose printing
Copyright 2023 Ken Smith
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.