Trait BuildSchema 

pub trait BuildSchema {
    // Required method
    fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent;

    // Provided methods
    fn type_name() -> Option<&'static str> { ... }
    fn schema_metadata() -> SchemaMetadata { ... }
}

Trait for types that can build their schema representation.

This trait is typically derived using #[derive(BuildSchema)], but can also be implemented manually for custom schema generation.

Type Registration

Types can optionally provide a type_name() to register themselves in the schema’s $types namespace. This is useful for:

• Creating reusable type definitions
• Enabling type references across the schema
• Providing meaningful names in generated schemas

Primitive types typically return None for type_name().

Required Methods

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

Build the schema content for this type.

Use ctx.build::<T>() for nested types - this handles caching and recursion automatically.

Provided Methods

fn type_name() -> Option<&'static str>

The type name for registration in $types namespace.

Return Some("my-type") to register this type as $types.my-type. Return None (default) for inline/anonymous types.

fn schema_metadata() -> SchemaMetadata

Optional metadata for this type’s schema node.

Override to provide description, deprecation status, defaults, or examples.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl BuildSchema for &str

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for bool

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for f32

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for f64

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for i8

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for i16

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for i32

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for i64

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for i128

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for isize

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for u8

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for u16

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for u32

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for u64

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for u128

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for ()

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for usize

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for String

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl BuildSchema for Text

fn build_schema(_ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<A: BuildSchema + 'static> BuildSchema for (A,)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<A: BuildSchema + 'static, B: BuildSchema + 'static> BuildSchema for (A, B)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<A: BuildSchema + 'static, B: BuildSchema + 'static, C: BuildSchema + 'static> BuildSchema for (A, B, C)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<A: BuildSchema + 'static, B: BuildSchema + 'static, C: BuildSchema + 'static, D: BuildSchema + 'static> BuildSchema for (A, B, C, D)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<A: BuildSchema + 'static, B: BuildSchema + 'static, C: BuildSchema + 'static, D: BuildSchema + 'static, E: BuildSchema + 'static> BuildSchema for (A, B, C, D, E)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<A: BuildSchema + 'static, B: BuildSchema + 'static, C: BuildSchema + 'static, D: BuildSchema + 'static, E: BuildSchema + 'static, F: BuildSchema + 'static> BuildSchema for (A, B, C, D, E, F)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<K: BuildSchema + 'static, V: BuildSchema + 'static> BuildSchema for BTreeMap<K, V>

BTreeMap<K, V> is represented as a map

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<K: BuildSchema + 'static, V: BuildSchema + 'static> BuildSchema for HashMap<K, V>

HashMap<K, V> is represented as a map

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<T: BuildSchema + 'static> BuildSchema for Option<T>

Option is represented as a union: some(T) | none(null)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<T: BuildSchema + 'static> BuildSchema for Box<T>

Box delegates to T

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<T: BuildSchema + 'static> BuildSchema for Rc<T>

Rc delegates to T

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<T: BuildSchema + 'static> BuildSchema for Arc<T>

Arc delegates to T

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<T: BuildSchema + 'static> BuildSchema for Vec<T>

Vec is represented as an array with item type T

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

impl<T: BuildSchema + 'static, E: BuildSchema + 'static> BuildSchema for Result<T, E>

Result<T, E> is represented as a union: ok(T) | err(E)

fn build_schema(ctx: &mut SchemaBuilder) -> SchemaNodeContent

Implementors