aocd.extra attr

[wimglenn]

Make extra context for example data more machine-readable.

When executing solves using example datas, the runner will export AOCD_EXTRA var with any extra example context (JSON serialized k/v).

E.g.:

$ aocd 2024 14 -e
                        --- Day 14: Restroom Redoubt ---                        
                      https://adventofcode.com/2024/day/14                      
------------------------------- Example data 1/1 -------------------------------
p=0,4 v=3,-3
p=6,3 v=-1,-3
p=10,3 v=-1,2
p=2,0 v=2,-1
p=0,0 v=1,3
p=3,0 v=-2,-2
p=7,6 v=-1,-3
p=3,0 v=-1,-2
p=9,3 v=2,3
p=7,3 v=-1,2
p=2,4 v=2,-3
p=9,5 v=-3,-3
--------------------------------------------------------------------------------
answer_a: 12
answer_b: -
extra: {'width': 11, 'height': 7}
--------------------------------------------------------------------------------

Restroom Redout example has a smaller 11x7 sized space, but the full data is in a space which is 101 tiles wide and 103 tiles tall. Solvers running against the example data need a way to access the extra context for sample data, and this in now available in an extra attribute:

from aocd import data
from aocd import extra

w = extra.get("width", 101)
h = extra.get("height", 103)

If you're running against sample datas (aoc -e) then aocd.extra will have this context. If you're running against real input data, aocd.extra will still exist but it is an empty dict {}.

[codecov]

Codecov Report

Attention: Patch coverage is 86.66667% with 2 lines in your changes missing coverage. Please review.

Project coverage is 91.15%. Comparing base (24c09ce) to head (c2d39fb).
Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
aocd/runner.py	66.66%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #153      +/-   ##
==========================================
- Coverage   91.18%   91.15%   -0.04%     
==========================================
  Files          25       25              
  Lines        2758     2771      +13     
  Branches      248      250       +2     
==========================================
+ Hits         2515     2526      +11     
- Misses        177      178       +1     
- Partials       66       67       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.