Struct schemars::gen::SchemaSettings

#[non_exhaustive]
pub struct SchemaSettings {
    pub option_nullable: bool,
    pub option_add_null_type: bool,
    pub definitions_path: String,
    pub meta_schema: Option<String>,
    pub visitors: Vec<Box<dyn GenVisitor>>,
    pub inline_subschemas: bool,
}

Settings to customize how Schemas are generated.

The default settings currently conform to JSON Schema 2020-12, but this is liable to change in a future version of Schemars if support for other JSON Schema versions is added. If you rely on generated schemas conforming to draft 2020-12, consider using the SchemaSettings::draft2020_12() method.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

option_nullable: bool

If true, schemas for Option<T> will include a nullable property.

This is not part of the JSON Schema spec, but is used in Swagger/OpenAPI schemas.

Defaults to false.

option_add_null_type: bool

If true, schemas for Option<T> will have null added to their type property.

Defaults to true.

definitions_path: String

A JSON pointer to the expected location of referenceable subschemas within the resulting root schema.

A single leading # and/or single trailing / are ignored.

Defaults to "/$defs".

meta_schema: Option<String>

The URI of the meta-schema describing the structure of the generated schemas.

Defaults to "https://json-schema.org/draft/2020-12/schema".

visitors: Vec<Box<dyn GenVisitor>>

A list of visitors that get applied to all generated schemas.

inline_subschemas: bool

Inline all subschemas instead of using references.

Some references may still be generated in schemas for recursive types.

Defaults to false.

Implementations

impl SchemaSettings

pub fn draft07() -> SchemaSettings

Creates SchemaSettings that conform to JSON Schema Draft 7.

pub fn draft2019_09() -> SchemaSettings

Creates SchemaSettings that conform to JSON Schema 2019-09.

pub fn draft2020_12() -> SchemaSettings

Creates SchemaSettings that conform to JSON Schema 2020-12.

pub fn openapi3() -> SchemaSettings

Creates SchemaSettings that conform to OpenAPI 3.0.

pub fn with(self, configure_fn: impl FnOnce(&mut Self)) -> Self

Modifies the SchemaSettings by calling the given function.

Example

use schemars::gen::{SchemaGenerator, SchemaSettings};

let settings = SchemaSettings::default().with(|s| {
    s.option_nullable = true;
    s.option_add_null_type = false;
});
let gen = settings.into_generator();

pub fn with_visitor( self, visitor: impl Visitor + Debug + Clone + 'static, ) -> Self

Appends the given visitor to the list of visitors for these SchemaSettings.

pub fn into_generator(self) -> SchemaGenerator

Creates a new SchemaGenerator using these settings.

Trait Implementations

impl Clone for SchemaSettings

fn clone(&self) -> SchemaSettings

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SchemaSettings

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

Formats the value using the given formatter.

impl Default for SchemaSettings

fn default() -> SchemaSettings

The default settings currently conform to JSON Schema 2020-12, but this is liable to change in a future version of Schemars if support for other JSON Schema versions is added. If you rely on generated schemas conforming to draft 2020-12, consider using the SchemaSettings::draft2020_12() method.

impl From<SchemaSettings> for SchemaGenerator

fn from(settings: SchemaSettings) -> Self

Converts to this type from the input type.