Fetch the input and each example input of the AOC challenge for a given day / year.

This mix task fetches the input and each example input for the advent of code challenge of a specific day. The day and year of the challenge can be passed as command-line arguments or be set in the advent_of_code_utils application configuration. When neither is present, the current date is used.

By default, this task stores the fetched input data in input/<year>_<day>.txt. The fetched examples are stored in input/<year>_<day>_example_<n>.txt where n is a progressive number, starting from 0, that distinguish each example. If a file already exists, the matching input is not fetched. The destination paths can be modified by setting the value of :input_path or :example_path in the advent_of_code_utils application configuration. These values should be set to a string which may contain :year and :day (and :n for :example_path). These values will be replaced by the day and year of which the input is fetched (and the progressive number for :example_path).

For instance, the following configuration will store the fetched input data in my_input/<year>/<day>.input:

config :advent_of_code_utils, :input_path, "my_input/:year/:day.input"

Session cookie

In order to fetch your input (and the examples for part 2), this task needs your advent of code session cookie. This can be obtained by investigating your cookies after logging in on the advent of code website. The cookie can be stored inside your config/config.exs file (e.g. config, :advent_of_code_utils, :session, "<your cookie here>") or it can be passed as a command-line argument. If no cookie is present, the input cannot be fetched. Examples in part 1 can still be fetched.

Example input

The example inputs of a given day are fetched by parsing the challenge webpage of the day and storing each code block found on that page. The first code block is generally the example input of that day, but sometimes, many code blocks, which may or may not contain useful examples, are present.

If you do not wish to fetch example input, you can pass the --no-example flag to this task, or you can set fetch_example? to false in the advent_of_code_utils application configuration.

If your session cookie is set, running mix aoc.get after successfully completing part 1 will fetch and store any additional code blocks on the challenge webpage.

Configuration

Application environment

The following application configuration parameters can modify the behaviour of this task:

• session: Advent of code sessions cookie.
• day: Specify the day. Defaults to the current day.
• year: Specify the year. Defaults to the current year.
• time_zone: Specify the time-zone used to determine the local time. Defaults to the time zone of your computer. Please refer to the README for additional information.
• input_path: Determines where the input file is stored. Defaults to "input/:year_:day.txt"
• example_path: Determines where the example input is stored. Defaults to "input/:year_:day_example_:n.txt"

Command-line arguments

The options below take precedence over values defined in the application configuration.

• -s or --session: Specify the session cookie.
• -d or --day: Specify the day.
• -y or --year: Specify the year.
• --no-example: Do not fetch example input
• --example: Fetch example input