Struct Version 

pub struct Version {
    pub version: SemVer,
    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 multiple entries in the index for the same semantic version string, when multiple assembled packages with that version are present, disambiguating using the content digest.
• Provide a total ordering for package versions that may or may not include a specific digest

Fields

version: SemVer

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 is used to disambiguate multiple instances of a package with the same semantic version, but differing content.

Implementations

impl Version

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

Construct a Version from its component parts.

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) -> &SemVer

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

Formats the value using the given formatter.

impl Display for Version

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

Formats the value using the given formatter.

impl From<(Version, Word)> for Version

fn from(version: (SemVer, Word)) -> Self

Converts to this type from the input type.

impl From<Version> for Version

fn from(version: SemVer) -> Self

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<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,

Restrict a value to a certain interval.

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