Struct Parser

pub struct Parser<TResolver = NoOpResolver> { /* private fields */ }

The Parser is used to load and parse XML schema information from different sources.

This structure can be used to load XML schemas information from different sources using so called Resolvers. After the content of a schema was load is it parsed and added to the list of schemas, managed by this parser.

The resulting Schemas instance can then be used by an Interpreter, to generate the more common Types structure out of it.

Implementations

impl Parser

pub fn new() -> Self

Create a new Parser instance.

impl<TResolver> Parser<TResolver>

pub fn with_default_resolver(self) -> Parser<FileResolver>

Set the default resolver for this parser.

The default resolver is just a simple FileResolver.

pub fn with_resolver<XResolver: Resolver + 'static>( self, resolver: XResolver, ) -> Parser<XResolver>

Set a custom defined resolver for this parser.

pub fn resolve_includes(self, value: bool) -> Self

Enable or disable resolving includes of parsed XML schemas.

pub fn finish(self) -> Schemas

Finish the parsing process by returning the generated Schemas instance containing all parsed schemas.

impl<TResolver> Parser<TResolver>

where TResolver: Resolver,

pub fn with_default_namespaces(self) -> Self

Add the default namespaces to this parser.

The default namespaces are:

• NamespacePrefix::XS Namespace::XS
• NamespacePrefix::XML Namespace::XML

Errors

Forwards the errors from with_namespace.

pub fn with_namespace( self, prefix: NamespacePrefix, namespace: Namespace, ) -> Self

Add a new namespace to this parser.

This method will add a new namespace to the parser. This can be useful to pre-heat the prefixes for known namespace, or to define namespaces for custom defined types.

This will not add any schema information. It’s just a namespace definition.

Errors

Will return an error if a problem or mismatch with the already existing namespaces was encountered.

impl<TResolver> Parser<TResolver>

where TResolver: Resolver, TResolver::Buffer: BufRead,

pub fn add_schema_from_str( self, schema: &str, ) -> Result<Self, Error<TResolver::Error>>

Add a new XML schema from the passed string.

This will parse the XML schema represented by the provided string and add all schema information to the resulting Schemas structure.

Errors

Will return an suitable error if the parser could not parse the provided schema.

pub fn add_schema_from_reader<R: BufRead>( self, reader: R, ) -> Result<Self, Error<TResolver::Error>>

Add a new XML schema from the passed reader.

This will parse the XML schema represented by the provided reader and add all schema information to the resulting Schemas structure.

Errors

Will return an suitable error if the parser could not read the data from the reader, or parse the schema provided by the reader.

pub fn add_schema_from_file<P: AsRef<Path> + Debug>( self, path: P, ) -> Result<Self, Error<TResolver::Error>>

Add a new XML schema from the passed file path.

This will parse the XML schema represented by the provided filepath and add all schema information to the resulting Schemas structure.

Errors

Will return an suitable error if the parser could not read the data from the file, or parse the schema content.

pub fn add_schema_from_url( self, url: Url, ) -> Result<Self, Error<TResolver::Error>>

Add a new XML schema from the passed file url.

This will parse the XML schema represented by the provided url and add all schema information to the resulting Schemas structure.

Errors

Will return an suitable error if the parser could not resolve the URL using the provided resolver or the data from the resolver could not be parsed.

Trait Implementations

impl<TResolver: Debug> Debug for Parser<TResolver>

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

Formats the value using the given formatter.

impl<TResolver: Default> Default for Parser<TResolver>

fn default() -> Parser<TResolver>

Returns the “default value” for a type.