Skip to content

v0.1.0-alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@rwilliamspbg-ops rwilliamspbg-ops released this 28 Jul 18:13
· 11 commits to main since this release
v0.1.0-alpha
31877eb

RustForge v0.1.0-alpha

First tagged release of RustForge — a modular, adoptable Rust test-suite template that scales from basic cargo test workflows to compiler-style coverage.

⚠️ Alpha

The structure, feature flags, and CI pipeline described below are all exercised and verified — every claim in the docs was checked by actually running it, not just written (see the CHANGELOG and each phase's PR for specifics). But this is the first time it's all shipped together as a tagged unit, so treat it as alpha: expect some rough edges from real-world adoption that internal verification can't fully surface. Feedback and issues are very welcome.

What's in this release

  • Seven independent category crates (core-tests, syntax-tests, semantic-tests, performance-tests, fuzz-tests, integration-tests, edge-cases) — adopt only what you need. cargo test --workspace pulls in zero extra dependencies by default.
  • Real advanced tooling, all wired into CI: Criterion benchmarks with regression guards and statistical baseline comparison, proptest property tests, real cargo-fuzz targets with a seed corpus, trybuild compile-fail tests, and insta snapshot tests.
  • An 8-job CI pipeline: fmt + clippy + tests across a stable/beta/nightly × ubuntu/windows/macos matrix, a dedicated MSRV job, cargo-deny supply-chain checks, Dependabot, cargo-nextest, coverage reporting, and a docs-lint job.
  • Documentation: architecture diagrams, a testing best-practices guide, per-test-shape how-tos, an advanced fuzzing guide, a performance-regression-testing guide, and an adoption guide with pitfalls found by actually testing the "copy into an existing workspace" flow.
  • Dual-licensed under MIT OR Apache-2.0.

See the full CHANGELOG for everything included, and docs/architecture.md for how it all fits together.

Getting started

  • New project: click "Use this template" on the repo page.
  • Existing workspace: copy Cargo.toml + crates/ in — see the Quickstart in the README for the one real gotcha (your workspace needs its own [workspace.package] table).
  • Just want to look around: cargo test --workspace after cloning.

Full Changelog

https://github.com/rwilliamspbg-ops/RustForge/blob/main/CHANGELOG.md#010-alpha---2026-07-28

Assets 2
Loading