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

Clear

Yes

Fields

value: T

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> 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.