Struct plow_package_management::version::SemanticVersion

pub struct SemanticVersion { /* private fields */ }

Our own semantic version type to use in pubgrub based resolver.

Implementations

impl SemanticVersion

pub const fn new(major: u64, minor: u64, patch: u64) -> Self

Create a version with “major”, “minor” and “patch” values. version = major.minor.patch

pub const fn as_sum(&self) -> u64

pub const fn zero() -> Self

Version 0.0.0.

pub const fn bump_patch(self) -> Self

Bump the patch number of a version.

pub const fn bump_minor(self) -> Self

Bump the minor number of a version.

pub const fn bump_major(self) -> Self

Bump the major number of a version.

pub const fn is_patch_zero(&self) -> bool

Returns true if the patch field of the version is 0.

pub const fn is_minor_zero(&self) -> bool

Returns true if the minor field of the version is 0.

pub const fn is_major_zero(&self) -> bool

Returns true if the major field of the version is 0.

Trait Implementations

impl Clone for SemanticVersion

fn clone(&self) -> SemanticVersion

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticVersion

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

Formats the value using the given formatter.

impl Default for SemanticVersion

fn default() -> SemanticVersion

Returns the “default value” for a type.

impl<'req_resolver> DependencyProvider<String, SemanticVersion> for VersionRequestResolver<'req_resolver>

fn choose_package_version<T: Borrow<String>, U: Borrow<Range<SemanticVersion>>>( &self, potential_packages: impl Iterator<Item = (T, U)> ) -> Result<(T, Option<SemanticVersion>), Box<dyn Error>>

Decision making is the process of choosing the next package and version that will be appended to the partial solution. Every time such a decision must be made, potential valid packages and version ranges are preselected by the resolver, and the dependency provider must choose.

fn get_dependencies( &self, package: &String, version: &SemanticVersion ) -> Result<Dependencies<String, SemanticVersion>, Box<dyn Error>>

Retrieves the package dependencies. Return Dependencies::Unknown if its dependencies are unknown.

fn should_cancel(&self) -> Result<(), Box<dyn Error>>

This is called fairly regularly during the resolution, if it returns an Err then resolution will be terminated. This is helpful if you want to add some form of early termination like a timeout, or you want to add some form of user feedback if things are taking a while. If not provided the resolver will run as long as needed.

impl<'de> Deserialize<'de> for SemanticVersion

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SemanticVersion

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

Formats the value using the given formatter.

impl From<(u64, u64, u64)> for SemanticVersion

fn from(tuple: (u64, u64, u64)) -> Self

Converts to this type from the input type.

impl From<SemanticVersion> for (u64, u64, u64)

fn from(v: SemanticVersion) -> Self

Converts to this type from the input type.

impl FromStr for SemanticVersion

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 Hash for SemanticVersion

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 Ord for SemanticVersion

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<SemanticVersion> for SemanticVersion

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

fn partial_cmp(&self, other: &SemanticVersion) -> 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 RangeExt<SemanticVersion> for Range<SemanticVersion>

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

If true, version pair is redundant, pick the larger range.

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

If true, version pair is invalid, just feed the empty range.

impl Serialize for SemanticVersion

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&String> for SemanticVersion

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: &String) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&str> for SemanticVersion

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for SemanticVersion

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Version for SemanticVersion

fn lowest() -> Self

Returns the lowest version.

fn bump(&self) -> Self

Returns the next version, the smallest strictly higher version.

impl Copy for SemanticVersion

impl Eq for SemanticVersion

impl StructuralEq for SemanticVersion

impl StructuralPartialEq for SemanticVersion