Enum Mapping 

#[non_exhaustive]
pub enum Mapping {
    Nothing,
    Send(Value),
    Omit(&'static str),
    Place,
    Unsupported(String),
}

What a wire does with one option.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Nothing

The option is unset. For a set option this is an encode error.

Send(Value)

Deep-merge this JSON object into the body, above the wire’s own encoding of the request and below additional_params.

Omit(&'static str)

Honour the option by sending nothing: the provider default already does what was asked. Logged at debug with the reason.

Place

Honour the option through markers the wire’s base builder writes inside the body’s arrays. Valid for cache only.

Unsupported(String)

The wire or model cannot honour it: an error under OnUnsupported::Error, a warning under OnUnsupported::Ignore.

Implementations

impl Mapping

pub fn of<T>(value: Option<T>, map: impl FnOnce(T) -> Mapping) -> Mapping

Nothing for an unset option, otherwise what map answers for it.

pub fn of_stop( stop: &[String], map: impl FnOnce(&[String]) -> Mapping, ) -> Mapping

Nothing for an empty stop list, otherwise what map answers.

pub fn unsupported(reason: impl Into<String>) -> Mapping

The refusal for reason. Answer it only for a set option, through Mapping::of or Mapping::of_stop: an unset option answers Mapping::Nothing.

Trait Implementations

impl Clone for Mapping

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mapping

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

Formats the value using the given formatter.

impl PartialEq for Mapping

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Mapping