aoc-cl/README.org

69 lines
1.4 KiB
Org Mode

* 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.