Trait OptionableConvert 

pub trait OptionableConvert: Sized + Optionable {
    // Required methods
    fn into_optioned(self) -> Self::Optioned;
    fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>;
    fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>;
}

Extension trait for sized Optionable to transform in and from optioned objects as well as merging.

Required Methods

fn into_optioned(self) -> Self::Optioned

Transforms this object into an optioned variant which all fields set.

We cannot implement Into from the stdlib as we need to implement this for various stdlib primitives and containers.

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

Try to build this full type from its optioned variant.

We cannot implement TryFrom from the stdlib as we need to implement this for various stdlib primitives and containers.

Errors

• If fields required by the full type are not set.

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

Merge the optioned values into this full type. List-like types are overwritten if set in other. Maps are merged per key.

Errors

• There are scenarios where the full type allows some missing fields but the optioned type also does not hold enough subfields to constructs a full entry with the respective try_from. An example would be a field with type Option<T> and value None for self and type Option<T::Optioned> and Some value for other. The T::try_from(T::Optioned) can fail is fields are missing for this subfield.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl OptionableConvert for Value

Available on crate feature serde_json only.

fn into_optioned(self) -> Value

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for bool

fn into_optioned(self) -> bool

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for char

fn into_optioned(self) -> char

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for f32

fn into_optioned(self) -> f32

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for f64

fn into_optioned(self) -> f64

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for i8

fn into_optioned(self) -> i8

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for i16

fn into_optioned(self) -> i16

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for i32

fn into_optioned(self) -> i32

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for i64

fn into_optioned(self) -> i64

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for i128

fn into_optioned(self) -> i128

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for isize

fn into_optioned(self) -> isize

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for u8

fn into_optioned(self) -> u8

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for u16

fn into_optioned(self) -> u16

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for u32

fn into_optioned(self) -> u32

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for u64

fn into_optioned(self) -> u64

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for u128

fn into_optioned(self) -> u128

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for ()

fn into_optioned(self)

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for usize

fn into_optioned(self) -> usize

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for String

Available on crate features alloc or std only.

fn into_optioned(self) -> String

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for Duration

Available on crate feature std only.

fn into_optioned(self) -> Duration

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for OsString

Available on crate feature std only.

fn into_optioned(self) -> OsString

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl OptionableConvert for PathBuf

Available on crate feature std only.

fn into_optioned(self) -> PathBuf

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl<K: Ord + Hash, T: OptionableConvert, S: BuildHasher + Default> OptionableConvert for HashMap<K, T, S>

where T::Optioned: Sized,

Available on crate feature std only.

fn into_optioned(self) -> HashMap<K, T::Optioned, S>

fn try_from_optioned(value: HashMap<K, T::Optioned, S>) -> Result<Self, Error>

fn merge(&mut self, other: HashMap<K, T::Optioned, S>) -> Result<(), Error>

impl<K: Ord, T: OptionableConvert> OptionableConvert for BTreeMap<K, T>

where T::Optioned: Sized,

Available on crate features alloc or std only.

fn into_optioned(self) -> BTreeMap<K, T::Optioned>

fn try_from_optioned(value: BTreeMap<K, T::Optioned>) -> Result<Self, Error>

fn merge(&mut self, other: BTreeMap<K, T::Optioned>) -> Result<(), Error>

impl<T> OptionableConvert for BinaryHeap<T>

where T: Ord + OptionableConvert, T::Optioned: Sized + Ord,

Available on crate features alloc or std only.

fn into_optioned(self) -> <BinaryHeap<T> as Optionable>::Optioned

fn try_from_optioned( value: <BinaryHeap<T> as Optionable>::Optioned, ) -> Result<Self, Error>

fn merge( &mut self, other: <BinaryHeap<T> as Optionable>::Optioned, ) -> Result<(), Error>

impl<T> OptionableConvert for BTreeSet<T>

where T: Ord + OptionableConvert, T::Optioned: Sized + Ord,

Available on crate features alloc or std only.

fn into_optioned(self) -> <BTreeSet<T> as Optionable>::Optioned

fn try_from_optioned( value: <BTreeSet<T> as Optionable>::Optioned, ) -> Result<Self, Error>

fn merge( &mut self, other: <BTreeSet<T> as Optionable>::Optioned, ) -> Result<(), Error>

impl<T, S: Default + BuildHasher> OptionableConvert for HashSet<T, S>

where T: Ord + Hash + OptionableConvert, T::Optioned: Sized + Eq + Hash,

Available on crate feature std only.

fn into_optioned(self) -> <HashSet<T, S> as Optionable>::Optioned

fn try_from_optioned( value: <HashSet<T, S> as Optionable>::Optioned, ) -> Result<Self, Error>

fn merge( &mut self, other: <HashSet<T, S> as Optionable>::Optioned, ) -> Result<(), Error>

impl<T, const N: usize> OptionableConvert for [T; N]

where T: Debug + OptionableConvert, T::Optioned: Sized,

Available on crate features alloc or std only.

fn into_optioned(self) -> Self::Optioned

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl<T: OptionableConvert + Clone> OptionableConvert for Cow<'_, T>

where T::Optioned: Clone,

Available on crate features alloc or std only.

fn into_optioned(self) -> Self::Optioned

fn try_from_optioned(value: Self::Optioned) -> Result<Self, Error>

fn merge(&mut self, other: Self::Optioned) -> Result<(), Error>

impl<T: OptionableConvert> OptionableConvert for Option<T>

where T::Optioned: Sized,

fn into_optioned(self) -> Option<T::Optioned>

fn try_from_optioned(value: Option<T::Optioned>) -> Result<Self, Error>

fn merge(&mut self, other: Option<T::Optioned>) -> Result<(), Error>

impl<T: OptionableConvert> OptionableConvert for Box<T>

where T::Optioned: Sized,

Available on crate features alloc or std only.

fn into_optioned(self) -> Box<T::Optioned>

fn try_from_optioned(value: Box<T::Optioned>) -> Result<Self, Error>

fn merge(&mut self, other: Box<T::Optioned>) -> Result<(), Error>

impl<T: OptionableConvert> OptionableConvert for LinkedList<T>

where T::Optioned: Sized,

Available on crate features alloc or std only.

fn into_optioned(self) -> <LinkedList<T> as Optionable>::Optioned

fn try_from_optioned( value: <LinkedList<T> as Optionable>::Optioned, ) -> Result<Self, Error>

fn merge( &mut self, other: <LinkedList<T> as Optionable>::Optioned, ) -> Result<(), Error>

impl<T: OptionableConvert> OptionableConvert for VecDeque<T>

where T::Optioned: Sized,

Available on crate features alloc or std only.

fn into_optioned(self) -> <VecDeque<T> as Optionable>::Optioned

fn try_from_optioned( value: <VecDeque<T> as Optionable>::Optioned, ) -> Result<Self, Error>

fn merge( &mut self, other: <VecDeque<T> as Optionable>::Optioned, ) -> Result<(), Error>

impl<T: OptionableConvert> OptionableConvert for Vec<T>

where T::Optioned: Sized,

Available on crate features alloc or std only.

fn into_optioned(self) -> <Vec<T> as Optionable>::Optioned

fn try_from_optioned( value: <Vec<T> as Optionable>::Optioned, ) -> Result<Self, Error>

fn merge( &mut self, other: <Vec<T> as Optionable>::Optioned, ) -> Result<(), Error>

Implementors