KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

advent_of_code

★ 29 Open GitHub ↗

Advent of Codes with Elixir [2015 ~ 2024]

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AdventOfCode

Advent of Code puzzle solutions in Elixir. It's work in progress and starting year 2015 to 2022, random days are attempted.

## Code Organization

All solution modules reside in `lib/<year>/day_<day>.ex` and associated tests have the same structure in `test/` folder. Input files are in `lib/data/inputs/<year>_<day>.txt`.

## Stubs

To make the experience boilerplate-free and give all solutions uniform (more or less) structure, type `mix gen --year <year> --day <day>` or `mix gen <year> <day>` to have the structure and stub generated. Optionally, if you have `AOC_SESSION_KEY` environment variable storing your cookie then it will download the input file and add the title on the moduledocs for you. Type `mix help gen` for more.

To solve the problem for a particular year/day, type in `mix solve --year <year> --day <day>` or `mix solve <year> <day>` and you will see the result of the mentioned `year/day` if it is valid and has been solved. Type `mix help solve` for more.

## Introducing a new year

During December 1 of a new year (if Advent of Code is happening that year), the following steps should be taken (this should be more streamlined in future):

* Create a new folder `XXXX` (in year format) under `/lib` or `/test`
* Update the `@latest_year` attribute on `advent_of_code.ex`
* Double check your session cookie `AOC_SESSION_KEY` (in case you're using it)

All commands should work from then on.

## Testing

run `mix test` to ensure all solutions are working okay. To run test for a particular year and day, type `mix test --only y<last-two-digits-of-year><zero-padded-day>`. For example: `mix test --only y1501` tests for `2015` as year and `1` as day.

## Benchmarking

To benchmark solutions and update the [Benchmarks](BENCHMARKS.md) report, use the provided script:

- `scripts/gen_benchmark.py`: Runs all solved problems across all years.
- `scripts/gen_benchmark.py <year>`: Benchmarks all days for a specific year.
- `scripts/gen_benchmark.py <year> <day>`: Benchmarks a single problem (useful after a new solve).

The script saves results to a persistent JSON file at `priv/data/benchmark.json`, allowing you to update specific results without re-running everything.

## Updating README and Stats

If you want to update the `README.md` (i.e. this file) please do not update `README.me` directly, instead update the static content (not stats related) on `priv/partials/readme_content.md` and then run `mix readme` to regenerate this file.

Note: All files mentioned above are autogenerated and are created by running `python3 scripts/gen_wiki.py`.

> **191 problems solved** across **11 years** — [Tags](wiki/tags/index.md) · [Difficulty](wiki/difficulty.md) · [Benchmarks](BENCHMARKS.md)

### 🏷️ Tags

[grid](wiki/tags/grid.md)&nbsp;`37`  [graph](wiki/tags/graph.md)&nbsp;`35`  [sequence](wiki/tags/sequence.md)&nbsp;`33`  [math](wiki/tags/math.md)&nbsp;`17`  [set](wiki/tags/set.md)&nbsp;`17`  [simulation](wiki/tags/simulation.md)&nbsp;`17`  [geometry](wiki/tags/geometry.md)&nbsp;`15`  [op-code](wiki/tags/op-code.md)&nbsp;`12`  [optimization](wiki/tags/optimization.md)&nbsp;`12`  [parsing](wiki/tags/parsing.md)&nbsp;`12`  [dynamic-programming](wiki/tags/dynamic-programming.md)&nbsp;`10`  [recursion](wiki/tags/recursion.md)&nbsp;`9`  [reduction](wiki/tags/reduction.md)&nbsp;`8`  [walk](wiki/tags/walk.md)&nbsp;`8`  [bitwise](wiki/tags/bitwise.md)&nbsp;`7`  [validation](wiki/tags/validation.md)&nbsp;`6`  [count](wiki/tags/count.md)&nbsp;`5`  [pathfinding](wiki/tags/pathfinding.md)&nbsp;`5`  [ranges](wiki/tags/ranges.md)&nbsp;`5`  [slow](wiki/tags/slow.md)&nbsp;`5`  [dijkstra](wiki/tags/dijkstra.md)&nbsp;`4`  [implicit-graph](wiki/tags/implicit-graph.md)&nbsp;`4`  [map](wiki/tags/map.md)&nbsp;`4`  [matrix](wiki/tags/matrix.md)&nbsp;`4`  [sliding-window](wiki/tags/sliding-window.md)&nbsp;`4`  [annoying](wiki/tags/annoying.md)&nbsp;`3`  [combinatorics](wiki/tags/combinatorics.md)&nbsp;`3`  [connectivity](wiki/tags/connectivity.md)&nbsp;`3`  [hash](wiki/tags/hash.md)&nbsp;`3`  [md5](wiki/tags/md5.md)&nbsp;`3`  [measurement](wiki/tags/measurement.md)&nbsp;`3`  [parallel](wiki/tags/parallel.md)&nbsp;`3`  [random-access](wiki/tags/random-access.md)&nbsp;`3`  [rotation](wiki/tags/rotation.md)&nbsp;`3`  [sort](wiki/tags/sort.md)&nbsp;`3`  [stack](wiki/tags/stack.md)&nbsp;`3`  [traversal](wiki/tags/traversal.md)&nbsp;`3`  [visual-result](wiki/tags/visual-result.md)&nbsp;`3`  [a-star](wiki/tags/a-star.md)&nbsp;`2`  [assembunny](wiki/tags/assembunny.md)&nbsp;`2`  [atomics](wiki/tags/atomics.md)&nbsp;`2`  [bfs](wiki/tags/bfs.md)&nbsp;`2`  [calculation](wiki/tags/calculation.md)&nbsp;`2`  [checksum](wiki/tags/checksum.md)&nbsp;`2`  [cycle-detection](wiki/tags/cycle-detection.md)&nbsp;`2`  [cycles](wiki/tags/cycles.md)&nbsp;`2`  [data-modelling](wiki/tags/data-modelling.md)&nbsp;`2`  [emulation](wiki/tags/emulation.md)&nbsp;`2`  [enumeration](wiki/tags/enumeration.md)&nbsp;`2`  [flood-fill](wiki/tags/flood-fill.md)&nbsp;`2`  [fsm](wiki/tags/fsm.md)&nbsp;`2`  [hexagon](wiki/tags/hexagon.md)&nbsp;`2`  [int-code](wiki/tags/int-code.md)&nbsp;`2`  [interval-merging](wiki/tags/interval-merging.md)&nbsp;`2`  [json](wiki/tags/json.md)&nbsp;`2`  [large-number](wiki/tags/large-number.md)&nbsp;`2`  [pattern-matching](wiki/tags/pattern-matching.md)&nbsp;`2`  [routing](wiki/tags/routing.md)&nbsp;`2`  [state-space](wiki/tags/state-space.md)&nbsp;`2`  [state-space-search](wiki/tags/state-space-search.md)&nbsp;`2`  [string](wiki/tags/string.md)&nbsp;`2`  [string-encoding](wiki/tags/string-encoding.md)&nbsp;`2`  [table-lookup](wiki/tags/table-lookup.md)&nbsp;`2`  [topological-sort](wiki/tags/topological-sort.md)&nbsp;`2`  [union-find](wiki/tags/union-find.md)&nbsp;`2`  [vector](wiki/tags/vector.md)&nbsp;`2`  [ambiguous-solution](wiki/tags/ambiguous-solution.md)&nbsp;`1`  [binary](wiki/tags/binary.md)&nbsp;`1`  [binary-search](wiki/tags/binary-search.md)&nbsp;`1`  [binary-space](wiki/tags/binary-space.md)&nbsp;`1`  [bron-kerbosch](wiki/tags/bron-kerbosch.md)&nbsp;`1`  [clique](wiki/tags/clique.md)&nbsp;`1`  [constellation](wiki/tags/constellation.md)&nbsp;`1`  [dataflow](wiki/tags/dataflow.md)&nbsp;`1`  [date-time](wiki/tags/date-time.md)&nbsp;`1`  [floyd-warshall](wiki/tags/floyd-warshall.md)&nbsp;`1`  [game](wiki/tags/game.md)&nbsp;`1`  [gb-tree](wiki/tags/gb-tree.md)&nbsp;`1`  [generation](wiki/tags/generation.md)&nbsp;`1`  [greedy](wiki/tags/greedy.md)&nbsp;`1`  [inline-input](wiki/tags/inline-input.md)&nbsp;`1`  [lan-party](wiki/tags/lan-party.md)&nbsp;`1`  [logic-circuit](wiki/tags/logic-circuit.md)&nbsp;`1`  [logic-gates](wiki/tags/logic-gates.md)&nbsp;`1`  [longest-path](wiki/tags/longest-path.md)&nbsp;`1`  [maximum-clique](wiki/tags/maximum-clique.md)&nbsp;`1`  [min-cut](wiki/tags/min-cut.md)&nbsp;`1`  [palindrome](wiki/tags/palindrome.md)&nbsp;`1`  [partitioning](wiki/tags/partitioning.md)&nbsp;`1`  [physics](wiki/tags/physics.md)&nbsp;`1`  [quadratic-time](wiki/tags/quadratic-time.md)&nbsp;`1`  [refactor](wiki/tags/refactor.md)&nbsp;`1`  [safe-dial](wiki/tags/safe-dial.md)&nbsp;`1`  [search](wiki/tags/search.md)&nbsp;`1`  [sieve](wiki/tags/sieve.md)&nbsp;`1`  [spiral](wiki/tags/spiral.md)&nbsp;`1`  [strategy](wiki/tags/strategy.md)&nbsp;`1`  [string-manipulation](wiki/tags/string-manipulation.md)&nbsp;`1`  [string-result](wiki/tags/string-result.md)&nbsp;`1`  [tetris](wiki/tags/tetris.md)&nbsp;`1`  [tree](wiki/tags/tree.md)&nbsp;`1`  [tsp](wiki/tags/tsp.md)&nbsp;`1`  [unfold](wiki/tags/unfold.md)&nbsp;`1`  [zipper](wiki/tags/zipper.md)&nbsp;`1`

advent_of_code

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README