#advent #aoc #puzzle #submit #input #data #within


Advent of Code Data - get puzzle input and submit answers from within your code

16 releases

0.4.0 Dec 2, 2023
0.3.7 Nov 24, 2023
0.3.5 Oct 7, 2023
0.3.4 Jan 19, 2023
0.1.0 Dec 12, 2022

#5 in #submit

45 downloads per month

MIT license

388 lines

Advent of Code Data


Programmatically get your puzzle input and submit answers, in Rust.

Might be useful for lazy Rustaceans and speed hackers.

Yes, this is wimglenn's aocd Python-package, but for Rust. And yes, this too tries to cache everything it gets from Advent of Code to spare their servers.


Spoiler: This example does in fact solve one of the AoC puzzles.

use aocd::*;
// or, if you prefer: use aocd::prelude::*;

#[aocd(2022, 1)]
fn main() {
    let mut elves: Vec<_> = input!()
        .map(|e| e.lines().map(|l| l.parse::<u32>().unwrap()).sum())

    submit!(1, elves.last().unwrap());
    submit!(2, elves.iter().rev().take(3).sum::<u32>());


If you want to use a smaller test input while debugging, this can be done by just adding the file name at the top. In this case, the input! macro simply reads the file, and submit! just prints the result without submitting to AoC.

use aocd::*;

#[aocd(2022, 1, "test.txt")]
fn main() {


You need to provide your AoC session token in order for this crate to get your personal puzzle input and to be able to submit answers for you. This is a cookie which is set when you login to AoC. You can find it with your browser inspector. See this issue for a how-to. You can provide it to aocd using any of the following alternatives:

# Alt 1 (this way doesn't require any environment variables to be set):
mkdir -p ~/.config/aocd
echo "your session cookie here" > ~/.config/aocd/token

# Alt 2:
export AOC_SESSION="or here"

# Alt 3:
export AOC_TOKEN="or here"

# Alt 4:
echo "or here" > some_file
export AOC_TOKEN_PATH=some_file

Next, add the crate to your dependencies:

cargo add aocd

In your code, annotate your main function with #[aocd(year, day)], and then use the macros input!() and submit!(part, answer) to get your puzzle input and submit answers, respectively. See the example above.


~370K SLoC