• AoC website
• My AoC username: tbali0524
• Puzzle list with topics and my completion status (in Rust)
• Results and running times
• This repo on GitHub
• My AoC solutions in PHP (complete 10 seasons, 500⭐)

This repo contains my AoC solutions in Rust, and a simple CLI runner. The first 9 seasons I originally solved in PHP, and later rewrote some solutions (~3.5 seasons) in Rust. From season 2024 I solved the puzzles first in Rust (and rewrote them in PHP later).

# -- setup
# install Rust: https://www.rust-lang.org/tools/install
rustup update stable
# -- info
cargo version
cargo tree
# -- lint
cargo audit
cargo check
cargo fmt
cargo clippy
# -- doc
cargo doc --no-deps --document-private-items --open
# -- test
cargo nextest run # needs cargo plugin: <https://nexte.st/>
cargo test
cargo test 2024
cargo test 2024day01
cargo test cli
# in Powershell:
$Env:RUST_BACKTRACE=1; cargo test
cargo run
cargo run -- 2024
cargo run -- 2024 1
# -- run
cargo build --release
target/release/aoc.exe
target/release/aoc.exe 2024
target/release/aoc.exe 2024 1
cargo run --release
# -- shortcut run (Windows)
./aoc.bat
./aoc.bat 2024
./aoc.bat 2024 1
./aoc.bat --help
# -- shortcut qa+run (Windows)
./qa.ps1
# -- profiling (Windows), using [samply](https://github.com/mstange/samply/)
cargo build --profile profiling
samply record ./target/profiling/aoc.exe
# -- cleanup
cargo clean

• for puzzle year YYYY, day DD:
• add puzzle input in input/YYYY/AocYYYYDayDD.txt and example inputs in ...exX.txt
• add and edit source in src/aocYYYY/aocYYYYdayDD.rs, using the template in src/aocYYYYdayDD.rs
  • update pub fn metadata(), write solve(), add unit tests as needed
• edit src/aocYYYY.rs:
  • uncomment the pub mod aocYYYYdayDD; line
  • update the PUZZLES list: replace None with Some(...)
• for a completely new season:
  • edit src/lib.rs: add a pub mod aocYYYY; line
  • edit src/aoc.rs: increase MAX_SEASONS and add a Some(...) item to PUZZLES
  • add and update src/aocYYYY.rs using the template in src/aocYYYY.rs