Arrive

About

A simple tool to fetch your Advent of Code input and submit your solutions.

Key features and goals:

• keeps your current AOC day selection and solution status in a TOML state file (for human readability)
• caches input files to ease load on AOC servers
• reasonably minimal dependencies

Directories used (see dirs for more info):

Description	Path
Cache	${XDG_CACHE_HOME}/arrive or ${HOME}/.cache/arrive
State	${XDG_STATE_HOME}/arrive or ${HOME}/.local/state/arrive

Installation

Arch Linux:

Arrive is available on the AUR as arv. You can install it with your preferred AUR helper. Example:

paru -S arv

Via Cargo:

cargo install --locked arrive

From source:

git clone https://github.com/tranzystorekk/arrive.git
cargo install --path arrive

Usage

Set a new session token (see Token section):

arv token set <token>

Print currently stored session token:

arv token show

Select currently processed advent day:

arv select -y <year> -d <day>

Show current selection and day completion status:

arv status

Print input for current selection:

arv input

Save input to file:

arv input > path/to/file.txt

Submit advent solution for current selection. If <solution> is omitted, STDIN is read instead.

arv submit [<solution>]

Token

For the web commands (arv input, arv submit) to work, a valid AOC session token needs to be supplied to arv token set.

To obtain such a token, do the following:

1. Login to AOC: https://adventofcode.com/auth/login
2. In your browser, open the developer tools
3. Navigate to Storage -> Cookies
4. Find and copy the entry named session
5. Run arv token set <token>

These tokens have long expiration dates, so you can typically set-and-forget once.

Acknowledgements

Deeply inspired by aocf!