Struct specifications::version::Version

pub struct Version {
    pub major: u64,
    pub minor: u64,
    pub patch: u64,
}

Implements the Version, which is used to keep track of package versions.

Fields

major: u64

The major version number. If all three are set to u64::MAX, is interpreted as an unresolved ‘latest’ version number.

minor: u64

The minor version number. If all three are set to u64::MAX, is interpreted as an unresolved ‘latest’ version number.

patch: u64

The patch version number. If all three are set to u64::MAX, is interpreted as an unresolved ‘latest’ version number.

Implementations

impl Version

pub const fn new(major: u64, minor: u64, patch: u64) -> Self

Constructor for the Version.
Note that this function panics if you try to create a ‘latest’ function this way; use latest() instead.

Arguments

• major: The major version number.
• minor: The minor version number.
• patch: The patch version number.

pub const fn latest() -> Self

Constructor for the Version that sets it to an (unresolved) ‘latest’ version.

pub fn from_package_pair(package: &str) -> Result<(String, Self), ParseError>

Special factory method that creates a package name and a version from a NAME[:VERSION] pair.

If the VERSION is omitted, returns Version::latest().

Arguments

• package: The package NAME[:VERSION] pair to parse.

Errors

This function may error if parsing failed, somehow.

pub fn resolve_latest<I: IntoIterator<Item = Self>>( &mut self, iter: I, ) -> Result<(), ResolveError>

Resolves this version in case it’s a ‘latest’ version.

Generic types

• I: The type of the iterator passed to this function.

Arguments

• iter: An iterator over resolved version numbers.

Returns
Nothing on success (except that this version now is equal to the latest version in the bunch), or a VersionError otherwise.

pub const fn is_latest(&self) -> bool

Returns whether or not this Version represents a ‘latest’ version.

Trait Implementations

impl AsRef<Version> for Version

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Version

fn clone(&self) -> Version

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Version

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

Formats the value using the given formatter.

impl Default for Version

fn default() -> Self

Default constructor for the Version, which initializes it to 0.0.0.

impl<'de> Deserialize<'de> for Version

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Version

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

Formats the value using the given formatter.

impl From<&Version> for String

fn from(value: &Version) -> Self

Converts to this type from the input type.

impl From<&Version> for Version

fn from(value: &Version) -> Self

Converts to this type from the input type.

impl From<&Version> for Version

fn from(version: &Version) -> Self

Converts to this type from the input type.

impl From<&mut Version> for Version

fn from(value: &mut Version) -> Self

Converts to this type from the input type.

impl From<Version> for String

fn from(value: Version) -> Self

Converts to this type from the input type.

impl From<Version> for Version

fn from(version: Version) -> Self

Converts to this type from the input type.

impl FromStr for Version

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Ord for Version

fn cmp(&self, other: &Self) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq<Version> for Version

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for Version

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<Version> 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 PartialOrd for Version

fn partial_cmp(&self, other: &Self) -> 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 Serialize for Version

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Version

impl Eq for Version