Enum Scenario 

#[non_exhaustive]
pub enum Scenario {
    ValidStructured,
    MalformedJson,
    UnknownField,
    MissingField,
    MultipleActs,
    ToolCallIds,
    StreamingReconstruction,
    CachedUsage,
    EmptyOutput,
    Refusal,
    SlowResponse,
    RateLimited,
    Authentication,
    ContextOverflow,
    SecretInBody,
    Authorization,
    ModelNotFound,
    RequestTimeout,
    InvalidRequest,
    ServerError,
    ServiceUnavailable,
    ContentFilter,
    ExpiredCredential,
    QuotaExhausted,
}

One provider behaviour the suite needs a mock for.

A fixture translates a scenario into vendor framing: the endpoint, the body shape, the status code. What the body says comes from payloads.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ValidStructured

A schema-conformant one-act plan: payloads::valid_plan.

MalformedJson

A body that is not JSON: payloads::MALFORMED_JSON.

UnknownField

A two-act plan whose second act carries a forbidden field: payloads::plan_with_unknown_field.

MissingField

A two-act plan whose second act lacks a required field: payloads::plan_with_missing_field.

MultipleActs

A well-formed two-act plan: payloads::two_act_plan.

ToolCallIds

A single tool call named payloads::TOOL_NAME with id payloads::EXPECTED_CALL_ID.

StreamingReconstruction

The same answer available both whole and streamed, so the suite can compare them. Mount both: the fixture distinguishes them by the streaming flag the adapter puts on the wire.

Three rows read this scenario, and each asks something of the streamed half:

• it must reassemble into the whole answer, content and finish reason alike;
• it must deliver the prose in at least two wire events, or Check::StreamingIncremental cannot tell an adapter that streams from one that buffers the body and emits a single delta at the end;
• it must report the same token usage as the whole half — which means both halves report usage at all, usually on a final frame.

CachedUsage

A successful answer whose reported usage carries a cache figure: payloads::USAGE_INPUT_TOKENS prompt tokens of which payloads::USAGE_CACHED_TOKENS came from the provider’s cache, and payloads::USAGE_OUTPUT_TOKENS generated.

Mount the vendor’s own cache fields — prompt_tokens_details, cache_read_input_tokens, cacheReadInputTokens, cachedContentTokenCount — rather than inventing a shape, because the row is about reading them correctly. The answer itself is prose; only the counts matter.

EmptyOutput

A successful status with no usable content.

Refusal

The vendor’s refusal shape, carrying payloads::REFUSAL_TEXT.

SlowResponse

A successful answer delayed by payloads::SLOW_RESPONSE_DELAY, used by both the timeout and the cancellation checks.

RateLimited

HTTP 429 with Retry-After: {} seconds (payloads::RETRY_AFTER_SECONDS).

Authentication

HTTP 401 with the vendor’s authentication error body.

ContextOverflow

The vendor’s context-length error body.

SecretInBody

A body with payloads::DUMMY_API_KEY planted inside it, so the redaction check has something specific to hunt for.

Authorization

HTTP 403: the credential is valid and not entitled to this model.

ModelNotFound

HTTP 404: the configured model does not exist at this provider.

RequestTimeout

HTTP 408: the provider gave up waiting on its own side.

InvalidRequest

HTTP 400 that is genuinely a bad request — not a context-length problem. Mount a body no reasonable adapter could mistake for one: these two rows exist to be told apart.

ServerError

HTTP 500.

ServiceUnavailable

HTTP 503.

ContentFilter

The vendor’s safety-filter shape, whether that is a failure body or a successful answer whose finish reason says the content was filtered.

ExpiredCredential

The vendor’s expired credential shape, whatever status carries it.

Mount the body a short-lived token produces once it lapses — usually a 401 with a code such as token_expired, distinguishable from the 401 Authentication mounts only by what the body says.

QuotaExhausted

The vendor’s quota or billing shape, whatever status carries it.

Mount the body an exhausted quota or an empty credit balance produces. If the vendor uses 429 for it — several do — mount the 429 with its real body: telling it apart from RateLimited is the point of the row.

Implementations

impl Scenario

pub const ALL: [Scenario; 14]

The scenarios behind the feature rows of Check::ALL.

A full run also mounts SecretInBody and every scenario in STATUS.

pub const STATUS: [Scenario; 9]

The scenarios behind the per-status rows a fixture must also mount.

Authentication, RateLimited and ContextOverflow already cover three of the thirteen StatusRows, and StatusRow::ConnectionReset needs no mock at all, so only these nine are new.

pub const fn as_str(self) -> &'static str

Stable snake-case label.

Trait Implementations

impl Clone for Scenario

fn clone(&self) -> Scenario

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Scenario

impl Debug for Scenario

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for Scenario

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for Scenario

impl Hash for Scenario

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Scenario

fn cmp(&self, other: &Scenario) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Scenario

fn eq(&self, other: &Scenario) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Scenario

fn partial_cmp(&self, other: &Scenario) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Scenario