qubit-fs-testkit 0.7.0

Reusable provider contract checks for qubit-fs implementations
Documentation
// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Typed preparation evidence supplied by an isolated provider fixture.

/// Separates a prepared request from applicability and missing instrumentation.
///
/// Preparation failures use `FixtureResult::Err`. A fixture cannot turn a
/// backend error into an inapplicability declaration. The suite validates
/// declarations against the provider's capability guarantees.
///
/// # Examples
///
/// ```
/// use qubit_fs_testkit::FixturePreparation;
///
/// let ready = FixturePreparation::Ready("payload");
/// assert!(matches!(ready, FixturePreparation::Ready(_)));
/// ```
#[must_use]
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum FixturePreparation<T> {
    /// The request and independent initial state are ready to exercise.
    Ready(T),
    /// The scenario does not exist in this provider configuration.
    NotApplicable {
        /// Concrete provider restriction that excludes this scenario.
        reason: String,
    },
    /// The scenario applies, but fixture evidence is unavailable.
    Unavailable {
        /// The missing setup or observation needed to perform the check.
        reason: String,
    },
}