Struct Version 

pub struct Version {
    pub major: usize,
    pub minor: Option<usize>,
    pub patch: Option<usize>,
    pub pre: Option<VersionState>,
}

Semantic Version representation.

Examples

Basic usage:

let v: Version = "1.2.3rc4".parse().unwrap();

Fields

major: usize

minor: Option<usize>

patch: Option<usize>

pre: Option<VersionState>

Implementations

impl Version

pub fn is_stable(&self) -> bool

Returns true if the version defines a stable release (not suffixed with an alpha, beta or rc version part).

Example

let version: Version = "1.2".parse().unwrap();
assert!(version.is_stable());

let version: Version = "1.3rc1".parse().unwrap();
assert!(!version.is_stable());

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

Returns true if the current version covers the given other version.

Example

let a: Version = "1.2".parse().unwrap();
let b: Version = "1.2".parse().unwrap();
assert!(a.covers(&b));

let a: Version = "1".parse().unwrap();
let b: Version = "1.2.1".parse().unwrap();
assert!(a.covers(&b));

let a: Version = "1.3".parse().unwrap();
let b: Version = "1.3.7".parse().unwrap();
assert!(a.covers(&b));

let a: Version = "1.2.3".parse().unwrap();
let b: Version = "1.2.3rc1".parse().unwrap();
assert!(a.covers(&b));

let a: Version = "1.3".parse().unwrap();
let b: Version = "1.2.1".parse().unwrap();
assert!(!a.covers(&b));

pub fn strip_after(&self, part: VersionPart) -> Self

Returns a copy of the Version with the part after the given VersionPart removed.

Example

let a: Version = "1.2.3rc1".parse().unwrap();
let b: Version = "1".parse().unwrap();
assert_eq!(a.strip_after(VersionPart::Major), b);

let a: Version = "1.2.3rc1".parse().unwrap();
let b: Version = "1.2".parse().unwrap();
assert_eq!(a.strip_after(VersionPart::Minor), b);

let a: Version = "1.2.3rc1".parse().unwrap();
let b: Version = "1.2.3".parse().unwrap();
assert_eq!(a.strip_after(VersionPart::Patch), b);

Trait Implementations

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

fn default() -> Version

Returns the “default value” for a type.

impl Display for Version

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

Formats the value using the given formatter.

impl FromStr for Version

type Err = Error

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: &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: &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

impl StructuralPartialEq for Version