Struct Dewey

pub struct Dewey { /* private fields */ }

Package pattern matching for so-called “dewey” patterns.

These are common across pkgsrc as a way to specify a range of versions for a package. Despite the name, these have nothing to do with the Dewey decimal system.

It is unlikely that anyone would want to use this directly. The main user-facing interface is Pattern which will handle any patterns matching Dewey style automatically. However, in case it proves at all useful, it is made public.

This fully supports the same modifiers and logic that pkg_install does, according to the following rules:

Modifier(s)	Numeric value
alpha	-3
beta	-2
pre, rc	-1
pl, _, .	0
empty value	0

Examples

use pkgsrc::Dewey;

// A version greater than or equal to 1.0 and less than 2.0 is required.
let m = Dewey::new("pkg>=1.0<2");

// A common way to specify that any version is ok.
let m = Dewey::new("pkg>=0");

// Any version as long as it is earlier than 7.
let m = Dewey::new("windows<7");

Implementations

impl Dewey

pub fn new(pattern: &str) -> Result<Dewey, DeweyError>

Compile a pattern. If the pattern is invalid in any way a DeweyError is returned.

Example

use pkgsrc::Dewey;

// A correctly specified range.
assert!(Dewey::new("pkg>=1.0<2").is_ok());

// Incorrect order of operators.
assert!(Dewey::new("pkg<1>2").is_err());

// Invalid use of incompatible operators.
assert!(Dewey::new("pkg>1>=2").is_err());

pub fn matches(&self, pkg: &str) -> bool

Return whether a given str matches the compiled pattern. pkg must be a fully-specified PKGNAME.

Example

use pkgsrc::Dewey;

let m = Dewey::new("pkg>=1.0<2").unwrap();
assert_eq!(m.matches("pkg-1.0rc1"), false);
assert_eq!(m.matches("pkg-1.0"), true);
assert_eq!(m.matches("pkg-2.0rc1"), true);
assert_eq!(m.matches("pkg-2.0"), false);

Trait Implementations

impl Clone for Dewey

fn clone(&self) -> Dewey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Dewey

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

Formats the value using the given formatter.

impl Hash for Dewey

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Dewey

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