Module `advent_of_code_hhoppe`

Python library to process Advent-of-Code puzzles in a Jupyter notebook. See a complete example.

Usage summary:

The preamble optionally specifies reference inputs and answers for the puzzles:

  BASE_URL = 'https://github.com/hhoppe/advent_of_code_2021/blob/main/data/google.Hugues_Hoppe.965276/'
  INPUT_URL = BASE_URL + '2021_{day:02}_input.txt'
  ANSWER_URL = BASE_URL + '2021_{day:02}{part_letter}_answer.txt'
  advent = advent_of_code_hhoppe.Advent(
      year=2021, input_url=INPUT_URL, answer_url=ANSWER_URL)

For each day (numbered 1..25), the first notebook cell defines a puzzle object:
```
  puzzle = advent.puzzle(day=1)
```
The puzzle input string is automatically read into the attribute puzzle.input. This input string is unique to each Advent participant.

For each of the two puzzle parts, a function (e.g. process1) takes an input string and returns a string or integer answer. Using calls like the following, we time the execution of each function and verify the answers:
```
  puzzle.verify(part=1, func=process1)
  puzzle.verify(part=2, func=process2)
```
At the end of the notebook, a table summarizes timing results.

Alternative ways to specify puzzle inputs/answers

The puzzle inputs and answers can be more efficiently downloaded using a single ZIP file:

  PROFILE = 'google.Hugues_Hoppe.965276'
  ZIP_URL = f'https://github.com/hhoppe/advent_of_code_2021/raw/main/data/{PROFILE}.zip'
  !if [[ ! -d {PROFILE} ]]; then wget -q {ZIP_URL} && unzip -q {PROFILE}; fi
  INPUT_URL = f'{PROFILE}/{{year}}_{{day:02d}}_input.txt'
  ANSWER_URL = f'{PROFILE}/{{year}}_{{day:02d}}{{part_letter}}_answer.txt'
  advent = advent_of_code_hhoppe.Advent(
      year=2021, input_url=INPUT_URL, answer_url=ANSWER_URL)

The puzzle inputs and answers can be obtained directly from adventofcode.com using a web-browser session cookie and the advent-of-code-data PyPI package:

  !pip install -q advent-of-code-data
  import aocd
  # Fill-in the session cookie in the following:
  mkdir -p ~/.config/aocd && echo 53616... >~/.config/aocd/token
  advent = advent_of_code_hhoppe.Advent(year=2021)

Metadata

Release files for advent-of-code-hhoppe 1.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for advent-of-code-hhoppe 1.1.6
File	Size	Uploaded
advent_of_code_hhoppe-1.1.6.tar.gz	6.8 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for advent-of-code-hhoppe 1.1.6
File	Interpreter	ABI	Platform	Reset
advent_of_code_hhoppe-1.1.6-py3-none-any.whl 6.6 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 13.4 kB

Release files / advent_of_code_hhoppe-1.1.6.tar.gz

Download URL	advent_of_code_hhoppe-1.1.6.tar.gz
Size	6.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`843784cffd75054872ff1c688e950335db2e6ccb64b1c563e29e3f123ad0c326`
BLAKE2b-256 checksum How to use checksums	`0e8beb24089f8a06aa2407715ae65e337f6db57b3de8dbe659d4dee72dfd6a9f`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/hhoppe/advent-of-code-hhoppe
Publishing commit: github.com/hhoppe/advent-of-code-hhoppe/tree/29f7678b83c17b7cd0ad46dcb3fc60babb6a91fc

Workflow

Publishing configuration: github.com/hhoppe/advent-of-code-hhoppe/blob/29f7678b83c17b7cd0ad46dcb3fc60babb6a91fc/.github/workflows/main.yml
Publishing logs: github.com/hhoppe/advent-of-code-hhoppe/actions/runs/36675277431/attempts/1

Artifact

Subject: advent_of_code_hhoppe-1.1.6.tar.gz
SHA-256 checksum: 843784cffd75054872ff1c688e950335db2e6ccb64b1c563e29e3f123ad0c326 Verifying attestations

Release files / advent_of_code_hhoppe-1.1.6-py3-none-any.whl

Download URL	advent_of_code_hhoppe-1.1.6-py3-none-any.whl
Size	6.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c790f10d3284798b6a3d416bacee6db5a7f3d24b31f134d26788b08f1e3c72dd`
BLAKE2b-256 checksum How to use checksums	`e5512971f0a6060a58e101938551504561b3fcd81d3a4dcf88e112ee1c39b424`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/hhoppe/advent-of-code-hhoppe
Publishing commit: github.com/hhoppe/advent-of-code-hhoppe/tree/29f7678b83c17b7cd0ad46dcb3fc60babb6a91fc

Workflow

Publishing configuration: github.com/hhoppe/advent-of-code-hhoppe/blob/29f7678b83c17b7cd0ad46dcb3fc60babb6a91fc/.github/workflows/main.yml
Publishing logs: github.com/hhoppe/advent-of-code-hhoppe/actions/runs/36675277431/attempts/1

Artifact

Subject: advent_of_code_hhoppe-1.1.6-py3-none-any.whl
SHA-256 checksum: c790f10d3284798b6a3d416bacee6db5a7f3d24b31f134d26788b08f1e3c72dd Verifying attestations