Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tranzystorekk/arrive
A simple CLI tool for interacting with Advent of Code
https://github.com/tranzystorekk/arrive
advent-of-code cli rust
Last synced: 21 days ago
JSON representation
A simple CLI tool for interacting with Advent of Code
- Host: GitHub
- URL: https://github.com/tranzystorekk/arrive
- Owner: tranzystorekk
- License: mit
- Created: 2022-12-01T17:23:35.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-03-11T20:56:01.000Z (8 months ago)
- Last Synced: 2024-03-11T21:52:09.385Z (8 months ago)
- Topics: advent-of-code, cli, rust
- Language: Rust
- Homepage:
- Size: 51.8 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Arrive
[](https://github.com/tranzystorekk/arrive/releases/latest)
[](https://crates.io/crates/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](https://docs.rs/dirs/latest/dirs/index.html) for more info):
|Description|Path |
|-----------|-----------------------------------------------------------|
|Cache |`${XDG_CACHE_HOME}/arrive` or `${HOME}/.cache/arrive` |
|State |`${XDG_STATE_HOME}/arrive` or `${HOME}/.local/state/arrive`|
## Install
Via Cargo:
```console
cargo install --locked arrive
```
From source:
```console
git clone https://github.com/tranzystorekk/arrive.git
cargo install --path arrive
```
## Usage
Set a new session token (see [Token](#token) section):
```console
arv token set
```
Print currently stored session token:
```console
arv token show
```
Select currently processed advent day:
```console
arv select -y -d
```
Show current selection and day completion status:
```console
arv status
```
Print input for current selection:
```console
arv input
```
Save input to file:
```console
arv input > path/to/file.txt
```
Submit advent solution for current selection.
If `` is omitted, STDIN is read instead.
```console
arv submit []
```
## 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:
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 `
These tokens have long expiration dates,
so you can typically set-and-forget once.
## Acknowledgements
Deeply inspired by [aocf](https://github.com/nuxeh/aocf)!