Advent of Code Elixir Starter

Template repository for Elixir solutions to Advent of Code puzzles.

Adapted from another Advent of Code Elixir Starter.

✨ Features ✨

Two Mix tasks: (Run mix help <task_name> after building the project for usage info)
- mix advent.gen - Generate boilerplate solution and test modules for a new year of puzzles.
- mix advent.solve - Run or benchmark a solution.
Automatically downloads puzzle inputs as needed.
Optional benchmarking with Benchee.
Special support for puzzle solutions that reuse the same parsed value for both parts.

Usage

Start by creating your own repository from this template, using the big green button up there ↗️.

Once that's done, let's get your project running.

Enable the automatic puzzle input downloader by creating a config/secrets.exs file containing the following:

import Config

config :advent_of_code, AdventOfCode.Input,
  allow_network?: true,
  session_cookie: "..." # paste your AoC session cookie value here

Fetch dependencies with

mix deps.get

Generate a set of solution and test files for a new year of puzzles with

mix advent.gen -y${YEAR}

Now you can run the solutions with

mix advent.solve -d${DAY} [-p${1 | 2}] [-y${YEAR}] [--bench]

and tests with

mix test

either directly in your local terminal, or in VSCode's terminal pane while connected to a dev container as described below.

Get started in a self-contained environment

Screenshot of the project running in GitHub Codespaces

Your project generated from this template repository can optionally run in a dev container for remote development.
You have two options:

Run in your browser using GitHub Codespaces

Go to the landing page of this repo.
Click the <> Code drop-down menu, select the Codespaces tab, and click the big green button.
Wait for the Codespace to build. It should be relatively speedy if you build from the main branch, as I have prebuilds configured for that.
Once the in-browser editor activates, follow the steps from Usage to enable puzzle downloads and run a solution. (You can use Ctrl+Shift+` to open a terminal pane.)

🐳 Using Visual Studio Code + Docker Desktop

Requires Docker Desktop or an alternative Docker-compliant CLI, like podman.