Enum Fault 

pub enum Fault {
    Truncate,
    WrongType,
    ExtraField,
    UnregisteredKey,
    WrongQos,
    MissingEncoding,
    Unstamped,
}

A single deliberate deviation from a known-valid synthesized sample (#163).

Fault injection is a mode of the generator, not a sibling tool: it reuses the whole registry walk, synthesis, scheduling, and guard machinery, then perturbs one dimension of the output after synthesis — so the delta from valid is always known, printable (Fault::delta), and stamped into the marker ("fault": "<kind>", RFC 09 §5.3). The point is consumer-robustness testing: a consumer that crashes on a truncated payload fails RFC 09 §5.1 O1’s spirit — a non-conforming sample is a fact to report, not an error to die on.

Variants

Truncate

Cut the encoded payload to half its bytes — a partial frame the decoder meets mid-value.

WrongType

Replace the body with a JSON value of the wrong shape for the declared type (a bare string where a structured type is declared).

ExtraField

Add an undeclared field to the (JSON) body — the extra key a strict schema must reject or a lenient one must ignore, never choke on.

UnregisteredKey

Publish on a key that matches no registered subject (a trailing chunk the registry never declared).

WrongQos

Publish under a QoS profile other than the subject’s declared one (RFC 04 §3) — the observed-vs-declared mismatch a doctor listen flags.

MissingEncoding

Publish with no wire Encoding set, though the subject declares one — a consumer keyed on the encoding meets a blank.

Unstamped

Publish a state sample carrying no HLC timestamp: LWW cannot order it (RFC 04 §4), and freshness is unjudgeable.

Implementations

impl Fault

pub const ALL: [Fault; 7]

Available on crate feature decode only.

Every kind, for a CLI error message and the round-trip test.

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

Available on crate feature decode only.

The kebab-case kind name — the CLI token and the marker’s "fault" value.

pub fn parse(s: &str) -> Result<Fault>

Available on crate feature decode only.

Parse one kind, naming the vocabulary on a miss (spray’s decline precedent: an unknown kind is refused, never silently ignored).

Trait Implementations

impl Clone for Fault

fn clone(&self) -> Fault

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Fault

impl Debug for Fault

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

Formats the value using the given formatter.

impl Eq for Fault

impl PartialEq for Fault

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Fault

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Fault