Enum Override

pub enum Override<T> {
    No,
    Clear,
    Yes {
        value: T,
    },
}

A Package property that can override its respective defaults in PackageBase.

This type is similar to Option, which has special serialization behavior. However, in some file formats (e.g. JSON) it is not possible to represent data such as Option<Option<T>>, as serialization would flatten the structure. This type enables representation of this type of data.

Variants

No

The property is not overridden.

Clear

The property is cleared.

Yes

The property is overridden.

Fields

value: T

The value with which the property is overridden.

Implementations

impl<T> Override<T>

pub fn merge_option(self, other: &mut Option<T>)

Applies self onto an Option<T>.

• Override::No -> other stays untouched.
• Override::Clear -> other is set to None.
• Override::Yes { value } -> other is set to Some(value).

pub fn get_or_insert(&mut self, default: T) -> &mut T

If Override::Yes, its value will be returned. If self is something else, self will be set to a Override::Yes { value: default }.

Similar to as Option::get_or_insert.

impl<T> Override<Vec<T>>

pub fn merge_vec(self, other: &mut Vec<T>)

Applies self onto an Vec<T>.

• Override::No -> other stays untouched.
• Override::Clear -> other is set to Vec::new().
• Override::Yes { value } -> other is set to value.

Trait Implementations

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<T> Default for Override<T>

fn default() -> Override<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for Override<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Serialize for Override<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> StructuralPartialEq for Override<T>