#include <schema.hpp>

Inheritance diagram for fable::Schema:

Collaboration diagram for fable::Schema:

Public Member Functions
	Schema (const Schema &)=default

	Schema (Schema &&)=default

Schema &	operator= (const Schema &)=default

Schema &	operator= (Schema &&)=default

	Schema (std::string desc, schema::PropertyList<> props)

	Schema (schema::PropertyList<> props)

	Schema (std::string desc, const Schema &base, schema::PropertyList<> props)

	Schema (const Schema &base, schema::PropertyList<> props)

	Schema (const std::vector< Schema > &xs)

	Schema (std::string desc, const std::vector< Schema > &xs)

	Schema (schema::BoxList props)

	Schema (std::string desc, schema::BoxList props)

	Schema (schema::BoxVec &&props)

	Schema (std::string desc, schema::BoxVec &&props)

template<typename T , std::enable_if_t< std::is_base_of_v< schema::Interface, T >, int > = 0>
	Schema (const T &value)

	Schema (std::unique_ptr< schema::Interface > ptr)

	Schema (std::shared_ptr< schema::Interface > ptr)

	Schema (std::string desc, JsonType t=JsonType::object)

template<typename T >
	Schema (T *ptr, std::string desc)

template<typename T >
	Schema (T *ptr, const schema::Box &prototype, std::string desc)

template<typename T >
	Schema (T *ptr, JsonType t, std::string desc)

Schema	reset_pointer () &&

Json	json_schema_qualified () const

Json	json_schema_qualified (const std::string &id) const

	operator schema::Box () const

std::unique_ptr< Interface >	clone () const override

JsonType	type () const override

std::string	type_string () const override

bool	is_required () const override

const std::string &	description () const override

void	set_description (std::string s) override

Json	usage () const override

Json	json_schema () const override

bool	validate (const Conf &c, std::optional< SchemaError > &err) const override

void	to_json (Json &j) const override

void	from_conf (const Conf &c) override

void	reset_ptr () override

Public Member Functions inherited from fable::schema::Interface
virtual bool	is_variant () const

virtual void	validate_or_throw (const Conf &c) const final

virtual std::optional< SchemaError >	fail (const Conf &c) const final

virtual bool	is_valid (const Conf &c) const final

virtual Json	to_json () const

Friends
void	to_json (Json &j, const Schema &s)

Additional Inherited Members
Protected Member Functions inherited from fable::schema::Interface
	Interface (const Interface &)=default

	Interface (Interface &&) noexcept=default

Interface &	operator= (const Interface &)=default

Interface &	operator= (Interface &&) noexcept=default

Detailed Description

Schema is a wrapper class for fable schemas that automatically chooses the correct underlying schema type.

That is, this class provides an interface that doesn't require you to know which class to use, but it doesn't cover all use-cases.

Member Function Documentation

◆ clone()

std::unique_ptr<Interface> fable::Schema::clone ( ) const

inlineoverridevirtual

Return a new instance of the object.

This is implemented by Base and allows us to wrap implementors of Interface with Schema.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ description()

const std::string& fable::Schema::description ( ) const

inlineoverridevirtual

Return human-readable description.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ from_conf()

void fable::Schema::from_conf ( const Conf & )

inlineoverridevirtual

Apply the input JSON configuration.

This does not validate the input.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

Here is the caller graph for this function:

◆ is_required()

bool fable::Schema::is_required ( ) const

inlineoverridevirtual

Return whether this interface needs to be set.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ json_schema()

Json fable::Schema::json_schema ( ) const

inlineoverridevirtual

Return the JSON schema.

Example output:

{ "$schema": "http://json-schema.org/draft-07/schema#", "description": "stand-in no-operation simulator", "properties": { "vehicles": { "description": "list of vehicle names to make available", "items": { "type": "string" }, "type": "array" } }, "title": "nop", "additionalProperties": false, "type": "object" }

See the following links for the specification:

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ reset_ptr()

void fable::Schema::reset_ptr ( )

inlineoverridevirtual

Reset the internal pointer to nullptr, protecting against invalid access.

This should be used when a schema is used after the backing data has been deleted.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ set_description()

void fable::Schema::set_description ( std::string s )

inlineoverridevirtual

Set human-readable description.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

Here is the caller graph for this function:

◆ to_json()

void fable::Schema::to_json ( Json & ) const

inlineoverridevirtual

Return the current value of the destination.

Warning: This is NOT an efficient operation, but it can be useful for cases where speed is not important.

Implements fable::schema::Interface.

Here is the caller graph for this function:

◆ type()

JsonType fable::Schema::type ( ) const

inlineoverridevirtual

Return the JSON type.

If this is a variant type of differing types, then null should be returned. Otherwise, the type remains unique and can be returned. A type that is null is almost always a variant type of some sort, if even only an optional type.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ type_string()

std::string fable::Schema::type_string ( ) const

inlineoverridevirtual

Return the type as a string.

The format of the string is:

"[array of] TYPE"

where TYPE is one of: null, object, boolean, float, integer, unsigned, string, and unknown.

Example output:

"object"
"array of boolean"
"array of object"

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ usage()

Json fable::Schema::usage ( ) const

inlineoverridevirtual

Return a compact JSON description of the schema. This is useful for human-readable error output.

Example output:

{ "field1": "boolean! :: lorem ipsum dolor sit amet", "field2": { "field2.1": "integer :: lorem ipsum dolor sit amet" "field2.2": "boolean :: lorem ipsum dolor sit amet" }, "field3": "array of integer :: lorem ipsum dolor sit amet", "field4": [{ "field4.1": "string :: lorem ipsum dolor sit amet" "field4.2": "boolean :: lorem ipsum dolor sit amet" }] }

When describing the schema of a primitive array, we can represent that as a single string. But when the array contains an object, we wrap a single object in an array. This isn't awfully consistent, but it's the best we can do.

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

◆ validate()

bool fable::Schema::validate	(	const Conf &	c,
		std::optional< SchemaError > &	error
	)		const

inlineoverridevirtual

Validate the input JSON configuration for correctness.

This method should only set error if there is an error. This method should not reset error if there is no error. Therefore, the content of error is only valid if the method returns false. This allows you to chain validates and check at the end if there was an error.
This method should not throw if there is a schema error!

Parameters

c	JSON to check
error	reference to store error if occurred

Returns: true if valid

Implements fable::schema::Interface.

Examples: /home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp.

Here is the caller graph for this function:

The documentation for this class was generated from the following files:

/home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/include/fable/schema.hpp
/home/docs/checkouts/readthedocs.org/user_builds/cloe/checkouts/stable/fable/src/fable/schema.cpp

Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ clone()

◆ description()

◆ from_conf()

◆ is_required()

◆ json_schema()

◆ reset_ptr()

◆ set_description()

◆ to_json()

◆ type()

◆ type_string()

◆ usage()

◆ validate()