README.md

Tchou's advent of Code repository

General usage

Invoke the code with:

$ dune exec -- bin/main.exe [prefix] <sol> [1|2] [variant] < input.txt

where: - prefix is an optional prefix of the form aocXXXX. If absent, it defaults to the current year, e.g. aoc2024 - sol is the mandatory name of the solution, usually of the form s17 (for problem 17) - 1|2 is either 1 for part 1 and 2 for part 2. If absent, it defaults to 1. - variant is the name of a variant for some problems, e.g. debug which runs the solution in debug mode or animate which runs an animation in ascii art.

The program expects the problem input from stdin.

To list all prefix/solutions/variants, simply run:

$ dune exec -- bin/main.exe list

Code structure

The repository is organized as follows:

• aoc_private : a private submodule that contains my personal problem inputs as well as the full text of problems

• bin the directory containing the main executable

• lib the directory containing utility libraries. Besides helpers to register solutions, it contains various utility functions to easily parse input, perform common tasks, extend the OCaml standard library in a few places, provide convenient syntax extensions, and implement once and for all a few common math and graph algorithms.

• solutions contains the solutions to the problems