RustForge Wiki Home

RustForge Wiki

Welcome to the RustForge wiki! RustForge is a modular, easily adoptable Rust test-suite template designed to scale seamlessly from basic cargo test workflows to compiler-style coverage.

---

Table of Contents

1. Overview & Philosophy
2. Workspace Layout
3. Quickstart Guide
4. Module Responsibilities
5. Feature Flags & Opt-In Tooling
6. Minimum Supported Rust Version (MSRV)
7. Tooling, Automation & CI Pipeline
8. Coverage, Reporting & Debugging
9. Adoption Roadmap

---

Overview & Philosophy

Most Rust projects eventually build their own custom test infrastructure—stitching together cargo test, Criterion, proptest, cargo-fuzz, trybuild, insta, cargo-llvm-cov, and CI wiring to run everything consistently.

RustForge provides that infrastructure ready-built, wired into CI, and verified to work end-to-end.

Core Differentiators

• Truly Modular: Seven independent category crates (syntax-tests, semantic-tests, performance-tests, fuzz-tests, integration-tests, edge-cases, and shared core-tests). Adopt only what you need. cargo test --workspace pulls in zero extra dependencies by default.
• Comprehensive by Design: Covers syntax/compile-fail tests, semantic/ownership correctness, Criterion benchmarks with regression guards, fuzzing, snapshot testing, boundary checks, and cross-category integration tests.
• Production-Grade CI: Multi-toolchain, multi-OS CI pipeline with a verified MSRV job, cargo-deny supply-chain checks, Dependabot, and enforced missing documentation warnings (#![warn(missing_docs)]).
• No Lock-in: Use it as a GitHub template repository, copy crates/ into an existing workspace, or take individual crates.

---

Workspace Layout

my-test-suite/
├── Cargo.toml
├── crates/
│   ├── core-tests/
│   ├── syntax-tests/
│   ├── semantic-tests/
│   ├── performance-tests/
│   ├── fuzz-tests/
│   ├── integration-tests/
│   └── edge-cases/
├── examples/
├── fuzz/
├── ci/
├── scripts/
└── docs/