Struct VersionRequirement 

pub struct VersionRequirement {
    pub comparison: VersionComparison,
    pub version: Version,
}

A version requirement, e.g. for a dependency package.

It consists of a target version and a comparison function. A version requirement of >=1.5 has a target version of 1.5 and a comparison function of VersionComparison::GreaterOrEqual. See alpm-comparison for details on the format.

Examples

use std::str::FromStr;

use alpm_types::{Version, VersionComparison, VersionRequirement};

let requirement = VersionRequirement::from_str(">=1.5")?;

assert_eq!(requirement.comparison, VersionComparison::GreaterOrEqual);
assert_eq!(requirement.version, Version::from_str("1.5")?);

Fields

comparison: VersionComparison

Version comparison function

version: Version

Target version

Implementations

impl VersionRequirement

pub fn new(comparison: VersionComparison, version: Version) -> Self

Create a new VersionRequirement

pub fn is_satisfied_by(&self, ver: &Version) -> bool

Returns true if the requirement is satisfied by the given package version.

Examples

use std::str::FromStr;

use alpm_types::{Version, VersionRequirement};

let requirement = VersionRequirement::from_str(">=1.5-3")?;

assert!(!requirement.is_satisfied_by(&Version::from_str("1.5")?));
assert!(requirement.is_satisfied_by(&Version::from_str("1.5-3")?));
assert!(requirement.is_satisfied_by(&Version::from_str("1.6")?));
assert!(requirement.is_satisfied_by(&Version::from_str("2:1.0")?));
assert!(!requirement.is_satisfied_by(&Version::from_str("1.0")?));

// If pkgrel is not specified in the requirement, it is ignored in the comparison.
let requirement = VersionRequirement::from_str("=1.5")?;
assert!(requirement.is_satisfied_by(&Version::from_str("1.5-3")?));

pub fn is_intersection(&self, other: &VersionRequirement) -> bool

Checks whether another VersionRequirement forms an intersection with this one.

The intersection operation ∩ on versions simply checks if there is any possible set of versions that can exist while upholding the constraints (e.g. >/<=) on both versions.

Examples

• The expression <3 ∩ <1 forms the intersection of all versions <1
• The expression <2 ∩ >1 forms the intersection X of all versions 1<X<2
• The expression =2 ∩ <3 forms the intersection of the exact version 2

use std::str::FromStr;

use alpm_types::VersionRequirement;

let requirement: VersionRequirement = "<1".parse()?;
assert!(requirement.is_intersection(&"<0.1".parse()?));

let requirement: VersionRequirement = "<2".parse()?;
assert!(requirement.is_intersection(&">1".parse()?));

let requirement: VersionRequirement = "=2".parse()?;
assert!(!requirement.is_intersection(&"<3".parse()?));

Trait Implementations

impl AlpmParser for VersionRequirement

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

Recognizes a VersionRequirement in a string slice.

Errors

Returns an error if input does not begin with a valid VersionRequirement.

fn delimiter_error_context<'a, O, P>( parser: P, ) -> impl Parser<&'a str, O, ErrMode<ContextError>>

where P: Parser<&'a str, O, ErrMode<ContextError>>,

Attaches a winnow error context to the parser when a parse error is encountered.

impl Clone for VersionRequirement

fn clone(&self) -> VersionRequirement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionRequirement

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VersionRequirement

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for VersionRequirement

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

Formats the value using the given formatter.

impl FromStr for VersionRequirement

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

Creates a new VersionRequirement from a string slice.

Delegates to VersionRequirement::parser.

Errors

Returns an error if VersionRequirement::parser fails.

type Err = Error

The associated error which can be returned from parsing.

impl PartialEq for VersionRequirement

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for VersionRequirement

impl StructuralPartialEq for VersionRequirement