Struct FixtureCase 

#[non_exhaustive]
pub struct FixtureCase {
    pub name: String,
    pub direction: String,
    pub headers: BTreeMap<String, String>,
    pub envelope: FixtureEnvelope,
    pub encode_from: Option<FixtureEnvelope>,
}

One cases/*.json file. Unknown fields (grounding, notes, error, …) are ignored: they carry provenance for humans, not assertions for this side.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

The case’s name, as its filename declares it. Use it in assertion messages — a failure that names the case is one lookup from the file.

direction: String

Which half of the contract this case asserts, as the raw string. Prefer FixtureCase::direction.

headers: BTreeMap<String, String>

The complete header set for the case, including the server-trusted identity headers a producer must never emit — an authenticating edge sets those, and the corpus carries the spelling its authoring deployment uses.

envelope: FixtureEnvelope

The envelope the headers correspond to.

encode_from: Option<FixtureEnvelope>

Present only on lossy (direction: encode) cases: the logical envelope a producer starts from, before truncation / drop / percent-encoding.

Implementations

impl FixtureCase

pub fn direction(&self) -> Direction

This case’s Direction.

Panics

If the case declares a direction this crate does not know. An unrecognised direction means the corpus grew a contract this side has not been taught, and silently skipping it would let the new contract go unasserted — the failure mode the corpus exists to prevent.

pub fn logical_envelope(&self) -> &FixtureEnvelope

The envelope a producer starts from: Self::encode_from on a lossy case, the case’s own envelope otherwise.

Panics

If a non-encode case carries an encode_from. The corpus reserves that field for lossy cases, so a roundtrip case carrying one is claiming encode(envelope) == headers while handing the producer a different input. Whichever of the two it means, the case is not saying it — better to fail than to silently prefer one.

pub fn expected_tapes_headers(&self) -> BTreeMap<String, String>

The x-tapes-* subset of this case’s expected headers — what a producer must emit, with the server-trusted headers excluded.

Trait Implementations

impl Clone for FixtureCase

fn clone(&self) -> FixtureCase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FixtureCase

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FixtureCase

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.