Enum darling::util::Override

pub enum Override<T> {
    Inherit,
    Explicit(T),
}

A value which can inherit a default value or have an explicit value specified.

Usage

This type is meant for attributes like default in darling, which can take the following forms:

• #[darling(default)]
• #[darling(default="path::to::fn")]

In a struct collecting input for this attribute, that would be written as:

use darling::util::Override;
#[derive(FromField)]
#[darling(attributes(darling))]
pub struct Options {
   default: Option<Override<syn::Path>>,
}

impl Options {
    fn hydrate(self) -> Option<syn::Path> {
        self.default.map(|ov| ov.unwrap_or(syn::parse_path("::Default::default").unwrap()))
    }
}

The word format (with no associated value), would produce Override::Inherit, while a list or value format would produce Override::Explicit.

Variants

Inherit

Inherit the eventual value from an external source.

Explicit(T)

Explicitly set the value.

Methods

impl<T> Override<T>

fn as_ref(&'a self) -> Override<&'a T>

Converts from Override<T> to Override<&T>.

Produces a new Override, containing a reference into the original, leaving the original in place.

fn as_mut(&'a mut self) -> Override<&'a T>

Converts from Override<T> to Override<&mut T>.

Produces a new Override, containing a mutable reference into the original.

fn is_explicit(&self) -> bool

Returns true if the override is an Explicit value.

fn explicit(self) -> Option<T>

Converts from Override<T> to Option<T>.

fn unwrap_or(self, optb: T) -> T

Unwraps an override, yielding the content of an Explicit. Otherwise, it returns optb.

fn unwrap_or_else<F>(self, op: F) -> T where
    F: FnOnce() -> T, 

Unwraps an override, yielding the content of an Explicit. Otherwise, it calls op.

impl<T> Override<T> where
    T: Default, 

fn unwrap_or_default(self) -> T

Returns the contained value or the default value of T.

Trait Implementations

impl<T> Debug for Override<T> where
    T: Debug, 

fn fmt(&self, __arg_0: &mut Formatter) -> Result<(), Error>

impl<T> Clone for Override<T> where
    T: Clone, 

fn clone(&self) -> Override<T>

impl<T> Display for Override<T> where
    T: Display, 

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

impl<T> Default for Override<T>

fn default() -> Override<T>

Returns the "default value" for a type.

impl<T> From<Option<T>> for Override<T>

fn from(v: Option<T>) -> Override<T>

Performs the conversion.

impl<T> Eq for Override<T> where
    T: Eq, 

impl<T> FromMetaItem for Override<T> where
    T: FromMetaItem, 

Parses a MetaItem. A bare word will produce Override::Inherit, while any value will be forwarded to T::from_meta_item.

fn from_word() -> Result<Override<T>, Error>

Create an instance from the presence of the word in the attribute with no additional options specified.

fn from_list(items: &[NestedMetaItem]) -> Result<Override<T>, Error>

Create an instance from a list of nested meta items.

fn from_value(lit: &Lit) -> Result<Override<T>, Error>

Create an instance from a literal value of either foo = "bar" or foo("bar"). This dispatches to the appropriate method based on the type of literal encountered, and generally should not be overridden by implementers.

fn from_nested_meta_item(item: &NestedMetaItem) -> Result<Self, Error>

fn from_meta_item(item: &MetaItem) -> Result<Self, Error>

Create an instance from a syn::MetaItem by dispatching to the format-appropriate trait function. This generally should not be overridden by implementers.

fn from_char(value: char) -> Result<Self, Error>

Create an instance from a char literal in a value position.

fn from_string(value: &str) -> Result<Self, Error>

Create an instance from a string literal in a value position.

fn from_bool(value: bool) -> Result<Self, Error>

Create an instance from a bool literal in a value position.

impl<T> PartialEq<Override<T>> for Override<T> where
    T: PartialEq<T>, 

fn eq(&self, __arg_0: &Override<T>) -> bool

fn ne(&self, __arg_0: &Override<T>) -> bool