* Aoc  - Advent of Code challenges and solutions.

** Usage

** Installation

The app relies on ~AOC_SESSION~ environment variable with the session
value from the cookie when logged in to the Advent of Code site. I
recommend using a ~.envrc~ file and the *pass* password manager to
store the secret : 

#+BEGIN_SRC shell
export AOC_SESSION=$(pass snamellit/advent-of-code)
#+END_SRC


** Author

+ Peter Tillemans (pti@snamellit.com)

** Implementation Notes:


*** Notable Utilities

**** ~aoc:test-input <year> <day>~

Fetches the test input for the given day in the given year. 

*** Used dependencies


**** Dexador

A comprehensive HTTP client library. 

[[https://github.com/fukamachi/dexador][GitHub repository with documentation]]

The library leverages the *cl-cookie* library for cookie management.


**** 3d-vector

see [[https://shinmera.github.io/3d-vectors/][github pages for 3d-vectors libraray]].

offer 2, 3 and 4  component vectors

- constructor : vec , e.g. (vec 1 2 3) --> vec3
- operators : v+, v-, v*, v/
- operators applied on first vector : nv+, nv-, nv*, nv/
- manhattan : v1norm
- euclides: v2norm

**** Parser Combinators

Smug looks like an https://github.com/drewc/smug awesome parser
combinator library.

Documentation is in org-mode which is another plus.


** Copyright

Copyright (c) 2024 Peter Tillemans (pti@snamellit.com)

** License

Licensed under the MIT License.