From 2cf2419673dfc9b7bd85b3aebbcdc60ec8c662a9 Mon Sep 17 00:00:00 2001 From: Xavier Morel Date: Tue, 12 Nov 2024 16:02:09 +0100 Subject: [PATCH] Initial commit --- .assets/banner.png | Bin 0 -> 62797 bytes .assets/christmas_ferris.png | Bin 0 -> 72131 bytes .cargo/config.toml | 12 + .devcontainer/devcontainer.json | 6 + .editorconfig | 17 + .github/workflows/ci.yml | 33 ++ .github/workflows/readme-stars.yml | 24 ++ .gitignore | 30 ++ .vscode/extensions.json | 7 + .vscode/launch.json | 58 +++ Cargo.lock | 588 +++++++++++++++++++++++++++++ Cargo.toml | 30 ++ LICENSE | 21 ++ README.md | 304 +++++++++++++++ data/examples/.keep | 0 data/inputs/.keep | 0 data/puzzles/.keep | 0 src/bin/.keep | 0 src/lib.rs | 3 + src/main.rs | 140 +++++++ src/template.txt | 26 ++ src/template/aoc_cli.rs | 125 ++++++ src/template/commands/all.rs | 5 + src/template/commands/download.rs | 14 + src/template/commands/mod.rs | 6 + src/template/commands/read.rs | 15 + src/template/commands/scaffold.rs | 79 ++++ src/template/commands/solve.rs | 34 ++ src/template/commands/time.rs | 40 ++ src/template/day.rs | 192 ++++++++++ src/template/mod.rs | 68 ++++ src/template/readme_benchmarks.rs | 183 +++++++++ src/template/run_multi.rs | 257 +++++++++++++ src/template/runner.rs | 169 +++++++++ src/template/timings.rs | 391 +++++++++++++++++++ 35 files changed, 2877 insertions(+) create mode 100644 .assets/banner.png create mode 100644 .assets/christmas_ferris.png create mode 100644 .cargo/config.toml create mode 100644 .devcontainer/devcontainer.json create mode 100644 .editorconfig create mode 100644 .github/workflows/ci.yml create mode 100644 .github/workflows/readme-stars.yml create mode 100644 .gitignore create mode 100644 .vscode/extensions.json create mode 100644 .vscode/launch.json create mode 100644 Cargo.lock create mode 100644 Cargo.toml create mode 100644 LICENSE create mode 100644 README.md create mode 100644 data/examples/.keep create mode 100644 data/inputs/.keep create mode 100644 data/puzzles/.keep create mode 100644 src/bin/.keep create mode 100644 src/lib.rs create mode 100644 src/main.rs create mode 100644 src/template.txt create mode 100644 src/template/aoc_cli.rs create mode 100644 src/template/commands/all.rs create mode 100644 src/template/commands/download.rs create mode 100644 src/template/commands/mod.rs create mode 100644 src/template/commands/read.rs create mode 100644 src/template/commands/scaffold.rs create mode 100644 src/template/commands/solve.rs create mode 100644 src/template/commands/time.rs create mode 100644 src/template/day.rs create mode 100644 src/template/mod.rs create mode 100644 src/template/readme_benchmarks.rs create mode 100644 src/template/run_multi.rs create mode 100644 src/template/runner.rs create mode 100644 src/template/timings.rs diff --git a/.assets/banner.png b/.assets/banner.png new file mode 100644 index 0000000000000000000000000000000000000000..36ca006022196bb1e3d5a3e9f0c29a2c317005be GIT binary patch literal 62797 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

!DHjg&`4PUhFy}q}; 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�b$488^5`y>zhKbOaizaq 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 literal 0 HcmV?d00001 diff --git a/.assets/christmas_ferris.png b/.assets/christmas_ferris.png new file mode 100644 index 0000000000000000000000000000000000000000..365527a5f144543679f8cbf58511cfd206bd1746 GIT binary patch literal 72131 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 UiqEMtFfcH9y85}Sb4q9e09XWC&;S4c literal 0 HcmV?d00001 diff --git a/.cargo/config.toml b/.cargo/config.toml new file mode 100644 index 0000000..66b873e --- /dev/null +++ b/.cargo/config.toml @@ -0,0 +1,12 @@ +[alias] +today = "run --quiet --release --features today -- today" +scaffold = "run --quiet --release -- scaffold" +download = "run --quiet --release -- download" +read = "run --quiet --release -- read" + +solve = "run --quiet --release -- solve" +all = "run --quiet --release -- all" +time = "run --quiet --release -- time" + +[env] +AOC_YEAR = "2023" diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 0000000..6043626 --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,6 @@ +{ + "name": "rust-devcontainer", + "image": "mcr.microsoft.com/devcontainers/rust:latest", + "postCreateCommand": "rustc --version", + "remoteUser": "vscode" +} diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..560e94b --- /dev/null +++ b/.editorconfig @@ -0,0 +1,17 @@ +# EditorConfig is awesome: http://EditorConfig.org +root = true + +[*] +indent_size = 4 +indent_style = space +end_of_line = lf +charset = utf-8 +insert_final_newline = true +trim_trailing_whitespace = true + +[*.txt] +insert_final_newline = false +trim_trailing_whitespace = false + +[*.md] +trim_trailing_whitespace = false diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..b67acb7 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,33 @@ +name: Continuous Integration + +on: push + +env: + CARGO_TERM_COLOR: always + +jobs: + ci: + runs-on: ubuntu-latest + name: Continuous Integration + steps: + - uses: actions/checkout@v4 + - name: Set up cargo cache + uses: actions/cache@v4 + continue-on-error: false + with: + path: | + ~/.cargo/bin/ + ~/.cargo/registry/index/ + ~/.cargo/registry/cache/ + ~/.cargo/git/db/ + target/ + key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }} + restore-keys: ${{ runner.os }}-cargo- + - name: cargo test + run: cargo test + # uncomment to enable clippy linter + # - name: cargo clippy + # run: cargo clippy -- -D warnings + # uncomment to enable format linter + # - name: cargo fmt + # run: cargo fmt --check diff --git a/.github/workflows/readme-stars.yml b/.github/workflows/readme-stars.yml new file mode 100644 index 0000000..3de260e --- /dev/null +++ b/.github/workflows/readme-stars.yml @@ -0,0 +1,24 @@ +name: Update readme โญ๏ธ progress + +on: + # !Please set a different minute than 51 if you enable this! + # schedule: + # - cron: "51 */6 * * *" # Every 6 hours + workflow_dispatch: + +jobs: + update-readme: + runs-on: ubuntu-latest + if: ${{ vars.AOC_ENABLED == 'true' }} + permissions: + contents: write + steps: + - uses: actions/checkout@v4 + - uses: k2bd/advent-readme-stars@v1 + with: + userId: ${{ secrets.AOC_USER_ID }} + sessionCookie: ${{ secrets.AOC_SESSION }} + year: ${{ secrets.AOC_YEAR }} + - uses: stefanzweifel/git-auto-commit-action@v5 + with: + commit_message: "update readme progress" diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..216820d --- /dev/null +++ b/.gitignore @@ -0,0 +1,30 @@ +# Generated by Cargo +# will have compiled files and executables +debug/ +target/ + +# These are backup files generated by rustfmt +**/*.rs.bk + +# MSVC Windows builds of rustc generate these, which store debugging information +*.pdb + + +# Added by cargo + +/target + +# Advent of Code +# @see https://old.reddit.com/r/adventofcode/comments/k99rod/sharing_input_data_were_we_requested_not_to/gf2ukkf/?context=3 + +data/inputs/* +!data/inputs/.keep +data/puzzles/* +!data/puzzles/.keep + +# Dhat +dhat-heap.json + +# Benchmarks + +data/timings.json diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..996c817 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,7 @@ +{ + "recommendations": [ + "vadimcn.vscode-lldb", + "rust-lang.rust-analyzer", + "editorConfig.editorConfig" + ] +} diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..8f244cf --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,58 @@ +{ + // Use IntelliSense to learn about possible attributes. + // Hover to view descriptions of existing attributes. + // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 + "version": "0.2.0", + "configurations": [ + { + "type": "lldb", + "request": "launch", + "name": "Debug unit tests for a solution", + "cargo": { + "args": [ + "test", + "--no-run", + // replace `01` here with the solution you like to debug. + "--bin=01", + "--package=advent_of_code" + ], + }, + "args": [], + "cwd": "${workspaceFolder}" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug a solution", + "cargo": { + "args": [ + "build", + // replace `01` here with the solution you like to debug. + "--bin=01", + "--package=advent_of_code" + ], + }, + "cwd": "${workspaceFolder}" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug unit tests in library 'advent_of_code'", + "cargo": { + "args": [ + "test", + "--no-run", + "--lib", + "--features=test_lib", + "--package=advent_of_code" + ], + "filter": { + "name": "advent_of_code", + "kind": "lib" + } + }, + "args": [], + "cwd": "${workspaceFolder}" + } + ] +} diff --git a/Cargo.lock b/Cargo.lock new file mode 100644 index 0000000..9504be6 --- /dev/null +++ b/Cargo.lock @@ -0,0 +1,588 @@ +# This file is automatically @generated by Cargo. +# It is not intended for manual editing. +version = 3 + +[[package]] +name = "addr2line" +version = "0.21.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8a30b2e23b9e17a9f90641c7ab1549cd9b44f296d3ccbf309d2863cfe398a0cb" +dependencies = [ + "gimli", +] + +[[package]] +name = "adler" +version = "1.0.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe" + +[[package]] +name = "advent_of_code" +version = "0.11.0" +dependencies = [ + "chrono", + "dhat", + "pico-args", + "tinyjson", +] + +[[package]] +name = "android-tzdata" +version = "0.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e999941b234f3131b00bc13c22d06e8c5ff726d1b6318ac7eb276997bbb4fef0" + +[[package]] +name = "android_system_properties" +version = "0.1.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311" +dependencies = [ + "libc", +] + +[[package]] +name = "autocfg" +version = "1.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa" + +[[package]] +name = "backtrace" +version = "0.3.69" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2089b7e3f35b9dd2d0ed921ead4f6d318c27680d4a5bd167b3ee120edb105837" +dependencies = [ + "addr2line", + "cc", + "cfg-if", + "libc", + "miniz_oxide", + "object", + "rustc-demangle", +] + +[[package]] +name = "bitflags" +version = "1.3.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a" + +[[package]] +name = "bumpalo" +version = "3.14.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7f30e7476521f6f8af1a1c4c0b8cc94f0bee37d91763d0ca2665f299b6cd8aec" + +[[package]] +name = "cc" +version = "1.0.83" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f1174fb0b6ec23863f8b971027804a42614e347eafb0a95bf0b12cdae21fc4d0" +dependencies = [ + "libc", +] + +[[package]] +name = "cfg-if" +version = "1.0.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd" + +[[package]] +name = "chrono" +version = "0.4.38" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a21f936df1771bf62b77f047b726c4625ff2e8aa607c01ec06e5a05bd8463401" +dependencies = [ + "android-tzdata", + "iana-time-zone", + "js-sys", + "num-traits", + "wasm-bindgen", + "windows-targets 0.52.6", +] + +[[package]] +name = "core-foundation-sys" +version = "0.8.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "06ea2b9bc92be3c2baa9334a323ebca2d6f074ff852cd1d7b11064035cd3868f" + +[[package]] +name = "dhat" +version = "0.3.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "98cd11d84628e233de0ce467de10b8633f4ddaecafadefc86e13b84b8739b827" +dependencies = [ + "backtrace", + "lazy_static", + "mintex", + "parking_lot", + "rustc-hash", + "serde", + "serde_json", + "thousands", +] + +[[package]] +name = "gimli" +version = "0.28.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4271d37baee1b8c7e4b708028c57d816cf9d2434acb33a549475f78c181f6253" + +[[package]] +name = "iana-time-zone" +version = "0.1.58" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8326b86b6cff230b97d0d312a6c40a60726df3332e721f72a1b035f451663b20" +dependencies = [ + "android_system_properties", + "core-foundation-sys", + "iana-time-zone-haiku", + "js-sys", + "wasm-bindgen", + "windows-core", +] + +[[package]] +name = "iana-time-zone-haiku" +version = "0.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f" +dependencies = [ + "cc", +] + +[[package]] +name = "itoa" +version = "1.0.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38" + +[[package]] +name = "js-sys" +version = "0.3.66" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cee9c64da59eae3b50095c18d3e74f8b73c0b86d2792824ff01bbce68ba229ca" +dependencies = [ + "wasm-bindgen", +] + +[[package]] +name = "lazy_static" +version = "1.4.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646" + +[[package]] +name = "libc" +version = "0.2.150" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "89d92a4743f9a61002fae18374ed11e7973f530cb3a3255fb354818118b2203c" + +[[package]] +name = "lock_api" +version = "0.4.11" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3c168f8615b12bc01f9c17e2eb0cc07dcae1940121185446edc3744920e8ef45" +dependencies = [ + "autocfg", + "scopeguard", +] + +[[package]] +name = "log" +version = "0.4.20" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b5e6163cb8c49088c2c36f57875e58ccd8c87c7427f7fbd50ea6710b2f3f2e8f" + +[[package]] +name = "memchr" +version = "2.6.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f665ee40bc4a3c5590afb1e9677db74a508659dfd71e126420da8274909a0167" + +[[package]] +name = "miniz_oxide" +version = "0.7.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e7810e0be55b428ada41041c41f32c9f1a42817901b4ccf45fa3d4b6561e74c7" +dependencies = [ + "adler", +] + +[[package]] +name = "mintex" +version = "0.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "fd7c5ba1c3b5a23418d7bbf98c71c3d4946a0125002129231da8d6b723d559cb" +dependencies = [ + "once_cell", + "sys-info", +] + +[[package]] +name = "num-traits" +version = "0.2.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "39e3200413f237f41ab11ad6d161bc7239c84dcb631773ccd7de3dfe4b5c267c" +dependencies = [ + "autocfg", +] + +[[package]] +name = "object" +version = "0.32.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9cf5f9dd3933bd50a9e1f149ec995f39ae2c496d31fd772c1fd45ebc27e902b0" +dependencies = [ + "memchr", +] + +[[package]] +name = "once_cell" +version = "1.19.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92" + +[[package]] +name = "parking_lot" +version = "0.12.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3742b2c103b9f06bc9fff0a37ff4912935851bee6d36f3c02bcc755bcfec228f" +dependencies = [ + "lock_api", + "parking_lot_core", +] + +[[package]] +name = "parking_lot_core" +version = "0.9.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4c42a9226546d68acdd9c0a280d17ce19bfe27a46bf68784e4066115788d008e" +dependencies = [ + "cfg-if", + "libc", + "redox_syscall", + "smallvec", + "windows-targets 0.48.5", +] + +[[package]] +name = "pico-args" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315" + +[[package]] +name = "proc-macro2" +version = "1.0.70" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "39278fbbf5fb4f646ce651690877f89d1c5811a3d4acb27700c1cb3cdb78fd3b" +dependencies = [ + "unicode-ident", +] + +[[package]] +name = "quote" +version = "1.0.33" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5267fca4496028628a95160fc423a33e8b2e6af8a5302579e322e4b520293cae" +dependencies = [ + "proc-macro2", +] + +[[package]] +name = "redox_syscall" +version = "0.4.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4722d768eff46b75989dd134e5c353f0d6296e5aaa3132e776cbdb56be7731aa" +dependencies = [ + "bitflags", +] + +[[package]] +name = "rustc-demangle" +version = "0.1.23" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d626bb9dae77e28219937af045c257c28bfd3f69333c512553507f5f9798cb76" + +[[package]] +name = "rustc-hash" +version = "1.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2" + +[[package]] +name = "ryu" +version = "1.0.15" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741" + +[[package]] +name = "scopeguard" +version = "1.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49" + +[[package]] +name = "serde" +version = "1.0.193" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "25dd9975e68d0cb5aa1120c288333fc98731bd1dd12f561e468ea4728c042b89" +dependencies = [ + "serde_derive", +] + +[[package]] +name = "serde_derive" +version = "1.0.193" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "43576ca501357b9b071ac53cdc7da8ef0cbd9493d8df094cd821777ea6e894d3" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "serde_json" +version = "1.0.108" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3d1c7e3eac408d115102c4c24ad393e0821bb3a5df4d506a80f85f7a742a526b" +dependencies = [ + "itoa", + "ryu", + "serde", +] + +[[package]] +name = "smallvec" +version = "1.11.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4dccd0940a2dcdf68d092b8cbab7dc0ad8fa938bf95787e1b916b0e3d0e8e970" + +[[package]] +name = "syn" +version = "2.0.39" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "23e78b90f2fcf45d3e842032ce32e3f2d1545ba6636271dcbf24fa306d87be7a" +dependencies = [ + "proc-macro2", + "quote", + "unicode-ident", +] + +[[package]] +name = "sys-info" +version = "0.9.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0b3a0d0aba8bf96a0e1ddfdc352fc53b3df7f39318c71854910c3c4b024ae52c" +dependencies = [ + "cc", + "libc", +] + +[[package]] +name = "thousands" +version = "0.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3bf63baf9f5039dadc247375c29eb13706706cfde997d0330d05aa63a77d8820" + +[[package]] +name = "tinyjson" +version = "2.5.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9ab95735ea2c8fd51154d01e39cf13912a78071c2d89abc49a7ef102a7dd725a" + +[[package]] +name = "unicode-ident" +version = "1.0.12" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3354b9ac3fae1ff6755cb6db53683adb661634f67557942dea4facebec0fee4b" + +[[package]] +name = "wasm-bindgen" +version = "0.2.89" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0ed0d4f68a3015cc185aff4db9506a015f4b96f95303897bfa23f846db54064e" +dependencies = [ + "cfg-if", + "wasm-bindgen-macro", +] + +[[package]] +name = "wasm-bindgen-backend" +version = "0.2.89" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1b56f625e64f3a1084ded111c4d5f477df9f8c92df113852fa5a374dbda78826" +dependencies = [ + "bumpalo", + "log", + "once_cell", + "proc-macro2", + "quote", + "syn", + "wasm-bindgen-shared", +] + +[[package]] +name = "wasm-bindgen-macro" +version = "0.2.89" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0162dbf37223cd2afce98f3d0785506dcb8d266223983e4b5b525859e6e182b2" +dependencies = [ + "quote", + "wasm-bindgen-macro-support", +] + +[[package]] +name = "wasm-bindgen-macro-support" +version = "0.2.89" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f0eb82fcb7930ae6219a7ecfd55b217f5f0893484b7a13022ebb2b2bf20b5283" +dependencies = [ + "proc-macro2", + "quote", + "syn", + "wasm-bindgen-backend", + "wasm-bindgen-shared", +] + +[[package]] +name = "wasm-bindgen-shared" +version = "0.2.89" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7ab9b36309365056cd639da3134bf87fa8f3d86008abf99e612384a6eecd459f" + +[[package]] +name = "windows-core" +version = "0.51.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f1f8cf84f35d2db49a46868f947758c7a1138116f7fac3bc844f43ade1292e64" +dependencies = [ + "windows-targets 0.48.5", +] + +[[package]] +name = "windows-targets" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c" +dependencies = [ + "windows_aarch64_gnullvm 0.48.5", + "windows_aarch64_msvc 0.48.5", + "windows_i686_gnu 0.48.5", + "windows_i686_msvc 0.48.5", + "windows_x86_64_gnu 0.48.5", + "windows_x86_64_gnullvm 0.48.5", + "windows_x86_64_msvc 0.48.5", +] + +[[package]] +name = "windows-targets" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973" +dependencies = [ + "windows_aarch64_gnullvm 0.52.6", + "windows_aarch64_msvc 0.52.6", + "windows_i686_gnu 0.52.6", + "windows_i686_gnullvm", + "windows_i686_msvc 0.52.6", + "windows_x86_64_gnu 0.52.6", + "windows_x86_64_gnullvm 0.52.6", + "windows_x86_64_msvc 0.52.6", +] + +[[package]] +name = "windows_aarch64_gnullvm" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8" + +[[package]] +name = "windows_aarch64_gnullvm" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3" + +[[package]] +name = "windows_aarch64_msvc" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc" + +[[package]] +name = "windows_aarch64_msvc" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469" + +[[package]] +name = "windows_i686_gnu" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e" + +[[package]] +name = "windows_i686_gnu" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b" + +[[package]] +name = "windows_i686_gnullvm" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66" + +[[package]] +name = "windows_i686_msvc" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406" + +[[package]] +name = "windows_i686_msvc" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66" + +[[package]] +name = "windows_x86_64_gnu" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e" + +[[package]] +name = "windows_x86_64_gnu" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78" + +[[package]] +name = "windows_x86_64_gnullvm" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc" + +[[package]] +name = "windows_x86_64_gnullvm" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d" + +[[package]] +name = "windows_x86_64_msvc" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538" + +[[package]] +name = "windows_x86_64_msvc" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec" diff --git a/Cargo.toml b/Cargo.toml new file mode 100644 index 0000000..038a1a3 --- /dev/null +++ b/Cargo.toml @@ -0,0 +1,30 @@ +[package] +name = "advent_of_code" +version = "0.11.0" +authors = ["Felix Spรถttel <1682504+fspoettel@users.noreply.github.com>"] +edition = "2021" +default-run = "advent_of_code" +publish = false + +# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html +[lib] +doctest = false + +[profile.dhat] +inherits = "release" +debug = 1 + +[features] +dhat-heap = ["dhat"] +today = ["chrono"] +test_lib = [] + +[dependencies] + +# Template dependencies +chrono = { version = "0.4.38", optional = true } +dhat = { version = "0.3.3", optional = true } +pico-args = "0.5.0" +tinyjson = "2.5.1" + +# Solution dependencies diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..b97fd05 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2021 Felix Spoettel + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..a155efa --- /dev/null +++ b/README.md @@ -0,0 +1,304 @@ + + +# ๐ŸŽ„ Advent of Code {year} + +Solutions for [Advent of Code](https://adventofcode.com/) in [Rust](https://www.rust-lang.org/). + + + + + +--- + +## Template setup + +This template supports all major OS (macOS, Linux, Windows). + +### ๐Ÿ“ Create your repository + +1. Open [the template repository](https://github.com/fspoettel/advent-of-code-rust) on Github. +2. Click [Use this template](https://github.com/fspoettel/advent-of-code-rust/generate) and create your repository. +3. Clone your repository to your computer. +4. If you are solving a previous year's advent of code, change the `AOC_YEAR` variable in `.cargo/config.toml` to reflect the year you are solving. + +### ๐Ÿ’ป Setup rust + +1. Install the [Rust toolchain](https://www.rust-lang.org/tools/install). +2. (recommended) Install the [rust-analyzer](https://rust-analyzer.github.io/manual.html) extension for your code editor. +3. (optional) Install a native debugger. If you are using VS Code, [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb) is a good option. + +--- + +โœจ You can start solving puzzles now! Head to the [Usage section](#usage) to see how to use this template. If you like, you can configure [some optional features](#optional-template-features). + +## Usage + +### โžก๏ธ Scaffold a day + +```sh +# example: `cargo scaffold 1` +cargo scaffold + +# output: +# Created module file "src/bin/01.rs" +# Created empty input file "data/inputs/01.txt" +# Created empty example file "data/examples/01.txt" +# --- +# ๐ŸŽ„ Type `cargo solve 01` to run your solution. +``` + +Individual solutions live in the `./src/bin/` directory as separate binaries. _Inputs_ and _examples_ live in the the `./data` directory. + +Every [solution](https://github.com/fspoettel/advent-of-code-rust/blob/main/src/template.txt) has _tests_ referencing its _example_ file in `./data/examples`. Use these tests to develop and debug your solutions against the example input. In VS Code, `rust-analyzer` will display buttons for running / debugging these unit tests above the unit test blocks. + +> [!TIP] +> If a day has multiple example inputs, you can use the `read_file_part()` helper in your tests instead of `read_file()`. If this e.g. applies to day 1, you can create a second example file `01-2.txt` and invoke the helper like `let result = part_two(&advent_of_code::template::read_file_part("examples", DAY, 2));`. This supports an arbitrary number of example files. + +### โžก๏ธ Download input for a day + +> [!IMPORTANT] +> This requires [installing the aoc-cli crate](#configure-aoc-cli-integration). + +You can automatically download puzzle input and description by either appending the `--download` flag to `scaffold` (e.g. `cargo scaffold 4 --download`) or with the separate `download` command: + +```sh +# example: `cargo download 1` +cargo download + +# output: +# [INFO aoc] ๐ŸŽ„ aoc-cli - Advent of Code command-line tool +# [INFO aoc_client] ๐ŸŽ… Saved puzzle to 'data/puzzles/01.md' +# [INFO aoc_client] ๐ŸŽ… Saved input to 'data/inputs/01.txt' +# --- +# ๐ŸŽ„ Successfully wrote input to "data/inputs/01.txt". +# ๐ŸŽ„ Successfully wrote puzzle to "data/puzzles/01.md". +``` + +### โžก๏ธ Run solutions for a day + +```sh +# example: `cargo solve 01` +cargo solve + +# output: +# Finished dev [unoptimized + debuginfo] target(s) in 0.13s +# Running `target/debug/01` +# Part 1: 42 (166.0ns) +# Part 2: 42 (41.0ns) +``` + +The `solve` command runs your solution against real puzzle inputs. To run an optimized build of your code, append the `--release` flag as with any other rust program. + +#### Submitting solutions + +> [!IMPORTANT] +> This requires [installing the aoc-cli crate](#configure-aoc-cli-integration). + +Append the `--submit ` option to the `solve` command to submit your solution for checking. + +### โžก๏ธ Run all solutions + +```sh +cargo all + +# output: +# Running `target/release/advent_of_code` +# ---------- +# | Day 01 | +# ---------- +# Part 1: 42 (19.0ns) +# Part 2: 42 (19.0ns) +# <...other days...> +# Total: 0.20ms +``` + +This runs all solutions sequentially and prints output to the command-line. Same as for the `solve` command, the `--release` flag runs an optimized build. + +### โžก๏ธ Benchmark your solutions + +```sh +# example: `cargo time 8 --store` +cargo time [--all] [--store] + +# output: +# Day 08 +# ------ +# Part 1: 1 (39.0ns @ 10000 samples) +# Part 2: 2 (39.0ns @ 10000 samples) +# +# Total (Run): 0.00ms +# +# Stored updated benchmarks. +``` + +The `cargo time` command allows you to benchmark your code and store timings in the readme. When benching, the runner will run your code between `10` and `10.000` times, depending on execution time of first execution, and print the average execution time. + +`cargo time` has three modes of execution: + + 1. `cargo time` without arguments incrementally benches solutions that do not have been stored in the readme yet and skips the rest. + 2. `cargo time ` benches a single solution. + 3. `cargo time --all` benches all solutions. + +By default, `cargo time` does not write to the readme. In order to do so, append the `--store` flag: `cargo time --store`. + +> Please note that these are not _scientific_ benchmarks, understand them as a fun approximation. ๐Ÿ˜‰ Timings, especially in the microseconds range, might change a bit between invocations. + +### โžก๏ธ Run all tests + +```sh +cargo test +``` + +To run tests for a specific day, append `--bin `, e.g. `cargo test --bin 01`. You can further scope it down to a specific part, e.g. `cargo test --bin 01 part_one`. + +### โžก๏ธ Read puzzle description + +> [!IMPORTANT] +> This command requires [installing the aoc-cli crate](#configure-aoc-cli-integration). + +```sh +# example: `cargo read 1` +cargo read + +# output: +# Loaded session cookie from "/Users//.adventofcode.session". +# Fetching puzzle for day 1, 2022... +# ...the input... +``` + +### โžก๏ธ Scaffold, download & read the current aoc day + +> [!IMPORTANT] +> This command requires [installing the aoc-cli crate](#configure-aoc-cli-integration). + +During december, the `today` shorthand command can be used to: + + - scaffold a solution for the current day + - download its input + - and read the puzzle + +in one go. + +```sh +# example: `cargo today` on December 1st +cargo today + +# output: +# Created module file "src/bin/01.rs" +# Created empty input file "data/inputs/01.txt" +# Created empty example file "data/examples/01.txt" +# --- +# ๐ŸŽ„ Type `cargo solve 01` to run your solution. +# [INFO aoc] ๐ŸŽ„ aoc-cli - Advent of Code command-line tool +# [INFO aoc_client] ๐ŸŽ… Saved puzzle to 'data/puzzles/01.md' +# [INFO aoc_client] ๐ŸŽ… Saved input to 'data/inputs/01.txt' +# --- +# ๐ŸŽ„ Successfully wrote input to "data/inputs/01.txt". +# ๐ŸŽ„ Successfully wrote puzzle to "data/puzzles/01.md". +# +# Loaded session cookie from "/Users//.adventofcode.session". +# Fetching puzzle for day 1, 2022... +# ...the input... +``` + +### โžก๏ธ Format code + +```sh +cargo fmt +``` + +### โžก๏ธ Lint code + +```sh +cargo clippy +``` + +## Optional template features + +### Configure aoc-cli integration + +1. Install [`aoc-cli`](https://github.com/scarvalhojr/aoc-cli/) via cargo: `cargo install aoc-cli --version 0.12.0` +2. Create the file `/.adventofcode.session` and paste your session cookie into it. To retrieve the session cookie, press F12 anywhere on the Advent of Code website to open your browser developer tools. Look in _Cookies_ under the _Application_ or _Storage_ tab, and copy out the `session` cookie value. [^1] + +Once installed, you can use the [download command](#download-input--description-for-a-day), the read command, and automatically submit solutions via the [`--submit` flag](#submitting-solutions). + +### Automatically track โญ๏ธ progress in the readme + +This template includes [a Github action](https://github.com/k2bd/advent-readme-stars) that automatically updates the readme with your advent of code progress. + +To enable it, complete the following steps: + +#### 1. Create a private leaderboard + +Go to the leaderboard page of the year you want to track and click _Private Leaderboard_. If you have not created a leaderboard yet, create one by clicking _Create It_. Your leaderboard should be accessible under `https://adventofcode.com/{year}/leaderboard/private/view/{aoc_user_id}`. + +#### 2. Set repository secrets + +Go to the _Secrets_ tab in your repository settings and create the following secrets: + +- `AOC_USER_ID`: Go to [this page](https://adventofcode.com/settings) and copy your user id. It's the number behind the `#` symbol in the first name option. Example: `3031`. +- `AOC_YEAR`: the year you want to track. Example: `2021`. +- `AOC_SESSION`: an active session[^2] for the advent of code website. To get this, press F12 anywhere on the Advent of Code website to open your browser developer tools. Look in your Cookies under the Application or Storage tab, and copy out the `session` cookie. + +Go to the _Variables_ tab in your repository settings and create the following variable: + +- `AOC_ENABLED`: This variable controls whether the workflow is enabled. Set it to `true` to enable the progress tracker. After you complete AoC or no longer work on it, you can set this to `false` to disable the CI. + +โœจ You can now run this action manually via the _Run workflow_ button on the workflow page. If you want the workflow to run automatically, uncomment the `schedule` section in the `readme-stars.yml` workflow file or add a `push` trigger. + +### Enable code formatting / clippy checks in the CI + +Uncomment the respective sections in the `ci.yml` workflow. + +### Use DHAT to profile heap allocations + +If you are not only interested in the runtime of your solution, but also its memory allocation profile, you can use the template's [DHAT](https://valgrind.org/docs/manual/dh-manual.html) integration to analyze it. In order to activate DHAT, call the `solve` command with the `--dhat` flag. + +```sh +cargo solve 1 --dhat + +# output: +# Running `target/dhat/1` +# dhat: Total: 276 bytes in 3 blocks +# dhat: At t-gmax: 232 bytes in 2 blocks +# dhat: At t-end: 0 bytes in 0 blocks +# dhat: The data has been saved to dhat-heap.json, and is viewable with dhat/dh_view.html +# Part 1: 9001 (4.1ms) +``` + +The command will output some basic stats to the command-line and generate a `dhat-heap.json` report in the repo root directory. + +You can pass the report a tool like [dh-view](https://nnethercote.github.io/dh_view/dh_view.html) to view a detailed breakdown of heap allocations. + +### Use VS Code to debug your code + +1. Install [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer) and [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb). +2. Set breakpoints in your code. [^3] +3. Click _Debug_ next to the unit test or the _main_ function. [^4] +4. The debugger will halt your program at the specific line and allow you to inspect the local stack. [^5] + +## Useful crates + +- [itertools](https://crates.io/crates/itertools): Extends iterators with extra methods and adaptors. Frequently useful for aoc puzzles. +- [regex](https://crates.io/crates/regex): Official regular expressions implementation for Rust. + +A curated list of popular crates can be found on [blessred.rs](https://blessed.rs/crates). + +Do you have aoc-specific crate recommendations? [Share them!](https://github.com/fspoettel/advent-of-code-rust/edit/main/README.md) + +## Common pitfalls + +- **Integer overflows:** This template uses 32-bit integers by default because it is generally faster - for example when packed in large arrays or structs - than using 64-bit integers everywhere. For some problems, solutions for real input might exceed 32-bit integer space. While this is checked and panics in `debug` mode, integers [wrap](https://doc.rust-lang.org/book/ch03-02-data-types.html#integer-overflow) in `release` mode, leading to wrong output when running your solution. + +## Footnotes + +[^1]: The session cookie might expire after a while (~1 month) which causes the downloads to fail. To fix this issue, refresh the `.adventofcode.session` file. +[^2]: The session cookie might expire after a while (~1 month) which causes the automated workflow to fail. To fix this issue, refresh the AOC_SESSION secret. +[^3]: + Set a breakpoint + +[^4]: + Run debugger + +[^5]: + Inspect debugger state diff --git a/data/examples/.keep b/data/examples/.keep new file mode 100644 index 0000000..e69de29 diff --git a/data/inputs/.keep b/data/inputs/.keep new file mode 100644 index 0000000..e69de29 diff --git a/data/puzzles/.keep b/data/puzzles/.keep new file mode 100644 index 0000000..e69de29 diff --git a/src/bin/.keep b/src/bin/.keep new file mode 100644 index 0000000..e69de29 diff --git a/src/lib.rs b/src/lib.rs new file mode 100644 index 0000000..27d7df8 --- /dev/null +++ b/src/lib.rs @@ -0,0 +1,3 @@ +pub mod template; + +// Use this file to add helper functions and additional modules. diff --git a/src/main.rs b/src/main.rs new file mode 100644 index 0000000..0ee1c39 --- /dev/null +++ b/src/main.rs @@ -0,0 +1,140 @@ +use advent_of_code::template::commands::{all, download, read, scaffold, solve, time}; +use args::{parse, AppArguments}; + +#[cfg(feature = "today")] +use advent_of_code::template::Day; +#[cfg(feature = "today")] +use std::process; + +mod args { + use advent_of_code::template::Day; + use std::process; + + pub enum AppArguments { + Download { + day: Day, + }, + Read { + day: Day, + }, + Scaffold { + day: Day, + download: bool, + overwrite: bool, + }, + Solve { + day: Day, + release: bool, + dhat: bool, + submit: Option, + }, + All { + release: bool, + }, + Time { + all: bool, + day: Option, + store: bool, + }, + #[cfg(feature = "today")] + Today, + } + + pub fn parse() -> Result> { + let mut args = pico_args::Arguments::from_env(); + + let app_args = match args.subcommand()?.as_deref() { + Some("all") => AppArguments::All { + release: args.contains("--release"), + }, + Some("time") => { + let all = args.contains("--all"); + let store = args.contains("--store"); + + AppArguments::Time { + all, + day: args.opt_free_from_str()?, + store, + } + } + Some("download") => AppArguments::Download { + day: args.free_from_str()?, + }, + Some("read") => AppArguments::Read { + day: args.free_from_str()?, + }, + Some("scaffold") => AppArguments::Scaffold { + day: args.free_from_str()?, + download: args.contains("--download"), + overwrite: args.contains("--overwrite"), + }, + Some("solve") => AppArguments::Solve { + day: args.free_from_str()?, + release: args.contains("--release"), + submit: args.opt_value_from_str("--submit")?, + dhat: args.contains("--dhat"), + }, + #[cfg(feature = "today")] + Some("today") => AppArguments::Today, + Some(x) => { + eprintln!("Unknown command: {x}"); + process::exit(1); + } + None => { + eprintln!("No command specified."); + process::exit(1); + } + }; + + let remaining = args.finish(); + if !remaining.is_empty() { + eprintln!("Warning: unknown argument(s): {remaining:?}."); + } + + Ok(app_args) + } +} + +fn main() { + match parse() { + Err(err) => { + eprintln!("Error: {err}"); + std::process::exit(1); + } + Ok(args) => match args { + AppArguments::All { release } => all::handle(release), + AppArguments::Time { day, all, store } => time::handle(day, all, store), + AppArguments::Download { day } => download::handle(day), + AppArguments::Read { day } => read::handle(day), + AppArguments::Scaffold { day, download, overwrite } => { + scaffold::handle(day, overwrite); + if download { + download::handle(day); + } + } + AppArguments::Solve { + day, + release, + dhat, + submit, + } => solve::handle(day, release, dhat, submit), + #[cfg(feature = "today")] + AppArguments::Today => { + match Day::today() { + Some(day) => { + scaffold::handle(day, false); + download::handle(day); + read::handle(day) + } + None => { + eprintln!( + "`today` command can only be run between the 1st and \ + the 25th of december. Please use `scaffold` with a specific day." + ); + process::exit(1) + } + }; + } + }, + }; +} diff --git a/src/template.txt b/src/template.txt new file mode 100644 index 0000000..11344df --- /dev/null +++ b/src/template.txt @@ -0,0 +1,26 @@ +advent_of_code::solution!(%DAY_NUMBER%); + +pub fn part_one(input: &str) -> Option { + None +} + +pub fn part_two(input: &str) -> Option { + None +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn test_part_one() { + let result = part_one(&advent_of_code::template::read_file("examples", DAY)); + assert_eq!(result, None); + } + + #[test] + fn test_part_two() { + let result = part_two(&advent_of_code::template::read_file("examples", DAY)); + assert_eq!(result, None); + } +} diff --git a/src/template/aoc_cli.rs b/src/template/aoc_cli.rs new file mode 100644 index 0000000..2d3300d --- /dev/null +++ b/src/template/aoc_cli.rs @@ -0,0 +1,125 @@ +/// Wrapper module around the "aoc-cli" command-line. +use std::{ + fmt::Display, + process::{Command, Output, Stdio}, +}; + +use crate::template::Day; + +#[derive(Debug)] +pub enum AocCommandError { + CommandNotFound, + CommandNotCallable, + BadExitStatus(Output), +} + +impl Display for AocCommandError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + match self { + AocCommandError::CommandNotFound => write!(f, "aoc-cli is not present in environment."), + AocCommandError::CommandNotCallable => write!(f, "aoc-cli could not be called."), + AocCommandError::BadExitStatus(_) => { + write!(f, "aoc-cli exited with a non-zero status.") + } + } + } +} + +pub fn check() -> Result<(), AocCommandError> { + Command::new("aoc") + .arg("-V") + .output() + .map_err(|_| AocCommandError::CommandNotFound)?; + Ok(()) +} + +pub fn read(day: Day) -> Result { + let puzzle_path = get_puzzle_path(day); + + let args = build_args( + "read", + &[ + "--description-only".into(), + "--puzzle-file".into(), + puzzle_path, + ], + day, + ); + + call_aoc_cli(&args) +} + +pub fn download(day: Day) -> Result { + let input_path = get_input_path(day); + let puzzle_path = get_puzzle_path(day); + + let args = build_args( + "download", + &[ + "--overwrite".into(), + "--input-file".into(), + input_path.to_string(), + "--puzzle-file".into(), + puzzle_path.to_string(), + ], + day, + ); + + let output = call_aoc_cli(&args)?; + println!("---"); + println!("๐ŸŽ„ Successfully wrote input to \"{}\".", &input_path); + println!("๐ŸŽ„ Successfully wrote puzzle to \"{}\".", &puzzle_path); + Ok(output) +} + +pub fn submit(day: Day, part: u8, result: &str) -> Result { + // workaround: the argument order is inverted for submit. + let mut args = build_args("submit", &[], day); + args.push(part.to_string()); + args.push(result.to_string()); + call_aoc_cli(&args) +} + +fn get_input_path(day: Day) -> String { + format!("data/inputs/{day}.txt") +} + +fn get_puzzle_path(day: Day) -> String { + format!("data/puzzles/{day}.md") +} + +fn get_year() -> Option { + match std::env::var("AOC_YEAR") { + Ok(x) => x.parse().ok().or(None), + Err(_) => None, + } +} + +fn build_args(command: &str, args: &[String], day: Day) -> Vec { + let mut cmd_args = args.to_vec(); + + if let Some(year) = get_year() { + cmd_args.push("--year".into()); + cmd_args.push(year.to_string()); + } + + cmd_args.append(&mut vec!["--day".into(), day.to_string(), command.into()]); + + cmd_args +} + +fn call_aoc_cli(args: &[String]) -> Result { + // println!("Calling >aoc with: {}", args.join(" ")); + let output = Command::new("aoc") + .args(args) + .stdout(Stdio::inherit()) + .stderr(Stdio::inherit()) + .output() + .map_err(|_| AocCommandError::CommandNotCallable)?; + + if output.status.success() { + Ok(output) + } else { + Err(AocCommandError::BadExitStatus(output)) + } +} diff --git a/src/template/commands/all.rs b/src/template/commands/all.rs new file mode 100644 index 0000000..b844e1e --- /dev/null +++ b/src/template/commands/all.rs @@ -0,0 +1,5 @@ +use crate::template::{all_days, run_multi::run_multi}; + +pub fn handle(is_release: bool) { + run_multi(&all_days().collect(), is_release, false); +} diff --git a/src/template/commands/download.rs b/src/template/commands/download.rs new file mode 100644 index 0000000..9274f05 --- /dev/null +++ b/src/template/commands/download.rs @@ -0,0 +1,14 @@ +use crate::template::{aoc_cli, Day}; +use std::process; + +pub fn handle(day: Day) { + if aoc_cli::check().is_err() { + eprintln!("command \"aoc\" not found or not callable. Try running \"cargo install aoc-cli\" to install it."); + process::exit(1); + } + + if let Err(e) = aoc_cli::download(day) { + eprintln!("failed to call aoc-cli: {e}"); + process::exit(1); + }; +} diff --git a/src/template/commands/mod.rs b/src/template/commands/mod.rs new file mode 100644 index 0000000..36be280 --- /dev/null +++ b/src/template/commands/mod.rs @@ -0,0 +1,6 @@ +pub mod all; +pub mod download; +pub mod read; +pub mod scaffold; +pub mod solve; +pub mod time; diff --git a/src/template/commands/read.rs b/src/template/commands/read.rs new file mode 100644 index 0000000..3e1a307 --- /dev/null +++ b/src/template/commands/read.rs @@ -0,0 +1,15 @@ +use std::process; + +use crate::template::{aoc_cli, Day}; + +pub fn handle(day: Day) { + if aoc_cli::check().is_err() { + eprintln!("command \"aoc\" not found or not callable. Try running \"cargo install aoc-cli\" to install it."); + process::exit(1); + } + + if let Err(e) = aoc_cli::read(day) { + eprintln!("failed to call aoc-cli: {e}"); + process::exit(1); + }; +} diff --git a/src/template/commands/scaffold.rs b/src/template/commands/scaffold.rs new file mode 100644 index 0000000..fc3d950 --- /dev/null +++ b/src/template/commands/scaffold.rs @@ -0,0 +1,79 @@ +use std::{ + fs::{File, OpenOptions}, + io::Write, + process, +}; + +use crate::template::Day; + +const MODULE_TEMPLATE: &str = + include_str!(concat!(env!("CARGO_MANIFEST_DIR"), "/src/template.txt")); + +fn safe_create_file(path: &str, overwrite: bool) -> Result { + let mut file = OpenOptions::new(); + if overwrite { + file.create(true); + } else { + file.create_new(true); + } + file.truncate(true).write(true).open(path) +} + +fn create_file(path: &str) -> Result { + OpenOptions::new() + .write(true) + .create(true) + .truncate(true) + .open(path) +} + +pub fn handle(day: Day, overwrite: bool) { + let input_path = format!("data/inputs/{day}.txt"); + let example_path = format!("data/examples/{day}.txt"); + let module_path = format!("src/bin/{day}.rs"); + + let mut file = match safe_create_file(&module_path, overwrite) { + Ok(file) => file, + Err(e) => { + eprintln!("Failed to create module file: {e}"); + process::exit(1); + } + }; + + match file.write_all( + MODULE_TEMPLATE + .replace("%DAY_NUMBER%", &day.into_inner().to_string()) + .as_bytes(), + ) { + Ok(()) => { + println!("Created module file \"{}\"", &module_path); + } + Err(e) => { + eprintln!("Failed to write module contents: {e}"); + process::exit(1); + } + } + + match create_file(&input_path) { + Ok(_) => { + println!("Created empty input file \"{}\"", &input_path); + } + Err(e) => { + eprintln!("Failed to create input file: {e}"); + process::exit(1); + } + } + + match create_file(&example_path) { + Ok(_) => { + println!("Created empty example file \"{}\"", &example_path); + } + Err(e) => { + eprintln!("Failed to create example file: {e}"); + process::exit(1); + } + } + + println!("---"); + println!("๐ŸŽ„ Type `cargo solve {day}` to run your solution."); +} diff --git a/src/template/commands/solve.rs b/src/template/commands/solve.rs new file mode 100644 index 0000000..ec92a6f --- /dev/null +++ b/src/template/commands/solve.rs @@ -0,0 +1,34 @@ +use std::process::{Command, Stdio}; + +use crate::template::Day; + +pub fn handle(day: Day, release: bool, dhat: bool, submit_part: Option) { + let mut cmd_args = vec!["run".to_string(), "--bin".to_string(), day.to_string()]; + + if dhat { + cmd_args.extend([ + "--profile".to_string(), + "dhat".to_string(), + "--features".to_string(), + "dhat-heap".to_string(), + ]); + } else if release { + cmd_args.push("--release".to_string()); + } + + cmd_args.push("--".to_string()); + + if let Some(submit_part) = submit_part { + cmd_args.push("--submit".to_string()); + cmd_args.push(submit_part.to_string()); + } + + let mut cmd = Command::new("cargo") + .args(&cmd_args) + .stdout(Stdio::inherit()) + .stderr(Stdio::inherit()) + .spawn() + .unwrap(); + + cmd.wait().unwrap(); +} diff --git a/src/template/commands/time.rs b/src/template/commands/time.rs new file mode 100644 index 0000000..49b91a8 --- /dev/null +++ b/src/template/commands/time.rs @@ -0,0 +1,40 @@ +use std::collections::HashSet; + +use crate::template::run_multi::run_multi; +use crate::template::timings::Timings; +use crate::template::{all_days, readme_benchmarks, Day}; + +pub fn handle(day: Option, run_all: bool, store: bool) { + let stored_timings = Timings::read_from_file(); + + let days_to_run = day.map_or_else( + || { + if run_all { + all_days().collect() + } else { + // when the `--all` flag is not set, filter out days that are fully benched. + all_days() + .filter(|day| !stored_timings.is_day_complete(*day)) + .collect() + } + }, + |day| HashSet::from([day]), + ); + + let timings = run_multi(&days_to_run, true, true).unwrap(); + + if store { + let merged_timings = stored_timings.merge(&timings); + merged_timings.store_file().unwrap(); + + println!(); + match readme_benchmarks::update(merged_timings) { + Ok(()) => { + println!("Stored updated benchmarks."); + } + Err(_) => { + eprintln!("Failed to store updated benchmarks."); + } + } + } +} diff --git a/src/template/day.rs b/src/template/day.rs new file mode 100644 index 0000000..99b8280 --- /dev/null +++ b/src/template/day.rs @@ -0,0 +1,192 @@ +use std::error::Error; +use std::fmt::Display; +use std::str::FromStr; + +#[cfg(feature = "today")] +use chrono::{Datelike, FixedOffset, Utc}; + +#[cfg(feature = "today")] +const SERVER_UTC_OFFSET: i32 = -5; + +/// A valid day number of advent (i.e. an integer in range 1 to 25). +/// +/// # Display +/// This value displays as a two digit number. +/// +/// ``` +/// # use advent_of_code::Day; +/// let day = Day::new(8).unwrap(); +/// assert_eq!(day.to_string(), "08") +/// ``` +#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)] +pub struct Day(u8); + +impl Day { + /// Creates a [`Day`] from the provided value if it's in the valid range, + /// returns [`None`] otherwise. + pub fn new(day: u8) -> Option { + if day == 0 || day > 25 { + return None; + } + Some(Self(day)) + } + + // Not part of the public API + #[doc(hidden)] + pub const fn __new_unchecked(day: u8) -> Self { + Self(day) + } + + /// Converts the [`Day`] into an [`u8`]. + pub fn into_inner(self) -> u8 { + self.0 + } +} + +#[cfg(feature = "today")] +impl Day { + /// Returns the current day if it's between the 1st and the 25th of december, `None` otherwise. + pub fn today() -> Option { + let offset = FixedOffset::east_opt(SERVER_UTC_OFFSET * 3600)?; + let today = Utc::now().with_timezone(&offset); + if today.month() == 12 && today.day() <= 25 { + Self::new(u8::try_from(today.day()).ok()?) + } else { + None + } + } +} + +impl Display for Day { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + write!(f, "{:02}", self.0) + } +} + +impl PartialEq for Day { + fn eq(&self, other: &u8) -> bool { + self.0.eq(other) + } +} + +impl PartialOrd for Day { + fn partial_cmp(&self, other: &u8) -> Option { + self.0.partial_cmp(other) + } +} + +/* -------------------------------------------------------------------------- */ + +impl FromStr for Day { + type Err = DayFromStrError; + + fn from_str(s: &str) -> Result { + let day = s.parse().map_err(|_| DayFromStrError)?; + Self::new(day).ok_or(DayFromStrError) + } +} + +/// An error which can be returned when parsing a [`Day`]. +#[derive(Debug)] +pub struct DayFromStrError; + +impl Error for DayFromStrError {} + +impl Display for DayFromStrError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + f.write_str("expecting a day number between 1 and 25") + } +} + +/* -------------------------------------------------------------------------- */ + +/// An iterator that yields every day of advent from the 1st to the 25th. +pub fn all_days() -> AllDays { + AllDays::new() +} + +/// An iterator that yields every day of advent from the 1st to the 25th. +pub struct AllDays { + current: u8, +} + +impl AllDays { + #[allow(clippy::new_without_default)] + pub fn new() -> Self { + Self { current: 1 } + } +} + +impl Iterator for AllDays { + type Item = Day; + + fn next(&mut self) -> Option { + if self.current > 25 { + return None; + } + // NOTE: the iterator starts at 1 and we have verified that the value is not above 25. + let day = Day(self.current); + self.current += 1; + + Some(day) + } +} + +/* -------------------------------------------------------------------------- */ + +/// Creates a [`Day`] value in a const context. +#[macro_export] +macro_rules! day { + ($day:expr) => {{ + const _ASSERT: () = assert!( + $day != 0 && $day <= 25, + concat!( + "invalid day number `", + $day, + "`, expecting a value between 1 and 25" + ), + ); + $crate::template::Day::__new_unchecked($day) + }}; +} + +/* -------------------------------------------------------------------------- */ + +#[cfg(feature = "test_lib")] +mod tests { + use super::{all_days, Day}; + + #[test] + fn all_days_iterator() { + let mut iter = all_days(); + + assert_eq!(iter.next(), Some(Day(1))); + assert_eq!(iter.next(), Some(Day(2))); + assert_eq!(iter.next(), Some(Day(3))); + assert_eq!(iter.next(), Some(Day(4))); + assert_eq!(iter.next(), Some(Day(5))); + assert_eq!(iter.next(), Some(Day(6))); + assert_eq!(iter.next(), Some(Day(7))); + assert_eq!(iter.next(), Some(Day(8))); + assert_eq!(iter.next(), Some(Day(9))); + assert_eq!(iter.next(), Some(Day(10))); + assert_eq!(iter.next(), Some(Day(11))); + assert_eq!(iter.next(), Some(Day(12))); + assert_eq!(iter.next(), Some(Day(13))); + assert_eq!(iter.next(), Some(Day(14))); + assert_eq!(iter.next(), Some(Day(15))); + assert_eq!(iter.next(), Some(Day(16))); + assert_eq!(iter.next(), Some(Day(17))); + assert_eq!(iter.next(), Some(Day(18))); + assert_eq!(iter.next(), Some(Day(19))); + assert_eq!(iter.next(), Some(Day(20))); + assert_eq!(iter.next(), Some(Day(21))); + assert_eq!(iter.next(), Some(Day(22))); + assert_eq!(iter.next(), Some(Day(23))); + assert_eq!(iter.next(), Some(Day(24))); + assert_eq!(iter.next(), Some(Day(25))); + assert_eq!(iter.next(), None); + } +} + +/* -------------------------------------------------------------------------- */ diff --git a/src/template/mod.rs b/src/template/mod.rs new file mode 100644 index 0000000..dd8e4c0 --- /dev/null +++ b/src/template/mod.rs @@ -0,0 +1,68 @@ +use std::{env, fs}; + +pub mod aoc_cli; +pub mod commands; +pub mod runner; + +pub use day::*; + +mod day; +mod readme_benchmarks; +mod run_multi; +mod timings; + +pub const ANSI_ITALIC: &str = "\x1b[3m"; +pub const ANSI_BOLD: &str = "\x1b[1m"; +pub const ANSI_RESET: &str = "\x1b[0m"; + +/// Helper function that reads a text file to a string. +#[must_use] +pub fn read_file(folder: &str, day: Day) -> String { + let cwd = env::current_dir().unwrap(); + let filepath = cwd.join("data").join(folder).join(format!("{day}.txt")); + let f = fs::read_to_string(filepath); + f.expect("could not open input file") +} + +/// Helper function that reads a text file to string, appending a part suffix. E.g. like `01-2.txt`. +#[must_use] +pub fn read_file_part(folder: &str, day: Day, part: u8) -> String { + let cwd = env::current_dir().unwrap(); + let filepath = cwd + .join("data") + .join(folder) + .join(format!("{day}-{part}.txt")); + let f = fs::read_to_string(filepath); + f.expect("could not open input file") +} + +/// Creates the constant `DAY` and sets up the input and runner for each part. +/// +/// The optional, second parameter (1 or 2) allows you to only run a single part of the solution. +#[macro_export] +macro_rules! solution { + ($day:expr) => { + $crate::solution!(@impl $day, [part_one, 1] [part_two, 2]); + }; + ($day:expr, 1) => { + $crate::solution!(@impl $day, [part_one, 1]); + }; + ($day:expr, 2) => { + $crate::solution!(@impl $day, [part_two, 2]); + }; + + (@impl $day:expr, $( [$func:expr, $part:expr] )*) => { + /// The current day. + const DAY: $crate::template::Day = $crate::day!($day); + + #[cfg(feature = "dhat-heap")] + #[global_allocator] + static ALLOC: dhat::Alloc = dhat::Alloc; + + fn main() { + use $crate::template::runner::*; + let input = $crate::template::read_file("inputs", DAY); + $( run_part($func, &input, DAY, $part); )* + } + }; +} diff --git a/src/template/readme_benchmarks.rs b/src/template/readme_benchmarks.rs new file mode 100644 index 0000000..5c42ae4 --- /dev/null +++ b/src/template/readme_benchmarks.rs @@ -0,0 +1,183 @@ +/// Module that updates the readme me with timing information. +/// The approach taken is similar to how `aoc-readme-stars` handles this. +use std::{fs, io}; + +use crate::template::timings::Timings; +use crate::template::Day; + +static MARKER: &str = ""; + +#[allow(dead_code)] +#[derive(Debug)] +pub enum Error { + Parser(String), + IO(io::Error), +} + +impl From for Error { + fn from(e: std::io::Error) -> Self { + Error::IO(e) + } +} + +pub struct TablePosition { + pos_start: usize, + pos_end: usize, +} + +#[must_use] +pub fn get_path_for_bin(day: Day) -> String { + format!("./src/bin/{day}.rs") +} + +fn locate_table(readme: &str) -> Result { + let matches: Vec<_> = readme.match_indices(MARKER).collect(); + + if matches.len() > 2 { + return Err(Error::Parser( + "{}: too many occurences of marker in README.".into(), + )); + } + + let pos_start = matches + .first() + .map(|m| m.0) + .ok_or_else(|| Error::Parser("Could not find table start position.".into()))?; + + let pos_end = matches + .last() + .map(|m| m.0 + m.1.len()) + .ok_or_else(|| Error::Parser("Could not find table end position.".into()))?; + + Ok(TablePosition { pos_start, pos_end }) +} + +fn construct_table(prefix: &str, timings: Timings, total_millis: f64) -> String { + let header = format!("{prefix} Benchmarks"); + + let mut lines: Vec = vec![ + MARKER.into(), + header, + String::new(), + "| Day | Part 1 | Part 2 |".into(), + "| :---: | :---: | :---: |".into(), + ]; + + for timing in timings.data { + let path = get_path_for_bin(timing.day); + lines.push(format!( + "| [Day {}]({}) | `{}` | `{}` |", + timing.day.into_inner(), + path, + timing.part_1.unwrap_or_else(|| "-".into()), + timing.part_2.unwrap_or_else(|| "-".into()) + )); + } + + lines.push(String::new()); + lines.push(format!("**Total: {total_millis:.2}ms**")); + lines.push(MARKER.into()); + + lines.join("\n") +} + +fn update_content(s: &mut String, timings: Timings, total_millis: f64) -> Result<(), Error> { + let positions = locate_table(s)?; + let table = construct_table("##", timings, total_millis); + s.replace_range(positions.pos_start..positions.pos_end, &table); + Ok(()) +} + +pub fn update(timings: Timings) -> Result<(), Error> { + let path = "README.md"; + let mut readme = String::from_utf8_lossy(&fs::read(path)?).to_string(); + let total_millis = timings.total_millis(); + update_content(&mut readme, timings, total_millis)?; + fs::write(path, &readme)?; + Ok(()) +} + +#[cfg(feature = "test_lib")] +mod tests { + use super::{update_content, MARKER}; + use crate::{day, template::timings::Timing, template::timings::Timings}; + + fn get_mock_timings() -> Timings { + Timings { + data: vec![ + Timing { + day: day!(1), + part_1: Some("10ms".into()), + part_2: Some("20ms".into()), + total_nanos: 3e+10, + }, + Timing { + day: day!(2), + part_1: Some("30ms".into()), + part_2: Some("40ms".into()), + total_nanos: 7e+10, + }, + Timing { + day: day!(4), + part_1: Some("40ms".into()), + part_2: Some("50ms".into()), + total_nanos: 9e+10, + }, + ], + } + } + + #[test] + #[should_panic] + fn errors_if_marker_not_present() { + let mut s = "# readme".to_string(); + update_content(&mut s, get_mock_timings(), 190.0).unwrap(); + } + + #[test] + #[should_panic] + fn errors_if_too_many_markers_present() { + let mut s = format!("{} {} {}", MARKER, MARKER, MARKER); + update_content(&mut s, get_mock_timings(), 190.0).unwrap(); + } + + #[test] + fn updates_empty_benchmarks() { + let mut s = format!("foo\nbar\n{}{}\nbaz", MARKER, MARKER); + update_content(&mut s, get_mock_timings(), 190.0).unwrap(); + assert_eq!(s.contains("## Benchmarks"), true); + } + + #[test] + fn updates_existing_benchmarks() { + let mut s = format!("foo\nbar\n{}{}\nbaz", MARKER, MARKER); + update_content(&mut s, get_mock_timings(), 190.0).unwrap(); + update_content(&mut s, get_mock_timings(), 190.0).unwrap(); + assert_eq!(s.matches(MARKER).collect::>().len(), 2); + assert_eq!(s.matches("## Benchmarks").collect::>().len(), 1); + } + + #[test] + fn format_benchmarks() { + let mut s = format!("foo\nbar\n{}\n{}\nbaz", MARKER, MARKER); + update_content(&mut s, get_mock_timings(), 190.0).unwrap(); + let expected = [ + "foo", + "bar", + "", + "## Benchmarks", + "", + "| Day | Part 1 | Part 2 |", + "| :---: | :---: | :---: |", + "| [Day 1](./src/bin/01.rs) | `10ms` | `20ms` |", + "| [Day 2](./src/bin/02.rs) | `30ms` | `40ms` |", + "| [Day 4](./src/bin/04.rs) | `40ms` | `50ms` |", + "", + "**Total: 190.00ms**", + "", + "baz", + ] + .join("\n"); + assert_eq!(s, expected); + } +} diff --git a/src/template/run_multi.rs b/src/template/run_multi.rs new file mode 100644 index 0000000..c951faa --- /dev/null +++ b/src/template/run_multi.rs @@ -0,0 +1,257 @@ +use std::{collections::HashSet, io}; + +use crate::template::{Day, ANSI_BOLD, ANSI_ITALIC, ANSI_RESET}; + +use super::{ + all_days, + timings::{Timing, Timings}, +}; + +pub fn run_multi(days_to_run: &HashSet, is_release: bool, is_timed: bool) -> Option { + let mut timings: Vec = Vec::with_capacity(days_to_run.len()); + + let mut need_space = false; + + // NOTE: use non-duplicate, sorted day values. + all_days() + .filter(|day| days_to_run.contains(day)) + .for_each(|day| { + if need_space { + println!(); + } + need_space = true; + + println!("{ANSI_BOLD}Day {day}{ANSI_RESET}"); + println!("------"); + + let output = child_commands::run_solution(day, is_timed, is_release).unwrap(); + + if output.is_empty() { + println!("Not solved."); + } else { + let val = child_commands::parse_exec_time(&output, day); + timings.push(val); + } + }); + + if is_timed { + let timings = Timings { data: timings }; + let total_millis = timings.total_millis(); + println!( + "\n{ANSI_BOLD}Total (Run):{ANSI_RESET} {ANSI_ITALIC}{total_millis:.2}ms{ANSI_RESET}" + ); + Some(timings) + } else { + None + } +} + +#[allow(dead_code)] +#[derive(Debug)] +pub enum Error { + BrokenPipe, + IO(io::Error), +} + +impl From for Error { + fn from(e: std::io::Error) -> Self { + Error::IO(e) + } +} + +#[must_use] +pub fn get_path_for_bin(day: Day) -> String { + format!("./src/bin/{day}.rs") +} + +/// All solutions live in isolated binaries. +/// This module encapsulates interaction with these binaries, both invoking them as well as parsing the timing output. +pub mod child_commands { + use super::{get_path_for_bin, Error}; + use crate::template::Day; + use std::{ + io::{BufRead, BufReader}, + path::Path, + process::{Command, Stdio}, + thread, + }; + + /// Run the solution bin for a given day + pub fn run_solution(day: Day, is_timed: bool, is_release: bool) -> Result, Error> { + // skip command invocation for days that have not been scaffolded yet. + if !Path::new(&get_path_for_bin(day)).exists() { + return Ok(vec![]); + } + + let day_padded = day.to_string(); + let mut args = vec!["run", "--quiet", "--bin", &day_padded]; + + if is_release { + args.push("--release"); + } + + if is_timed { + // mirror `--time` flag to child invocations. + args.push("--"); + args.push("--time"); + } + + // spawn child command with piped stdout/stderr. + // forward output to stdout/stderr while grabbing stdout lines. + + let mut cmd = Command::new("cargo") + .args(&args) + .stdout(Stdio::piped()) + .stderr(Stdio::piped()) + .spawn()?; + + let stdout = BufReader::new(cmd.stdout.take().ok_or(super::Error::BrokenPipe)?); + let stderr = BufReader::new(cmd.stderr.take().ok_or(super::Error::BrokenPipe)?); + + let mut output = vec![]; + + let thread = thread::spawn(move || { + stderr.lines().for_each(|line| { + eprintln!("{}", line.unwrap()); + }); + }); + + for line in stdout.lines() { + let line = line.unwrap(); + println!("{line}"); + output.push(line); + } + + thread.join().unwrap(); + cmd.wait()?; + + Ok(output) + } + + pub fn parse_exec_time(output: &[String], day: Day) -> super::Timing { + let mut timings = super::Timing { + day, + part_1: None, + part_2: None, + total_nanos: 0_f64, + }; + + output + .iter() + .filter_map(|l| { + if !l.contains(" samples)") { + return None; + } + + let Some((timing_str, nanos)) = parse_time(l) else { + eprintln!("Could not parse timings from line: {l}"); + return None; + }; + + let part = l.split(':').next()?; + Some((part, timing_str, nanos)) + }) + .for_each(|(part, timing_str, nanos)| { + if part.contains("Part 1") { + timings.part_1 = Some(timing_str.into()); + } else if part.contains("Part 2") { + timings.part_2 = Some(timing_str.into()); + } + + timings.total_nanos += nanos; + }); + + timings + } + + fn parse_to_float(s: &str, postfix: &str) -> Option { + s.split(postfix).next()?.parse().ok() + } + + fn parse_time(line: &str) -> Option<(&str, f64)> { + // for possible time formats, see: https://github.com/rust-lang/rust/blob/1.64.0/library/core/src/time.rs#L1176-L1200 + let str_timing = line + .split(" samples)") + .next()? + .split('(') + .last()? + .split('@') + .next()? + .trim(); + + let parsed_timing = match str_timing { + s if s.contains("ns") => s.split("ns").next()?.parse::().ok(), + s if s.contains("ยตs") => parse_to_float(s, "ยตs").map(|x| x * 1000_f64), + s if s.contains("ms") => parse_to_float(s, "ms").map(|x| x * 1_000_000_f64), + s => parse_to_float(s, "s").map(|x| x * 1_000_000_000_f64), + }?; + + Some((str_timing, parsed_timing)) + } + + /// copied from: https://github.com/rust-lang/rust/blob/1.64.0/library/std/src/macros.rs#L328-L333 + #[cfg(feature = "test_lib")] + macro_rules! assert_approx_eq { + ($a:expr, $b:expr) => {{ + let (a, b) = (&$a, &$b); + assert!( + (*a - *b).abs() < 1.0e-6, + "{} is not approximately equal to {}", + *a, + *b + ); + }}; + } + + #[cfg(feature = "test_lib")] + mod tests { + use super::parse_exec_time; + + use crate::day; + + #[test] + fn parses_execution_times() { + let res = parse_exec_time( + &[ + "Part 1: 0 (74.13ns @ 100000 samples)".into(), + "Part 2: 10 (74.13ms @ 99999 samples)".into(), + "".into(), + ], + day!(1), + ); + assert_approx_eq!(res.total_nanos, 74130074.13_f64); + assert_eq!(res.part_1.unwrap(), "74.13ns"); + assert_eq!(res.part_2.unwrap(), "74.13ms"); + } + + #[test] + fn parses_with_patterns_in_input() { + let res = parse_exec_time( + &[ + "Part 1: @ @ @ ( ) ms (2s @ 5 samples)".into(), + "Part 2: 10s (100ms @ 1 samples)".into(), + "".into(), + ], + day!(1), + ); + assert_approx_eq!(res.total_nanos, 2100000000_f64); + assert_eq!(res.part_1.unwrap(), "2s"); + assert_eq!(res.part_2.unwrap(), "100ms"); + } + + #[test] + fn parses_missing_parts() { + let res = parse_exec_time( + &[ + "Part 1: โœ– ".into(), + "Part 2: โœ– ".into(), + "".into(), + ], + day!(1), + ); + assert_approx_eq!(res.total_nanos, 0_f64); + assert_eq!(res.part_1.is_none(), true); + assert_eq!(res.part_2.is_none(), true); + } + } +} diff --git a/src/template/runner.rs b/src/template/runner.rs new file mode 100644 index 0000000..0a48767 --- /dev/null +++ b/src/template/runner.rs @@ -0,0 +1,169 @@ +/// Encapsulates code that interacts with solution functions. +use std::fmt::Display; +use std::hint::black_box; +use std::io::{stdout, Write}; +use std::process::Output; +use std::time::{Duration, Instant}; +use std::{cmp, env, process}; + +use crate::template::ANSI_BOLD; +use crate::template::{aoc_cli, Day, ANSI_ITALIC, ANSI_RESET}; + +pub fn run_part(func: impl Fn(I) -> Option, input: I, day: Day, part: u8) { + let part_str = format!("Part {part}"); + + let (result, duration, samples) = + run_timed(func, input, |result| print_result(result, &part_str, "")); + + print_result(&result, &part_str, &format_duration(&duration, samples)); + + if let Some(result) = result { + submit_result(result, day, part); + } +} + +/// Run a solution part. The behavior differs depending on whether we are running a release or debug build: +/// 1. in debug, the function is executed once. +/// 2. in release, the function is benched (approx. 1 second of execution time or 10 samples, whatever take longer.) +fn run_timed( + func: impl Fn(I) -> T, + input: I, + hook: impl Fn(&T), +) -> (T, Duration, u128) { + let timer = Instant::now(); + let result = { + let input = input.clone(); + + #[cfg(feature = "dhat-heap")] + let _profiler = dhat::Profiler::new_heap(); + + func(input) + }; + let base_time = timer.elapsed(); + + hook(&result); + + let run = if std::env::args().any(|x| x == "--time") { + bench(func, input, &base_time) + } else { + (base_time, 1) + }; + + (result, run.0, run.1) +} + +fn bench(func: impl Fn(I) -> T, input: I, base_time: &Duration) -> (Duration, u128) { + let mut stdout = stdout(); + + print!(" > {ANSI_ITALIC}benching{ANSI_RESET}"); + let _ = stdout.flush(); + + let bench_iterations = + (Duration::from_secs(1).as_nanos() / cmp::max(base_time.as_nanos(), 10)).clamp(10, 10000); + + let mut timers: Vec = vec![]; + + for _ in 0..bench_iterations { + // need a clone here to make the borrow checker happy. + let cloned = input.clone(); + let timer = Instant::now(); + black_box(func(black_box(cloned))); + timers.push(timer.elapsed()); + } + + ( + #[allow(clippy::cast_possible_truncation)] + Duration::from_nanos(average_duration(&timers) as u64), + bench_iterations, + ) +} + +fn average_duration(numbers: &[Duration]) -> u128 { + numbers + .iter() + .map(std::time::Duration::as_nanos) + .sum::() + / numbers.len() as u128 +} + +fn format_duration(duration: &Duration, samples: u128) -> String { + if samples == 1 { + format!(" ({duration:.1?})") + } else { + format!(" ({duration:.1?} @ {samples} samples)") + } +} + +fn print_result(result: &Option, part: &str, duration_str: &str) { + let is_intermediate_result = duration_str.is_empty(); + + match result { + Some(result) => { + if result.to_string().contains('\n') { + let str = format!("{part}: โ–ผ {duration_str}"); + if is_intermediate_result { + print!("{str}"); + } else { + print!("\r"); + println!("{str}"); + println!("{result}"); + } + } else { + let str = format!("{part}: {ANSI_BOLD}{result}{ANSI_RESET}{duration_str}"); + if is_intermediate_result { + print!("{str}"); + } else { + print!("\r"); + println!("{str}"); + } + } + } + None => { + if is_intermediate_result { + print!("{part}: โœ–"); + } else { + print!("\r"); + println!("{part}: โœ– "); + } + } + } +} + +/// Parse the arguments passed to `solve` and try to submit one part of the solution if: +/// 1. we are in `--release` mode. +/// 2. aoc-cli is installed. +fn submit_result( + result: T, + day: Day, + part: u8, +) -> Option> { + let args: Vec = env::args().collect(); + + if !args.contains(&"--submit".into()) { + return None; + } + + if args.len() < 3 { + eprintln!("Unexpected command-line input. Format: cargo solve 1 --submit 1"); + process::exit(1); + } + + let part_index = args.iter().position(|x| x == "--submit").unwrap() + 1; + + let Ok(part_submit) = args[part_index].parse::() else { + eprintln!("Unexpected command-line input. Format: cargo solve 1 --submit 1"); + process::exit(1); + }; + + if part_submit != part { + return None; + } + + if aoc_cli::check().is_err() { + eprintln!("command \"aoc\" not found or not callable. Try running \"cargo install aoc-cli\" to install it."); + process::exit(1); + } + + println!("Submitting result via aoc-cli..."); + Some(aoc_cli::submit(day, part, &result.to_string())) +} diff --git a/src/template/timings.rs b/src/template/timings.rs new file mode 100644 index 0000000..194464e --- /dev/null +++ b/src/template/timings.rs @@ -0,0 +1,391 @@ +use std::{collections::HashMap, fs, io::Error, str::FromStr}; +use tinyjson::JsonValue; + +use crate::template::Day; + +static TIMINGS_FILE_PATH: &str = "./data/timings.json"; + +/// Represents benchmark times for a single day. +#[derive(Clone, Debug)] +pub struct Timing { + pub day: Day, + pub part_1: Option, + pub part_2: Option, + pub total_nanos: f64, +} + +/// Represents benchmark times for a set of days. +/// Can be serialized from / to JSON. +#[derive(Clone, Debug, Default)] +pub struct Timings { + pub data: Vec, +} + +impl Timings { + /// Dehydrate timings to a JSON file. + pub fn store_file(&self) -> Result<(), Error> { + let json = JsonValue::from(self.clone()); + let mut file = fs::File::create(TIMINGS_FILE_PATH)?; + json.format_to(&mut file) + } + + /// Rehydrate timings from a JSON file. If not present, returns empty timings. + pub fn read_from_file() -> Self { + let s = fs::read_to_string(TIMINGS_FILE_PATH) + .map_err(|x| x.to_string()) + .and_then(Timings::try_from); + + match s { + Ok(timings) => timings, + Err(e) => { + eprintln!("{e}"); + Timings::default() + } + } + } + + /// Merge two sets of timings, overwriting `self` with `other` if present. + pub fn merge(&self, new: &Self) -> Self { + let mut data: Vec = vec![]; + + for timing in &new.data { + data.push(timing.clone()); + } + + for timing in &self.data { + if !data.iter().any(|t| t.day == timing.day) { + data.push(timing.clone()); + } + } + + data.sort_unstable_by(|a, b| a.day.cmp(&b.day)); + Timings { data } + } + + /// Sum up total duration of timings as millis. + pub fn total_millis(&self) -> f64 { + self.data.iter().map(|x| x.total_nanos).sum::() / 1_000_000_f64 + } + + pub fn is_day_complete(&self, day: Day) -> bool { + self.data + .iter() + .any(|t| t.day == day && t.part_1.is_some() && t.part_2.is_some()) + } +} + +/* -------------------------------------------------------------------------- */ + +impl From for JsonValue { + fn from(value: Timings) -> Self { + let mut map: HashMap = HashMap::new(); + + map.insert( + "data".into(), + JsonValue::Array(value.data.iter().map(JsonValue::from).collect()), + ); + + JsonValue::Object(map) + } +} + +impl TryFrom for Timings { + type Error = String; + + fn try_from(value: String) -> Result { + let json = JsonValue::from_str(&value).or(Err("not valid JSON file."))?; + + let json_data = json + .get::>() + .ok_or("expected JSON document to be an object.")? + .get("data") + .ok_or("expected JSON document to have key `data`.")? + .get::>() + .ok_or("expected `json.data` to be an array.")?; + + Ok(Timings { + data: json_data + .iter() + .map(Timing::try_from) + .collect::>()?, + }) + } +} + +/* -------------------------------------------------------------------------- */ + +impl From<&Timing> for JsonValue { + fn from(value: &Timing) -> Self { + let mut map: HashMap = HashMap::new(); + + map.insert("day".into(), JsonValue::String(value.day.to_string())); + map.insert("total_nanos".into(), JsonValue::Number(value.total_nanos)); + + let part_1 = value.part_1.clone().map(JsonValue::String); + let part_2 = value.part_2.clone().map(JsonValue::String); + + map.insert( + "part_1".into(), + match part_1 { + Some(x) => x, + None => JsonValue::Null, + }, + ); + + map.insert( + "part_2".into(), + match part_2 { + Some(x) => x, + None => JsonValue::Null, + }, + ); + + JsonValue::Object(map) + } +} + +impl TryFrom<&JsonValue> for Timing { + type Error = String; + + fn try_from(value: &JsonValue) -> Result { + let json = value + .get::>() + .ok_or("Expected timing to be a JSON object.")?; + + let day = json + .get("day") + .and_then(|v| v.get::()) + .and_then(|day| Day::from_str(day).ok()) + .ok_or("Expected timing.day to be a Day struct.")?; + + let part_1 = json + .get("part_1") + .map(|v| if v.is_null() { None } else { v.get::() }) + .ok_or("Expected timing.part_1 to be null or string.")?; + + let part_2 = json + .get("part_2") + .map(|v| if v.is_null() { None } else { v.get::() }) + .ok_or("Expected timing.part_2 to be null or string.")?; + + let total_nanos = json + .get("total_nanos") + .and_then(|v| v.get::().copied()) + .ok_or("Expected timing.total_nanos to be a number.")?; + + Ok(Timing { + day, + part_1: part_1.cloned(), + part_2: part_2.cloned(), + total_nanos, + }) + } +} + +/* -------------------------------------------------------------------------- */ + +#[cfg(feature = "test_lib")] +mod tests { + use crate::day; + + use super::{Timing, Timings}; + + fn get_mock_timings() -> Timings { + Timings { + data: vec![ + Timing { + day: day!(1), + part_1: Some("10ms".into()), + part_2: Some("20ms".into()), + total_nanos: 3e+10, + }, + Timing { + day: day!(2), + part_1: Some("30ms".into()), + part_2: Some("40ms".into()), + total_nanos: 7e+10, + }, + Timing { + day: day!(4), + part_1: Some("40ms".into()), + part_2: None, + total_nanos: 4e+10, + }, + ], + } + } + + mod deserialization { + use crate::{day, template::timings::Timings}; + + #[test] + fn handles_json_timings() { + let json = r#"{ "data": [{ "day": "01", "part_1": "1ms", "part_2": null, "total_nanos": 1000000000 }] }"#.to_string(); + let timings = Timings::try_from(json).unwrap(); + assert_eq!(timings.data.len(), 1); + let timing = timings.data.first().unwrap(); + assert_eq!(timing.day, day!(1)); + assert_eq!(timing.part_1, Some("1ms".to_string())); + assert_eq!(timing.part_2, None); + assert_eq!(timing.total_nanos, 1_000_000_000_f64); + } + + #[test] + fn handles_empty_timings() { + let json = r#"{ "data": [] }"#.to_string(); + let timings = Timings::try_from(json).unwrap(); + assert_eq!(timings.data.len(), 0); + } + + #[test] + #[should_panic] + fn panics_for_invalid_json() { + let json = r#"{}"#.to_string(); + Timings::try_from(json).unwrap(); + } + + #[test] + #[should_panic] + fn panics_for_malformed_timings() { + let json = r#"{ "data": [{ "day": "01" }, { "day": "26" }, { "day": "02", "part_2": null, "total_nanos": 0 }] }"#.to_string(); + Timings::try_from(json).unwrap(); + } + } + + mod serialization { + use super::get_mock_timings; + use std::collections::HashMap; + use tinyjson::JsonValue; + + #[test] + fn serializes_timings() { + let timings = get_mock_timings(); + let value = JsonValue::try_from(timings).unwrap(); + assert_eq!( + value + .get::>() + .unwrap() + .get("data") + .unwrap() + .get::>() + .unwrap() + .len(), + 3 + ); + } + } + + mod is_day_complete { + use crate::{ + day, + template::timings::{Timing, Timings}, + }; + + #[test] + fn handles_completed_days() { + let timings = Timings { + data: vec![Timing { + day: day!(1), + part_1: Some("1ms".into()), + part_2: Some("2ms".into()), + total_nanos: 3_000_000_000_f64, + }], + }; + + assert_eq!(timings.is_day_complete(&day!(1)), true); + } + + #[test] + fn handles_partial_days() { + let timings = Timings { + data: vec![Timing { + day: day!(1), + part_1: Some("1ms".into()), + part_2: None, + total_nanos: 1_000_000_000_f64, + }], + }; + + assert_eq!(timings.is_day_complete(&day!(1)), false); + } + + #[test] + fn handles_uncompleted_days() { + let timings = Timings { + data: vec![Timing { + day: day!(1), + part_1: None, + part_2: None, + total_nanos: 0.0, + }], + }; + + assert_eq!(timings.is_day_complete(&day!(1)), false); + } + } + + mod merge { + use crate::{ + day, + template::timings::{Timing, Timings}, + }; + + use super::get_mock_timings; + + #[test] + fn handles_disjunct_timings() { + let timings = get_mock_timings(); + let other = Timings { + data: vec![Timing { + day: day!(3), + part_1: None, + part_2: None, + total_nanos: 0_f64, + }], + }; + let merged = timings.merge(&other); + assert_eq!(merged.data.len(), 4); + assert_eq!(merged.data[0].day, day!(1)); + assert_eq!(merged.data[1].day, day!(2)); + assert_eq!(merged.data[2].day, day!(3)); + assert_eq!(merged.data[3].day, day!(4)); + } + + #[test] + fn handles_overlapping_timings() { + let timings = get_mock_timings(); + + let other = Timings { + data: vec![Timing { + day: day!(2), + part_1: None, + part_2: None, + total_nanos: 0_f64, + }], + }; + let merged = timings.merge(&other); + + assert_eq!(merged.data.len(), 3); + assert_eq!(merged.data[0].day, day!(1)); + assert_eq!(merged.data[1].day, day!(2)); + assert_eq!(merged.data[1].total_nanos, 0_f64); + assert_eq!(merged.data[2].day, day!(4)); + } + + #[test] + fn handles_empty_timings() { + let timings = Timings::default(); + let other = get_mock_timings(); + let merged = timings.merge(&other); + assert_eq!(merged.data.len(), 3); + } + + #[test] + fn handles_empty_other_timings() { + let timings = get_mock_timings(); + let other = Timings::default(); + let merged = timings.merge(&other); + assert_eq!(merged.data.len(), 3); + } + } +}