https://github.com/mcrumm/req_aoc

Elixir Req plugin to download Advent of Code input
https://github.com/mcrumm/req_aoc

Last synced: 27 days ago
JSON representation

Elixir Req plugin to download Advent of Code input

• Host: GitHub
• URL: https://github.com/mcrumm/req_aoc
• Owner: mcrumm
• Created: 2022-12-03T07:30:45.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2022-12-07T20:34:43.000Z (almost 2 years ago)
• Last Synced: 2024-05-02T01:20:47.693Z (6 months ago)
• Language: Elixir
• Size: 21.5 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
# ReqAOC

https://user-images.githubusercontent.com/168677/205474609-778654e1-cdf2-4812-b567-bda456717800.mov

[![Run in Livebook](https://livebook.dev/badge/v1/blue.svg)](https://livebook.dev/run?url=https://github.com/mcrumm/req_aoc/blob/main/guides/usage.livemd)

Elixir Req plugin to download [Advent of Code][aoc] input.

[![CI](https://github.com/mcrumm/req_aoc/actions/workflows/ci.yml/badge.svg)](https://github.com/mcrumm/req_aoc/actions/workflows/ci.yml)

## Usage

The easiest way to use Req is with `Mix.install/2` (requires Elixir v1.12+):

```elixir

Mix.install([

  {:req_aoc, github: "mcrumm/req_aoc", ref: "9f1371b"}

])

System.fetch_env!("AOC_SESSION") |> ReqAOC.fetch!({2022, 01})

# ==> "..."

```

If you want to use ReqAOC in a Mix project, you can add the above dependency to your `mix.exs`.

You can also attach ReqAOC to an existing `Req.Request`:

```elixir

req = Req.new() |> ReqAOC.attach()

req |> Req.get!(aoc: {2022, 01, "my-session-id-from-dev-tools"})

# ==> %Req.Response{body: "..."}

```

### Livebook

In [Livebook](https://livebook.dev) you can store your session token as an **app secret** so you

can reuse it across multiple sessions and multiple notebooks. For example, if you create a secret

named `AOC_SESSION`, then you can use the following code snippet to fetch your AoC input:

```elixir

System.fetch_env!("LB_AOC_SESSION") |> ReqAOC.fetch!({2022, 01})

```

## How to get your session cookie

Puzzle inputs differ by user. For this reason, you can't get your data with an unauthenticated request. Here's how to get your session cookie for ReqAOC to use:

* Log in on [Advent of Code][aoc] via any available provider.

* Open your browser's developer console (e.g. right click --> Inspect) and navigate to the Network tab.

* GET any input page, for example https://adventofcode.com/2022/day/1/input, and search in the **request headers**.

* It's a long hex string. You want the part that comes _after_ `Cookie: session=`. Save that to a system environment variable or a Livebook app secret called `AOC_SESSION`.

[![Finding your session token](https://cloud.githubusercontent.com/assets/6615374/20862970/0922a4fe-b980-11e6-8f30-5967ca494f5e.png)](https://github.com/wimglenn/advent-of-code-wim/issues/1)

[aoc]: https://adventofcode.com