Struct Policy 

pub struct Policy {
    pub invalid: Action,
    pub vocab: Action,
    pub allow_undefined: bool,
}

Key expansion policy.

By default the expansion algorithm drops the keys that are not defined in the active context, unless:

• the active context defines a vocabulary mapping (@vocab); or
• the key contains a : character, in which case it is kept as it is, even though it may not be a well-formed IRI.

Silently dropping data is not always what an application wants: a stricter setting turns each of those situations into an error instead. Set the wanted policy through the Options::policy field.

Fields

invalid: Action

What to do with a key that expands to a malformed IRI.

Action::Keep (the default) keeps it in the expanded document, Action::Drop drops the entry, and Action::Reject aborts expansion with Error::KeyExpansionFailed — or, for a value of @type, Error::InvalidTypeValue.

vocab: Action

What to do with a key that only expands because the active context defines a vocabulary mapping (@vocab).

Action::Keep (the default) expands it against the vocabulary mapping, Action::Drop drops the entry, and Action::Reject aborts expansion with Error::ForbiddenVocab.

allow_undefined: bool

Whether a key that neither the active context nor a vocabulary mapping can expand may be dropped.

true by default. Set it to false to abort expansion with Error::KeyExpansionFailed instead of losing the entry.

Trait Implementations

impl Clone for Policy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Policy

impl Debug for Policy

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

Formats the value using the given formatter.

impl Default for Policy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Policy

impl PartialEq for Policy

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Policy