Enum ReceiptWireForm 

pub enum ReceiptWireForm {
    Json,
    Yaml,
}

Wire-form encoding a ReceiptEnvelope payload was serialized in — the closed set of on-disk shapes the reader accepts.

Substrate primitive that closes the “which parser did this payload use” corner at ONE typed enum: every dispatcher that selects a parser (the shared ReceiptEnvelope::parse entry, the ReceiptEnvelope::parse_json / ReceiptEnvelope::parse_yaml wrappers, and the JSON-first-YAML-fallback ReceiptEnvelope::parse_either) routes through one arm of this enum, so a future wire form (e.g. a Cbor variant for a binary emit path, an MsgPack variant for a bandwidth-tight probe) lands as ONE variant + ONE arm of Self::parse_raw. Peer to ReceiptKind on the “one closed-set typed enum per wire-format axis” pattern — ReceiptKind closes the semantic kind axis (what the receipt claims), this enum closes the encoding axis (how the payload was written down).

The wrap-variant selection on the ReceiptError side (ReceiptError::InvalidJson vs ReceiptError::InvalidYaml) travels with the wire-form arm here, so operators reading a failure surface see the encoding that failed without the caller having to hand-thread a per-form string label. See [Self::error_variant] for the closed-set mapping.

Variants

Json

Compact JSON — the closed-loop-probe binary’s default emit form and the shape serde_json::to_string(&env) produces.

Yaml

YAML — the shape a ConfigMap authored via kubectl apply -f carries, and what serde_yaml::to_string(&env) produces.

Implementations

impl ReceiptWireForm

pub const ALL: [Self; 2]

The closed set of wire-form encodings the reader accepts — single source of truth that drives the JSON-first-YAML-fallback sweep at ReceiptEnvelope::parse_either AND any future enumeration consumer (a per-form metrics tag walker, a tatara-check receipt-form auditor, a CLI --wire-form flag completion list). Adding a third variant (e.g. Cbor for the binary-emit corner already anticipated at Self’s enum docstring, or MsgPack for a bandwidth-tight probe) lands as ONE new variant + ONE arm on Self::parse_raw + ONE arm on Self::as_str + ONE entry in Self::ALL — exhaustively checked by the compiler (the [Self; N] array literal forces the arity) AND by the per-variant truth-table tests below AND by parse_either’s ALL-driven sweep (which auto-picks up the new form without a per-consumer edit at the fallback chain).

Sibling closed-set tables across the crate’s typescape — this entry closes the fourth axis they jointly own (semantic kind / export report / process phase / boundary condition / intent kind / wire-form encoding): ReceiptKind::ALL, crate::export::ReportFormat::ALL, crate::phase::ProcessPhase::ALL, crate::boundary::ConditionKind::ALL, crate::intent::IntentKind::ALL.

The array order is JSON THEN YAML — matching the historical ReceiptEnvelope::parse_either .or_else chain that tried JSON first and YAML on JSON failure, so operator-facing log lines reading the LAST-form error variant continue to see the same fallback-form error (ReceiptError::InvalidYaml) on a receipt payload that both forms reject. A regression that reorders the entries surfaces at [tests::receipt_wire_form_all_matches_declaration_order_json_then_yaml] rather than as silent operator-facing skew across every fallback log line.

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

Stable wire-form label — the short lowercase identifier ("json" / "yaml") an operator-facing log line, a per-form metrics tag, or a future CLI flag surface can print or match against. Pins the closed-set spelling at ONE table so a downstream rename lands here rather than at every consumer that hand-composed "json" / "yaml" inline.

Trait Implementations

impl Clone for ReceiptWireForm

fn clone(&self) -> ReceiptWireForm

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReceiptWireForm

impl Debug for ReceiptWireForm

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

Formats the value using the given formatter.

impl Eq for ReceiptWireForm

impl Hash for ReceiptWireForm

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

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 PartialEq for ReceiptWireForm

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReceiptWireForm