Skip to main content

BuildVersion

Struct BuildVersion 

Source
pub struct BuildVersion { /* private fields */ }
Expand description

A parsed release version combining semantic version, build number, and development-build provenance.

Two BuildVersion values are only meaningfully comparable when both originate from the same build source (both CI or both dev). When the semver components are equal but the build sources differ, UpgradeDecision::DevBuild is returned instead of a numeric build-number comparison.

Implementations§

Source§

impl BuildVersion

Source

pub fn new(semver: Version, build_number: u64, dev_build: bool) -> Self

Construct from parsed components.

Source

pub fn from_manifest( binary_version: &str, build_number: u64, ) -> Result<Self, Error>

Parse a release manifest’s version fields.

Manifest builds are never development builds.

§Errors

Returns an error if binary_version is not valid semver.

Source

pub fn semver(&self) -> &Version

The semantic version component.

Source

pub fn build_number(&self) -> u64

The build number.

Source

pub fn is_dev_build(&self) -> bool

Whether this is a local development build.

Source

pub fn compare_for_upgrade( &self, available: &Self, allow_override: bool, ) -> UpgradeDecision

Compare this version against an available release to determine whether an upgrade should proceed.

When allow_override is true, downgrades and development-build overrides are allowed.

Trait Implementations§

Source§

impl Clone for BuildVersion

Source§

fn clone(&self) -> BuildVersion

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for BuildVersion

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for BuildVersion

Source§

fn default() -> Self

A zero placeholder for applications that inject their current release stamp at startup.

Source§

impl Display for BuildVersion

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.