41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
# aoctools
|
|
Set of bash scripts for interacting with Advent of Code from the CLI.
|
|
|
|
Aims to be minimal but functional, current set of utilities is only ~100 lines of bash and can do most of what you would need.
|
|
|
|
I may add an answer uploader in the future, but I dont currently see a huge need for it.
|
|
|
|
## directory structure
|
|
Everything aoctools uses lives in the directory specified by `$AOC_DIR`, defaulting to `~/.aoc`.
|
|
|
|
There are 2 things within here you should care about
|
|
- `$AOC_DIR/cache`: A cache of downloaded inputs. The input for a day can be found at `cache/<year>/d<day>.in`
|
|
- `$AOC_DIR/session`: Your session cookie, required to download your personal inputs. Should be able to be found in the devtools of your browser.
|
|
Do not include something like `session=` at the start, just the session key itself, should be a string of random letters and numbers.
|
|
|
|
## dependencies
|
|
Just `bash`, standard GNU/POSIX utilities (only tested on linux with GNU utils, probably works on macOS and busybox too), and `curl`.
|
|
|
|
## `aoc-inputdl`
|
|
This is the main utility you will be using to download inputs.
|
|
|
|
`Usage: aoc-inputdl <year> <day>`
|
|
|
|
Downloaded inputs will be automatically cached.
|
|
|
|
The input data will end up in stdout, letting you view it, redirect to a file, or pipe to your solution.
|
|
|
|
## `aoc-cacheclear`
|
|
Clears your cache.
|
|
|
|
```
|
|
Usage: aoc-cacheclear <year> <day?>
|
|
aoc-cacheclear all
|
|
```
|
|
|
|
If passed `all`, the whole cache will be cleared.
|
|
If only a year is passed, the full cache for that year will be cleared.
|
|
If year and day, the cache for that day will be cleared.
|
|
|
|
It is also easy to just clear it manually using `rm`, as the structure is very predictable. See [directories](#directories).
|