rust-euler

Companion Cargo workspace for the Rust via Project Euler blog series. Each post has a matching crate under posts/ containing three progressively-better Rust solutions (beginner / medium / expert), a criterion benchmark, and a correctness test.

Reproducing a post's numbers

Every post ships with a matching immutable tag (post-01, post-02, ...). To reproduce the exact state of the workspace when Post N went live on your own hardware:

git checkout post-N
cargo bench -p post-N

Correctness is checked with the standard test harness:

cargo test -p post-N

Benchmark hardware (canonical numbers)

All committed benchmark numbers in results.json are produced on the author's laptop:

• Apple M5, 10-core, 24 GB RAM
• macOS 26.2
• rustc pinned via rust-toolchain.toml (currently 1.95.0)

CI runs on GitHub Actions (Ubuntu) and is used for correctness only — CI bench numbers are noisy and are not comparable across runs, so they are not treated as a performance baseline.

Status

Scaffolded. Post 1 content not yet written — posts/post-01-multiples-of-3-and-5 contains placeholder solutions that will be replaced when the post ships.

License

Dual-licensed under MIT OR Apache-2.0 at your option. See LICENSE-MIT and LICENSE-APACHE.