Enum TargetRefusalKind 

#[non_exhaustive]
pub enum TargetRefusalKind {
    UnknownExplicit {
        requested: TargetToken,
    },
    ExplicitUnavailable {
        target: DialectId,
        requested: TargetToken,
        reason: String,
    },
    InheritedUnavailable {
        source: DialectId,
        reason: String,
    },
    UnrecordedSource,
    NoDefault {
        source: DefaultSource,
    },
    DefaultUnavailable {
        target: DialectId,
        source: DefaultSource,
        reason: String,
    },
}

One target-refusal reason, independent of the catalog presented with it.

Each request state is distinct. In particular, absence of an explicit token does not conflate an unclassified same-format source with a foreign source and a missing cross-format default.

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.

UnknownExplicit

An explicit token names no entry in the encoder catalog.

Fields

requested: TargetToken

Token supplied by the caller, retained verbatim.

ExplicitUnavailable

A catalog target was selected explicitly but this input cannot reach it.

Fields

target: DialectId

Canonical catalog target selected by the token.

requested: TargetToken

Token supplied by the caller, retained verbatim.

reason: String

Input-conditioned reason the writer cannot deliver the target.

InheritedUnavailable

Same-format inheritance selected a source dialect the writer cannot preserve.

Fields

source: DialectId

Recorded source dialect selected by inheritance.

reason: String

Input-conditioned reason the writer cannot preserve it.

UnrecordedSource

Same-format inheritance found source metadata without a dialect.

NoDefault

Inheritance had no same-format source and the catalog declares no default.

Fields

source: DefaultSource

Why no same-format source identity was available to inherit.

DefaultUnavailable

A cross-format default was selected but this input cannot reach it.

Fields

target: DialectId

Canonical catalog default.

source: DefaultSource

Why the catalog default, rather than source inheritance, was selected.

reason: String

Input-conditioned reason the writer cannot deliver the target.

Trait Implementations

impl Clone for TargetRefusalKind

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TargetRefusalKind

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

Formats the value using the given formatter.

impl Eq for TargetRefusalKind

impl PartialEq for TargetRefusalKind

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TargetRefusalKind

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 TargetRefusalKind