Struct Version 

pub struct Version(/* private fields */);

A monotonically increasing event version number.

Wraps NonZeroU64 — event versions are always >= 1. A fresh aggregate with no events has Option<Version> = None.

The only public entry points are:

• Version::INITIAL — the first event version (1)
• Version::new() — construct from a u64 (returns None for 0)
• version.next() — derives the next version, returns None on overflow

Example

use mnesis::Version;

let v = Version::INITIAL;
assert_eq!(v.as_u64(), 1);
assert_eq!(v.next().unwrap().as_u64(), 2);

Implementations

impl Version

pub const INITIAL: Version

The first event version (1).

pub const fn next(self) -> Option<Version>

The next version in sequence.

Returns None if the version is u64::MAX (overflow).

pub const fn as_u64(self) -> u64

The underlying integer value. Always >= 1.

pub const fn new(v: u64) -> Option<Version>

Construct a Version from a u64.

Returns None if v is 0 (invalid — versions are always >= 1). Mirrors NonZeroU64::new.

pub fn run(start: Version, len: usize) -> Option<VersionRun>

len consecutive versions start, start+1, …, start+len-1.

The whole run is validated up front, so iteration is infallible and never silently truncates on overflow — a lazy infinite iterator zipped against a batch could drop items; this cannot. Returns None if the run would overflow past u64::MAX, consistent with Version::new/Version::next returning Option. len == 0 yields an empty run.

Trait Implementations

impl Clone for Version

fn clone(&self) -> Version

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Version

impl Debug for Version

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

Formats the value using the given formatter.

impl Display for Version

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

Formats the value using the given formatter.

impl Eq for Version

impl From<SchemaVersion> for Version

fn from(sv: SchemaVersion) -> Self

Widen to the kernel’s Version (NonZeroU64). Total — NonZeroU32 always fits in NonZeroU64.

impl Hash for Version

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Version

fn cmp(&self, other: &Version) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Version

fn eq(&self, other: &Version) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Version

fn partial_cmp(&self, other: &Version) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Version