Struct Schema 

pub struct Schema { /* private fields */ }

Cached schema for a type that may contain flattened fields.

This is computed once per Shape and can be cached forever since type information is static.

Implementations

impl Schema

pub fn build(shape: &'static Shape) -> Result<Self, SchemaError>

Build a schema for the given shape with flattened enum representation.

Returns an error if the type definition contains conflicts, such as duplicate field names from parent and flattened structs.

Note: This defaults to Flattened representation. For auto-detection based on #[facet(tag = "...")] attributes, use Schema::build_auto.

pub fn build_auto(shape: &'static Shape) -> Result<Self, SchemaError>

Build a schema with auto-detected enum representation based on each enum’s attributes.

This inspects each flattened enum’s shape attributes to determine its representation:

• #[facet(untagged)] → Flattened
• #[facet(tag = "type")] → InternallyTagged
• #[facet(tag = "t", content = "c")] → AdjacentlyTagged
• No attributes → Flattened (for flatten solver behavior)

For externally-tagged enums (variant name as key), use Schema::build_externally_tagged.

pub fn build_externally_tagged( shape: &'static Shape, ) -> Result<Self, SchemaError>

Build a schema for externally-tagged enum representation (e.g., JSON).

In this representation, the variant name appears as a key and the variant’s content is nested under it. The solver will only expect to see the variant name as a top-level key, not the variant’s fields.

pub fn build_with_repr( shape: &'static Shape, repr: EnumRepr, ) -> Result<Self, SchemaError>

Build a schema with the specified enum representation.

pub fn resolutions(&self) -> &[Resolution]

Get the resolutions for this schema.

Trait Implementations

impl Debug for Schema

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

Formats the value using the given formatter.