Struct mvn_version::ArtifactVersion

pub struct ArtifactVersion { /* fields omitted */ }

This is an implementation of Maven’s DefaultArtifactVersion.

ArtifactVersion parses a version into major, minor, incremental, build, and qualifier components. The former three are separated by dots. The build or qualifier (there can only be one of the two) will be set by whatever is after a dash, if present. Missing components will be zero (in case of the numeric ones) or None (for the qualifier). In general, unknown version formats will be ungracefully dumped into the qualifier section, leaving everything else as zero.

See ComparableVersion for an overview of how versions are parsed for the purposes of comparison and equality. It’s used here internally for comparison operations.

Implementations

impl ArtifactVersion

pub fn new(s: &str) -> Self

Constructs an ArtifactVersion from the given string. This function cannot fail for any reason, and will always return a valid ComparableVersion. Make sure to strip whitespace before passing your input to this function. Otherwise, whitespace is treated identically to any other text. A empty string will parse as 0.0.0.0-, with an empty string in the qualifier section.

pub fn major(&self) -> u32

The major version, or 0 if not specified.

pub fn minor(&self) -> u32

The minor version, or 0 if not specified.

pub fn incremental(&self) -> u32

The incremental version, or 0 if not specified.

pub fn build(&self) -> u32

The build number, or 0 if not specified. If this is nonzero, qualifier will always be None.

pub fn qualifier(&self) -> &Option<String>

The qualifier, or None if not specified. If this is Some, build will always be zero.

Trait Implementations

impl Clone for ArtifactVersion

fn clone(&self) -> ArtifactVersion

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactVersion

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

Formats the value using the given formatter.

impl Display for ArtifactVersion

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

Formats the value using the given formatter.

impl Eq for ArtifactVersion

impl From<&'_ str> for ArtifactVersion

fn from(s: &str) -> Self

Performs the conversion.

impl FromStr for ArtifactVersion

type Err = Infallible

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 Hash for ArtifactVersion

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Ord for ArtifactVersion

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

This method returns an Ordering between self and other.

#[must_use]

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

Compares and returns the maximum of two values.

#[must_use]

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

Compares and returns the minimum of two values.

#[must_use]

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

Restrict a value to a certain interval.

impl PartialEq<ArtifactVersion> for ArtifactVersion

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

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

This method tests for !=.

impl PartialOrd<ArtifactVersion> for ArtifactVersion

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

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

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

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

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

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

impl StructuralEq for ArtifactVersion