Advent of Code CLI

A commandline interface to interact with the Advent of Code.

Usage:

• Install it by downloading the latest release or building from scratch.

Commands / Features:

aoc-cli init [-l/--lang language] [-d/--day day] [-y/--year year] [--debug] [--no-emojis] [-c/--cookie cookie] [--task2]

Initializes a folder for the day, copies the template files of the given language and downloads your puzzle input. By default, uses the current day. If --task2 is given, also tries to download the second challenge description.

aoc-cli solve [task] [-l/--lang language] [-d/--day day] [-y/--year year] [--debug] [--no-emojis] [-c/--cookie cookie] [--submit]

Runs the code for the supplied day with the puzzle input. Also measures execution time. By default, uses the current day and task 1. If --submit is given, also tries to submit your solution, which is the last line of the output of your script, as the solution to the website.

aoc-cli test [task] [-l/--lang language] [-d/--day day] [-y/--year year] [--debug] [--no-emojis]

Runs the code for the supplied day with testing input. Also measures execution time. By default, uses the current day and task 1.

aoc-cli config list|[key] [value] [-l/--lang language]

Updates the config file. If list is given, lists all possible configuration values, including language specific configuration. See below for configuration file reference.

Configuration

Persistent configuration is saved inside the aoc-cli-config.json file, and can be edited via a text editor, or the aoc-cli config command.

Configuration keys

Key	Equivalent cli flag	Description
language	-l/--language	Sets the default language.
noEmojis	--no-emojis	When set, disables emojis in the output.
cookie	-c/-cookie	Sets the cookie for authenticating with the website.

Language specific configuration:

Python

Key	Default	Description
languages.python.executable	python	Python executable to run.

Supported Languages:

• Python
• TypeScript
• Java
• Haskell

Contributing

Adding new Languages

• All languages are a go file in the runner/languages/ directory.
• All language template files are embedded in the executable and inside the runner/languages/[LANGUAGE] directory.
• Add a new file with the language name, create a class in it, and implement the Language interface.
• Register the language in the runner/languages.go file.
• (Take a look at other, existing languages for inspiration and reference)