Struct rpm::Evr

pub struct Evr<'a> { /* private fields */ }

A full RPM “version” specifier has 3 different components - Epoch, Version, and Release.

You are not expected to create these manually, but rather from existing RPMs.

Epoch overrides all other fields and is generally only used as a last resort - in cases where a change to the versioning scheme or packaging error creates a situation where newer packages might otherwise sort as being older.

Version is the normal version string used by the upstream project. This shouldn’t be tweaked by the packager.

Release indicates firstly the number of times this package has been released - for instance, with custom patches and backports not present in the upstream, but may also indicate other details such as the OS it was built for (fc38, el9) or portions of a git commit hash.

Tilde (~) and caret (^) are special values used in particular situations. Including ~ in a version is used for denoting pre-releases and will force it to sort as less than a version without a caret, e.g. 0.5.0 vs 0.5.0~rc1. Including ^ in a version is used for denoting snapshots not directly associated with an upstream release and will force it to sort higher, e.g. 0.5.0 vs 0.5.0^deadbeef

Implementations

impl<'a> Evr<'a>

pub fn new<T: Into<Cow<'a, str>>>(epoch: T, version: T, release: T) -> Evr<'a>

Create a new EVR

pub fn parse(evr: &'a str) -> Self

Create an EVR parsed from a string

pub fn epoch(&self) -> &str

The epoch value

pub fn version(&self) -> &str

The version value

pub fn release(&self) -> &str

The release value

pub fn as_normalized_form(&self) -> String

Write an EVR string in a normalized form which always includes an epoch

The standard string representation of an EVR will ignore the epoch if not set. A package having no epoch value is equivalent to having an epoch of zero. Sometimes it is useful to write NEVRAs in a form such that equivalent values are represented identically, therefore, this “normalized” form will always include it.

pub fn values(&self) -> (&str, &str, &str)

Return the epoch, version and release values as a 3-element tuple

pub fn parse_values(evr: &'a str) -> (&'a str, &'a str, &'a str)

Parse the epoch, version and release values and return them as a 3-element tuple

Trait Implementations

impl<'a> Clone for Evr<'a>

fn clone(&self) -> Evr<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Evr<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Evr<'a>

fn default() -> Evr<'a>

Returns the “default value” for a type.

impl<'a> Display for Evr<'a>

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

Formats the value using the given formatter.

impl<'a> From<(&'a str, &'a str, &'a str)> for Evr<'a>

fn from(val: (&'a str, &'a str, &'a str)) -> Self

Converts to this type from the input type.

impl<'a> Ord for Evr<'a>

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 + PartialOrd,

Restrict a value to a certain interval.

impl<'a> PartialEq for Evr<'a>

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialOrd for Evr<'a>

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

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

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

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

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

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

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<'a> Eq for Evr<'a>