Struct FullVersion

pub struct FullVersion {
    pub pkgver: PackageVersion,
    pub pkgrel: PackageRelease,
    pub epoch: Option<Epoch>,
}

A package version with mandatory PackageRelease.

Tracks an optional Epoch, a PackageVersion and a PackageRelease. This reflects the full and full with epoch forms of alpm-package-version.

Note

If PackageRelease should be optional for your use-case, use Version instead.

Examples

use std::str::FromStr;

use alpm_types::FullVersion;

// A full version.
let version = FullVersion::from_str("1.0.0-1")?;

// A full version with epoch.
let version = FullVersion::from_str("1:1.0.0-1")?;

Fields

pkgver: PackageVersion

The version of the package

pkgrel: PackageRelease

The release of the package

epoch: Option<Epoch>

The epoch of the package

Implementations

impl FullVersion

pub fn new( pkgver: PackageVersion, pkgrel: PackageRelease, epoch: Option<Epoch>, ) -> Self

Creates a new FullVersion.

Examples

use alpm_types::{Epoch, FullVersion, PackageRelease, PackageVersion};

// A full version.
let version = FullVersion::new(
    PackageVersion::new("1.0.0".to_string())?,
    PackageRelease::new(1, None),
    None,
);

// A full version with epoch.
let version = FullVersion::new(
    PackageVersion::new("1.0.0".to_string())?,
    PackageRelease::new(1, None),
    Some(Epoch::new(1.try_into()?)),
);

pub fn vercmp(&self, other: &FullVersion) -> i8

Compares self to another FullVersion and returns a number.

• 1 if self is newer than other
• 0 if self and other are equal
• -1 if self is older than other

This output behavior is based on the behavior of the vercmp tool.

Delegates to FullVersion::cmp for comparison. The rules and algorithms used for comparison are explained in more detail in alpm-package-version and alpm-pkgver.

Examples

use std::str::FromStr;

use alpm_types::FullVersion;

assert_eq!(
    FullVersion::from_str("1.0.0-1")?.vercmp(&FullVersion::from_str("0.1.0-1")?),
    1
);
assert_eq!(
    FullVersion::from_str("1.0.0-1")?.vercmp(&FullVersion::from_str("1.0.0-1")?),
    0
);
assert_eq!(
    FullVersion::from_str("0.1.0-1")?.vercmp(&FullVersion::from_str("1.0.0-1")?),
    -1
);

pub fn parser(input: &mut &str) -> ModalResult<Self>

Recognizes a FullVersion in a string slice.

Consumes all of its input.

Errors

Returns an error if input is not a valid alpm-package-version (full or full with epoch).

Trait Implementations

impl Clone for FullVersion

fn clone(&self) -> FullVersion

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FullVersion

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FullVersion

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FullVersion

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

Formats the value using the given formatter.

impl From<&FullVersion> for Version

fn from(value: &FullVersion) -> Self

Creates a Version from a FullVersion reference.

impl From<FullVersion> for Version

fn from(value: FullVersion) -> Self

Creates a Version from a FullVersion.

impl FromStr for FullVersion

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

Creates a new FullVersion from a string slice.

Delegates to FullVersion::parser.

Errors

Returns an error if Version::parser fails.

type Err = Error

The associated error which can be returned from parsing.

impl Ord for FullVersion

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

Compares self to another FullVersion.

The comparison rules and algorithms are explained in more detail in alpm-package-version and alpm-pkgver.

Examples

use std::{cmp::Ordering, str::FromStr};

use alpm_types::FullVersion;

// Examples for "full"
let version_a = FullVersion::from_str("1.0.0-1")?;
let version_b = FullVersion::from_str("1.0.0-2")?;
assert_eq!(version_a.cmp(&version_b), Ordering::Less);
assert_eq!(version_b.cmp(&version_a), Ordering::Greater);

let version_a = FullVersion::from_str("1.0.0-1")?;
let version_b = FullVersion::from_str("1.0.0-1")?;
assert_eq!(version_a.cmp(&version_b), Ordering::Equal);

// Examples for "full with epoch"
let version_a = FullVersion::from_str("1:1.0.0-1")?;
let version_b = FullVersion::from_str("1.0.0-2")?;
assert_eq!(version_a.cmp(&version_b), Ordering::Greater);
assert_eq!(version_b.cmp(&version_a), Ordering::Less);

let version_a = FullVersion::from_str("1:1.0.0-1")?;
let version_b = FullVersion::from_str("1:1.0.0-1")?;
assert_eq!(version_a.cmp(&version_b), Ordering::Equal);

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 FullVersion

fn eq(&self, other: &FullVersion) -> 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 FullVersion

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 FullVersion

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&Version> for FullVersion

fn try_from(value: &Version) -> Result<Self, Self::Error>

Creates a FullVersion from a Version reference.

Errors

Returns an error if value.pkgrel is None.

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<Version> for FullVersion

fn try_from(value: Version) -> Result<Self, Self::Error>

Creates a FullVersion from a Version.

Errors

Returns an error if value.pkgrel is None.

type Error = Error

The type returned in the event of a conversion error.

impl Eq for FullVersion

impl StructuralPartialEq for FullVersion