Package: aoc-tiles
AoC TilesThis script creates a graphic for each day for each year of the Advent of Code.
A tile is an image which represents both parts of a day, it looks like this:It uses the personalAoC Leaderboardto get the data for each day using your cookie.InstallationFor this year (2023) I have rewritten this script to make it a lot easier to use.
Now youonlyneed to installpre-commit, add a pre-commit hook and add two HTML comments to your README. More details below.Installpre-commit:pipinstallpre-commitor the more modern way below (either is fine, modern pip in Python 3.11+
willnot allow the above command to run though):# if you don't have pipx, install it with pip install pipx, or with your package managerpipxinstallpre-commitAdd pre-commit hook to your repositoryAdd this pre-commit hook to your.pre-commit-config.yaml(create it, if you don't have it):repos:-repo:https://github.com/LiquidFun/aoc_tilesrev:0.6.0hooks:-id:aoc-tiles# Optionally use these arguments. Auto add tiles to git adds the tiles to git,# possibly amends your commit by creating the tile images and updating the README.# Language sorting shows the preference of the order of the languages to use.# Exclude paterns are globs which can be used to exclude files when creating# the tiles. See the customization section in the README for more flags.# Simply remove the comments (#) below for args and the flags you want.# args:#     - --auto-add-tiles-to-git=amend#     - --language-sorting=jl,kt,py,rs#     - --exclude-patterns=2021/*/*.apl,2021/*/*.py,2021/*/*.cppNowinstallthe hook with:pre-commit install --hook-type post-commitand you are done! The--hook-type post-commitflag is important, otherwise the hook will not run.There are a lot more flags, seeconfig.pyfor all of them.
Auto add tiles is recommended as it will automatically add the tiles to your git repository, otherwise you might
forget it and the tiles will not be updated. Note that this will amend your just created commit. If you do not want
this, remove that flag.Set-upAdd this to your .gitignore:.aoc_tiles/*
!.aoc_tiles/tiles/Now add<!-- AOC TILES BEGIN -->and<!-- AOC TILES END -->in your README, everything between these 2 tags
will always be replaced by the script, so do not add additional information there. Note that these are HTML comments,
so they will not be visible in the rendered README.ConfigurationIf you care about your submit-time and rank, you need to add your session cookie to the script.
By default, if no session cookie is found, checkmarks will be used instead of the time and rank.
Add it either in the root of the repository assession.cookieor in the.aoc_tilesdirectory assession.cookie.
Make sure that this file is in your.gitignore!
It should contain a single line, the "session" cookie fromhttps://adventofcode.comwhen you are logged in.
No prefix is needed, only the string of length 128.CustomizationThere are various flags which can be set to change the look of your tiles. Some of them are listed here
with examples showing how it changes the look.--what-to-show-on-right-side=:auto(default)checkmarktime_and_ranktime_and_rankif cookie is available, elsecheckmark--contrast-improvement-type=:outline(default)darknone