testing-rust

Rust Testing

Target: $ARGUMENTS

Writes focused, behavior-driven tests following project testing strategy.

Quick Reference

TDD methodology (language-agnostic): See tdd-core plugin (testing-tdd skill)

Rust-specific documentation: references/

• references/testing-strategy.md — Rust tools (cargo test, proptest, insta, mockall)
• references/tdd-best-practices.md — Rust TDD examples (extends tdd-core)

Quick Decision

cargo test (default): Use #[test] for known cases, #[tokio::test] for async. Works at unit/integration levels.

proptest (edge cases): Use for invariants that must hold for ALL inputs.

See references/testing-strategy.md for full methodology comparison.

TDD Essentials (Quick Reference)

Cycle: RED (failing test / compile error) -> GREEN (minimal pass) -> REFACTOR (clean up)

Structure: Arrange-Act-Assert (AAA)

#[test]
fn test_order_calculator_sums_item_prices() {
    // ARRANGE
    let items = vec![Item { price: 10, qty: 2 }, Item { price: 5, qty: 1 }];
    let calculator = OrderCalculator::new();

    // ACT
    let total = calculator.total(&items);

    // ASSERT
    assert_eq!(total, 25);
}

proptest Priorities (Edge Cases within TDD)

Priority	Area	Example
CRITICAL	Math formulas	Score always in bounds
CRITICAL	Parsers	Arbitrary input never panics
HIGH	Serialization	Round-trip encode/decode lossless
HIGH	Invariant sums	Total equals sum of parts

What to Test (KISS/DRY/YAGNI)

High-Value: Business logic, error paths, integration points, contracts

Avoid: Compiler behavior, derive implementations, trivial assertions, default values

See references/testing-strategy.md -> "Patterns to Remove" for full list.

Naming Convention

Format: test_{module}_{component}_{behavior}

test_user_service_creates_new_user()
test_order_processor_validates_items()
test_score_always_in_bounds()  // property test