Struct Version 

pub struct Version {
    pub version: Version,
    pub digest: Option<LexicographicWord>,
}

The representation of versioning information associated with packages in the package index.

This type provides the means by which dependency resolution can satisfy versioning constraints on packages using either semantic version constraints or explicit package digests simultaneously.

All packages have an associated semantic version. Packages which have been assembled to MAST, also have an associated content digest. However, for the purposes of indexing and dependency resolution, we cannot assume that all packages have a content digest (as they may not have been assembled yet), and so this type is used to represent versions within the index/resolver so that it can:

• Satisfy requirements for a package that has a specific digest
• Record the exact published identity of a canonical package artifact as semver#digest
• Provide a total ordering for package versions that may or may not include a specific digest

Fields

version: Version

The semantic version information

This is the canonical human-facing version for a package.

digest: Option<LexicographicWord>

The content digest for this version, if known.

This is the most precise version for a package, and uniquely identifies the canonical published artifact associated with a semantic version.

Implementations

impl Version

pub fn new(version: Version, digest: Word) -> Version

Construct a Version from its component parts.

pub fn without_digest(&self) -> Version

Get a Version without an attached digest for comparison purposes

pub fn as_range(&self) -> Range<Version>

Get a core::ops::Range which can be used to select all available versions with the same semantic version, but with possibly-differing digests

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

Returns true if self and other are equivalent with regards to semantic versioning

pub fn satisfies(&self, requirement: &VersionRequirement) -> bool

Check if this version satisfies the given requirement.

Version requirements are expressed as either a semantic version constraint OR a specific content digest.

Trait Implementations

impl Borrow<Version> for Version

fn borrow(&self) -> &Version

Immutably borrows from an owned value.

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 Debug for Version

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

Formats the value using the given formatter.

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

Available on crate feature serde only.

fn deserialize<D>( deserializer: D, ) -> Result<Version, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Version

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

Formats the value using the given formatter.

impl From<(Version, Word)> for Version

fn from(version: (Version, Word)) -> Version

Converts to this type from the input type.

impl From<Version> for Version

fn from(version: Version) -> Version

Converts to this type from the input type.

impl From<Version> for VersionRequirement

fn from(value: Version) -> VersionRequirement

Converts to this type from the input type.

impl FromStr for Version

type Err = InvalidVersionError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Version, <Version as FromStr>::Err>

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

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

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 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 Serialize for Version

Available on crate feature serde only.

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Version

impl StructuralPartialEq for Version