Enum DialectError 

#[non_exhaustive]
pub enum DialectError {
    UnprovenUnion {
        pointer: String,
        keyword: String,
    },
    ConstrainingRefSibling {
        pointer: String,
        keyword: String,
    },
    UnresolvableRef {
        pointer: String,
    },
    RecursiveRef {
        pointer: String,
    },
    TooDeep {
        pointer: String,
        limit: usize,
    },
    NotAnObject {
        pointer: String,
    },
}

A schema could not be rewritten without weakening it.

Display names a JSON pointer and a keyword, both of them from a schema the application wrote. Neither model output nor user text can reach these fields.

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.

UnprovenUnion

A union’s branches could not be proven mutually exclusive, so rewriting it as anyOf would accept documents the source schema rejects.

Fields

pointer: String

JSON pointer to the sub-schema carrying the union.

keyword: String

oneOf, always — named so the message reads the same as the others.

ConstrainingRefSibling

A $ref carries a sibling that constrains, so neither dropping it nor lifting it is safe.

Fields

pointer: String

JSON pointer to the sub-schema.

keyword: String

The sibling keyword.

UnresolvableRef

A $ref names something this module cannot resolve: a remote document, or a pointer into a part of the schema that is not a definition table.

Fields

pointer: String

JSON pointer to the sub-schema carrying the reference.

RecursiveRef

A definition refers to itself, directly or through others. Inlining it does not terminate.

Fields

pointer: String

JSON pointer to the reference that closed the cycle.

TooDeep

The schema expands or nests deeper than the rewrite allows. limit says which bound was reached.

Fields

pointer: String

JSON pointer to the level that overflowed.

limit: usize

The configured limit.

NotAnObject

A sub-schema is a boolean rather than an object, in a position where the rewrite has nothing to attach to.

Fields

pointer: String

JSON pointer to the offending position.

Implementations

impl DialectError

pub fn pointer(&self) -> &str

The JSON pointer into the source schema.

pub fn keyword(&self) -> &str

The keyword at fault, or a short label for the structural failures.

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

Stable snake-case label of the failure family, for metrics and codes.

pub fn code(&self) -> ErrorCode

The error code an adapter attaches when it turns this into a ProviderError.

Trait Implementations

impl Clone for DialectError

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 DialectError

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

Formats the value using the given formatter.

impl Display for DialectError

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

Formats the value using the given formatter.

impl Eq for DialectError

impl Error for DialectError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<DialectError> for ProviderError

fn from(value: DialectError) -> Self

A schema the dialect cannot carry is an Unsupported feature, whose retry class is Fallback.

The capability declaration stays true: this provider does enforce schemas, it just cannot enforce this one. So the router may offer the turn to another profile, and must not re-roll against the same one.

impl PartialEq for DialectError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DialectError