Struct Translation 

pub struct Translation<Source, Target, Lossiness> { /* private fields */ }

A pending translation from Source to Target.

The conversion is deferred: the source value and a constructor closure are held together until the caller explicitly calls [translate] (lossless) or [translate_lossy] (lossy). This lets callers inspect the Diff and decide whether to proceed.

[translate]: Translation::<_, , Lossless>::translate [translate_lossy]: Translation::<, _, Lossy>::translate_lossy

Implementations

impl<S, T, L> Translation<S, T, L>

where L: Lossiness,

pub fn new( source: S, construct_target: Box<dyn FnOnce(S) -> T>, diff: Diff, ) -> Self

Build a translation from its constituent parts.

Normally called from within Upgrade::upgrade or Downgrade::downgrade implementations.

pub fn diff(&self) -> &Diff

Returns the structural diff between source and target schemas.

impl<S, T> Translation<S, T, Lossless>

pub const fn is_lossy(&self) -> bool

Always returns false; present for API symmetry with the Lossy impl.

pub fn translate(self) -> T

Consume the translation and produce the target value.

impl<S, T> Translation<S, T, Lossy>

pub const fn is_lossy(&self) -> bool

Always returns true; signals that calling [translate_lossy] will drop data.

[translate_lossy]: Translation::<_, _, Lossy>::translate_lossy

pub fn translate_lossy(self) -> T

Consume the translation and produce the target value, accepting data loss.

Trait Implementations

impl<S, T> Display for Translation<S, T, Lossless>

where T: Debug, S: Debug,

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

Formats the value using the given formatter.

impl<S, T> Display for Translation<S, T, Lossy>

where T: Debug, S: Debug,

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

Formats the value using the given formatter.