From 0c7692bc345b5a5a37364fd905c21699a00df660 Mon Sep 17 00:00:00 2001 From: Rico Hageman Date: Sat, 2 Dec 2023 14:20:23 +0000 Subject: [PATCH] Initial commit --- .assets/banner.png | Bin 0 -> 62797 bytes .assets/christmas_ferris.png | Bin 0 -> 72131 bytes .cargo/config.toml | 11 ++ .devcontainer/devcontainer.json | 6 + .editorconfig | 17 ++ .github/workflows/ci.yml | 33 ++++ .github/workflows/readme-stars.yml | 24 +++ .gitignore | 23 +++ .vscode/extensions.json | 7 + .vscode/launch.json | 50 ++++++ Cargo.lock | 16 ++ Cargo.toml | 17 ++ LICENSE | 21 +++ README.md | 231 ++++++++++++++++++++++++++ data/examples/.keep | 0 data/inputs/.keep | 0 data/puzzles/.keep | 0 src/bin/.keep | 0 src/day.rs | 172 +++++++++++++++++++ src/lib.rs | 4 + src/main.rs | 92 +++++++++++ src/template/aoc_cli.rs | 127 +++++++++++++++ src/template/commands/all.rs | 254 +++++++++++++++++++++++++++++ src/template/commands/download.rs | 15 ++ src/template/commands/mod.rs | 5 + src/template/commands/read.rs | 16 ++ src/template/commands/scaffold.rs | 94 +++++++++++ src/template/commands/solve.rs | 31 ++++ src/template/mod.rs | 48 ++++++ src/template/readme_benchmarks.rs | 186 +++++++++++++++++++++ src/template/runner.rs | 167 +++++++++++++++++++ 31 files changed, 1667 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/day.rs create mode 100644 src/lib.rs create mode 100644 src/main.rs 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/mod.rs create mode 100644 src/template/readme_benchmarks.rs create mode 100644 src/template/runner.rs diff --git a/.assets/banner.png b/.assets/banner.png new file mode 100644 index 0000000000000000000000000000000000000000..36ca006022196bb1e3d5a3e9f0c29a2c317005be GIT binary patch literal 62797 zcmeEtg;!L6_~sA-BB2t}pdgJ%cPIi5T||xi?{9bihdrx@!##7jpZngop68AEprxTqN=!!#0)a@uFJI_@K(~NP+z=uH;Mb3X zu^bQxC(K?!K?|&)z~biNYHROg0|Ifz2gb|1{2|ZKX`x$?OGPO3UfjA^gZhOcLmjbV z@m+^-eMYq>mv7l4*g8A4-T1^$stvu}+{eehLGI$q$^ZESr!>p|dHpz?T7Ze+cxkq^ zdsa%m*x<8^Z!}KRqT#yr^S)L6{2rd%_wp~uUlZ317#V3ibPJee{W;Mrjv|&lMz4+S zi{d@M|Bpn7FVZj5&tXJBVwd7$dH$Q9=%0DiW}i;tH%n2j@Q+M)q;+cr*Ck%Z8*
  • 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

    XB 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 z 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≧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

  • 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 literal 0 HcmV?d00001 diff --git a/.cargo/config.toml b/.cargo/config.toml new file mode 100644 index 0000000..3530669 --- /dev/null +++ b/.cargo/config.toml @@ -0,0 +1,11 @@ +[alias] +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 -- all --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..9eef218 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,33 @@ +name: Continuous Integration + +on: push + +env: + CARGO_TERM_COLOR: always + +jobs: + test: + runs-on: ubuntu-latest + name: CI + steps: + - uses: actions/checkout@v3 + - name: Set up cargo cache + uses: actions/cache@v3 + 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..e3b4aa2 --- /dev/null +++ b/.gitignore @@ -0,0 +1,23 @@ +# 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 diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..2475a54 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,7 @@ +{ + "recommendations": [ + "vadimcn.vscode-lldb", + "rust-lang.rust-analyzer", + "serayuzgur.crates" + ] +} \ No newline at end of file diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..0a9370e --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,50 @@ +{ + // 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 in executable 'advent_of_code'", + "cargo": { + "args": ["test", "--no-run", "--bin=advent_of_code", "--package=advent_of_code"], + "filter": { + "name": "advent_of_code", + "kind": "bin" + } + }, + "args": [], + "cwd": "${workspaceFolder}" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug executable 'advent_of_code'", + "cargo": { + "args": ["build", "--bin=advent_of_code", "--package=advent_of_code"], + "filter": { + "name": "advent_of_code", + "kind": "bin" + } + }, + "args": ["1"], + "cwd": "${workspaceFolder}" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug unit tests in library 'advent_of_code'", + "cargo": { + "args": ["test", "--no-run", "--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..ea86ba4 --- /dev/null +++ b/Cargo.lock @@ -0,0 +1,16 @@ +# This file is automatically @generated by Cargo. +# It is not intended for manual editing. +version = 3 + +[[package]] +name = "advent_of_code" +version = "0.9.3" +dependencies = [ + "pico-args", +] + +[[package]] +name = "pico-args" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315" diff --git a/Cargo.toml b/Cargo.toml new file mode 100644 index 0000000..692fc58 --- /dev/null +++ b/Cargo.toml @@ -0,0 +1,17 @@ +[package] +name = "advent_of_code" +version = "0.9.3" +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 + +[features] +test_lib = [] + +[dependencies] +pico-args = "0.5.0" 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..85aba56 --- /dev/null +++ b/README.md @@ -0,0 +1,231 @@ + + +# πŸŽ„ 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/commands/scaffold.rs#L9-L35) has _tests_ referencing its _example_ file in `./data/examples`. Use these tests to develop and debug your solutions against the example input. + +> [!TIP] +> If a day has different example inputs for both parts, you can use the `read_file_part()` helper in your tests instead of `read_file()`. For example, if this 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));` to read it in `test_part_two`. + +> [!TIP] +> when editing a solution, `rust-analyzer` will display buttons for running / debugging unit tests above the unit test blocks. + +### Download input & description for a day + +> [!IMPORTANT] +> This command requires [installing the aoc-cli crate](#configure-aoc-cli-integration). + +```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. + +By default, `solve` executes your code once and shows the execution time. If you append the `--time` flag to the command, 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. + +For example, running a benchmarked, optimized execution of day 1 would look like `cargo solve 1 --release --time`. Displayed _timings_ show the raw execution time of your solution without overhead like file reads. + +#### Submitting solutions + +> [!IMPORTANT] +> This command requires [installing the aoc-cli crate](#configure-aoc-cli-integration). + +In order to submit part of a solution for checking, append the `--submit ` option to the `solve` command. + +### 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. + +#### Update readme benchmarks + +The template can output a table with solution times to your readme. In order to generate a benchmarking table, run `cargo all --release --time`. If everything goes well, the command will output "_Successfully updated README with benchmarks._" after the execution finishes and the readme will be updated. + +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`. + +### Format code + +```sh +cargo fmt +``` + +### Lint code + +```sh +cargo clippy +``` + +### Read puzzle description in terminal + +> [!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... +``` + +## 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 an `.adventofcode.session` file in your home directory and paste your session cookie. 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. + +### Check code formatting / clippy lints in CI + +Uncomment the respective sections in the `ci.yml` workflow. + +### 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/day.rs b/src/day.rs new file mode 100644 index 0000000..5148797 --- /dev/null +++ b/src/day.rs @@ -0,0 +1,172 @@ +use std::error::Error; +use std::fmt::Display; +use std::str::FromStr; + +/// 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 + } +} + +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::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/lib.rs b/src/lib.rs new file mode 100644 index 0000000..04f64f0 --- /dev/null +++ b/src/lib.rs @@ -0,0 +1,4 @@ +mod day; +pub mod template; + +pub use day::*; diff --git a/src/main.rs b/src/main.rs new file mode 100644 index 0000000..23ba03c --- /dev/null +++ b/src/main.rs @@ -0,0 +1,92 @@ +use advent_of_code::template::commands::{all, download, read, scaffold, solve}; +use args::{parse, AppArguments}; + +mod args { + use std::process; + + use advent_of_code::Day; + + pub enum AppArguments { + Download { + day: Day, + }, + Read { + day: Day, + }, + Scaffold { + day: Day, + }, + Solve { + day: Day, + release: bool, + time: bool, + submit: Option, + }, + All { + release: bool, + time: bool, + }, + } + + 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"), + time: args.contains("--time"), + }, + 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()?, + }, + Some("solve") => AppArguments::Solve { + day: args.free_from_str()?, + release: args.contains("--release"), + submit: args.opt_value_from_str("--submit")?, + time: args.contains("--time"), + }, + 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, time } => all::handle(release, time), + AppArguments::Download { day } => download::handle(day), + AppArguments::Read { day } => read::handle(day), + AppArguments::Scaffold { day } => scaffold::handle(day), + AppArguments::Solve { + day, + release, + time, + submit, + } => solve::handle(day, release, time, submit), + }, + }; +} diff --git a/src/template/aoc_cli.rs b/src/template/aoc_cli.rs new file mode 100644 index 0000000..e7aab8b --- /dev/null +++ b/src/template/aoc_cli.rs @@ -0,0 +1,127 @@ +/// Wrapper module around the "aoc-cli" command-line. +use std::{ + fmt::Display, + process::{Command, Output, Stdio}, +}; + +use crate::Day; + +#[derive(Debug)] +pub enum AocCommandError { + CommandNotFound, + CommandNotCallable, + BadExitStatus(Output), + IoError, +} + +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.") + } + AocCommandError::IoError => write!(f, "could not write output files to file system."), + } + } +} + +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..7443322 --- /dev/null +++ b/src/template/commands/all.rs @@ -0,0 +1,254 @@ +use std::io; + +use crate::template::{ + readme_benchmarks::{self, Timings}, + ANSI_BOLD, ANSI_ITALIC, ANSI_RESET, +}; +use crate::{all_days, Day}; + +pub fn handle(is_release: bool, is_timed: bool) { + let mut timings: Vec = vec![]; + + all_days().for_each(|day| { + if day > 1 { + println!(); + } + + 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 total_millis = timings.iter().map(|x| x.total_nanos).sum::() / 1_000_000_f64; + + println!("\n{ANSI_BOLD}Total:{ANSI_RESET} {ANSI_ITALIC}{total_millis:.2}ms{ANSI_RESET}"); + + if is_release { + match readme_benchmarks::update(timings, total_millis) { + Ok(()) => println!("Successfully updated README with benchmarks."), + Err(_) => { + eprintln!("Failed to update readme with benchmarks."); + } + } + } + } +} + +#[derive(Debug)] +pub enum Error { + BrokenPipe, + Parser(String), + 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. +mod child_commands { + use super::{get_path_for_bin, Error}; + use crate::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::Timings { + let mut timings = super::Timings { + 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 test_well_formed() { + 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 test_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 test_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/commands/download.rs b/src/template/commands/download.rs new file mode 100644 index 0000000..76ad635 --- /dev/null +++ b/src/template/commands/download.rs @@ -0,0 +1,15 @@ +use crate::template::aoc_cli; +use crate::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..88f4696 --- /dev/null +++ b/src/template/commands/mod.rs @@ -0,0 +1,5 @@ +pub mod all; +pub mod download; +pub mod read; +pub mod scaffold; +pub mod solve; diff --git a/src/template/commands/read.rs b/src/template/commands/read.rs new file mode 100644 index 0000000..01316f8 --- /dev/null +++ b/src/template/commands/read.rs @@ -0,0 +1,16 @@ +use std::process; + +use crate::template::aoc_cli; +use crate::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..2a992bc --- /dev/null +++ b/src/template/commands/scaffold.rs @@ -0,0 +1,94 @@ +use std::{ + fs::{File, OpenOptions}, + io::Write, + process, +}; + +use crate::Day; + +const MODULE_TEMPLATE: &str = r#"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); + } +} +"#; + +fn safe_create_file(path: &str) -> Result { + OpenOptions::new().write(true).create_new(true).open(path) +} + +fn create_file(path: &str) -> Result { + OpenOptions::new().write(true).create(true).open(path) +} + +pub fn handle(day: Day) { + 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) { + 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 {}` to run your solution.", day); +} diff --git a/src/template/commands/solve.rs b/src/template/commands/solve.rs new file mode 100644 index 0000000..50b7000 --- /dev/null +++ b/src/template/commands/solve.rs @@ -0,0 +1,31 @@ +use std::process::{Command, Stdio}; + +use crate::Day; + +pub fn handle(day: Day, release: bool, time: bool, submit_part: Option) { + let mut cmd_args = vec!["run".to_string(), "--bin".to_string(), day.to_string()]; + + 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()); + } + + if time { + cmd_args.push("--time".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/mod.rs b/src/template/mod.rs new file mode 100644 index 0000000..d1533e1 --- /dev/null +++ b/src/template/mod.rs @@ -0,0 +1,48 @@ +use crate::Day; +use std::{env, fs}; + +pub mod aoc_cli; +pub mod commands; +pub mod readme_benchmarks; +pub mod runner; + +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. +#[macro_export] +macro_rules! solution { + ($day:expr) => { + /// The current day. + const DAY: advent_of_code::Day = advent_of_code::day!($day); + + fn main() { + use advent_of_code::template::runner::*; + let input = advent_of_code::template::read_file("inputs", DAY); + run_part(part_one, &input, DAY, 1); + run_part(part_two, &input, DAY, 2); + } + }; +} diff --git a/src/template/readme_benchmarks.rs b/src/template/readme_benchmarks.rs new file mode 100644 index 0000000..c564aa4 --- /dev/null +++ b/src/template/readme_benchmarks.rs @@ -0,0 +1,186 @@ +/// 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::Day; + +static MARKER: &str = ""; + +#[derive(Debug)] +pub enum Error { + Parser(String), + IO(io::Error), +} + +impl From for Error { + fn from(e: std::io::Error) -> Self { + Error::IO(e) + } +} + +#[derive(Clone)] +pub struct Timings { + pub day: Day, + pub part_1: Option, + pub part_2: Option, + pub total_nanos: f64, +} + +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: Vec, 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 { + 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: Vec, 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: Vec, total_millis: f64) -> Result<(), Error> { + let path = "README.md"; + let mut readme = String::from_utf8_lossy(&fs::read(path)?).to_string(); + update_content(&mut readme, timings, total_millis)?; + fs::write(path, &readme)?; + Ok(()) +} + +#[cfg(feature = "test_lib")] +mod tests { + use super::{update_content, Timings, MARKER}; + use crate::day; + + fn get_mock_timings() -> Vec { + vec![ + Timings { + day: day!(1), + part_1: Some("10ms".into()), + part_2: Some("20ms".into()), + total_nanos: 3e+10, + }, + Timings { + day: day!(2), + part_1: Some("30ms".into()), + part_2: Some("40ms".into()), + total_nanos: 7e+10, + }, + Timings { + 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/runner.rs b/src/template/runner.rs new file mode 100644 index 0000000..5e6a9b3 --- /dev/null +++ b/src/template/runner.rs @@ -0,0 +1,167 @@ +/// Encapsulates code that interacts with solution functions. +use crate::template::{aoc_cli, ANSI_ITALIC, ANSI_RESET}; +use crate::Day; +use std::fmt::Display; +use std::io::{stdout, Write}; +use std::process::Output; +use std::time::{Duration, Instant}; +use std::{cmp, env, process}; + +use super::ANSI_BOLD; + +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 = func(input.clone()); + 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 = cmp::min( + 10000, + cmp::max( + Duration::from_secs(1).as_nanos() / cmp::max(base_time.as_nanos(), 10), + 10, + ), + ); + + 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(); + func(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())) +}