Enum Gap 

pub enum Gap {
    Erased {
        at: String,
        bound: String,
    },
    CustomSerializer {
        at: String,
        with: String,
    },
    UnmappedForeign {
        at: String,
        path: String,
    },
    UnknownRenameRule {
        at: String,
        rule: String,
    },
    StrippedFields {
        at: String,
    },
    TransparentWithoutArgument {
        at: String,
        path: String,
        arg: usize,
    },
    ComplexFieldArgument {
        at: String,
        argument: String,
    },
}

A place the extractor could not derive a shape, and why.

Every gap names the exact type or field so the report is actionable, and carries an open schema rather than a guessed one.

Variants

Erased

impl Trait / dyn Trait in return position: only the bound survives.

Fields

at: String

Where it appeared, e.g. crate::routes::create_item.

bound: String

The trait bound rustdoc did preserve.

CustomSerializer

#[serde(with = "...")] — wire shape defined by code, not by type.

Fields

at: String

with: String

The module or function named by the attribute.

UnmappedForeign

A type outside this crate’s rustdoc index with no table mapping.

Fields

at: String

path: String

Canonical path, e.g. chrono::DateTime.

UnknownRenameRule

A rename rule this extractor does not implement, from rename_all (serde) or rename_fields/rename_items (async-graphql). Emitting names under an unknown rule would rename every one of them wrongly.

Fields

at: String

rule: String

StrippedFields

Rustdoc omits private fields, but serde still serializes them, so the field list is known to be incomplete.

Fields

at: String

TransparentWithoutArgument

A type mapped transparent in [spec.types], used without the type argument that was supposed to carry its wire shape.

Fields

at: String

path: String

Canonical path of the wrapper, e.g. async_graphql::types::json::Json.

arg: usize

The zero-based argument position the mapping named.

ComplexFieldArgument

A #[graphql(skip)]ed field’s matching #[ComplexObject] resolver takes a required argument this schema has no default for, so the field’s shape could not be recovered.

Fields

at: String

argument: String

The resolver’s own parameter name.

Implementations

impl Gap

pub fn at(&self) -> &str

Where the gap was found, for grouping and reporting.

pub fn explain(&self) -> String

One-line explanation naming the cause and the remedy.

Trait Implementations

impl Clone for Gap

fn clone(&self) -> Gap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Gap

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

Formats the value using the given formatter.

impl Eq for Gap

impl PartialEq for Gap

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Gap