Enum VersionSpec

pub enum VersionSpec {
    Canary,
    Alias(CompactString),
    Calendar(CalVer),
    Semantic(SemVer),
}

Represents a resolved version or alias.

Variants

Canary

A special canary target.

Alias(CompactString)

An alias that is used as a map to a version.

Calendar(CalVer)

A fully-qualified calendar version.

Semantic(SemVer)

A fully-qualified semantic version.

Implementations

impl VersionSpec

pub fn parse<T>(value: T) -> Result<VersionSpec, SpecError>

where T: AsRef<str>,

Parse the provided string into a resolved specification based on the following rules, in order:

• If the value “canary”, map as Canary variant.
• If an alpha-numeric value that starts with a character, map as Alias.
• Else parse with Version, and map as Version.

pub fn as_version(&self) -> Option<&Version>

Return the specification as a resolved Version.

pub fn is_alias<A>(&self, name: A) -> bool

where A: AsRef<str>,

Return true if the provided alias matches the current specification.

pub fn is_canary(&self) -> bool

Return true if the current specification is canary.

pub fn is_latest(&self) -> bool

Return true if the current specification is the “latest” alias.

pub fn to_unresolved_spec(&self) -> UnresolvedVersionSpec

Convert the current resolved specification to an unresolved specification.

Trait Implementations

impl AsRef<VersionSpec> for VersionSpec

fn as_ref(&self) -> &VersionSpec

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for VersionSpec

fn clone(&self) -> VersionSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionSpec

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

Formats the value using the given formatter.

impl Default for VersionSpec

fn default() -> VersionSpec

Returns a latest alias.

impl<'de> Deserialize<'de> for VersionSpec

fn deserialize<__D>( __deserializer: __D, ) -> Result<VersionSpec, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for VersionSpec

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

Formats the value using the given formatter.

impl FromStr for VersionSpec

type Err = SpecError

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<VersionSpec, <VersionSpec as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for VersionSpec

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

where __H: Hasher,

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 Into<String> for VersionSpec

fn into(self) -> String

Converts this type into the (usually inferred) input type.

impl Ord for VersionSpec

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

Restrict a value to a certain interval.

impl PartialEq<&str> for VersionSpec

fn eq(&self, other: &&str) -> 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 PartialEq<Version> for VersionSpec

fn eq(&self, other: &Version) -> 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 PartialEq<VersionSpec> for ToolSpec

fn eq(&self, other: &VersionSpec) -> 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 PartialEq<VersionSpec> for UnresolvedVersionSpec

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

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

fn partial_cmp(&self, other: &VersionSpec) -> 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 Schematic for VersionSpec

fn schema_name() -> Option<String>

Define a name for this schema type. Names are required for non-primitive values as a means to link references, and avoid cycles.

fn build_schema(schema: SchemaBuilder) -> Schema

Create and return a schema that models the structure of the implementing type. The schema can be used to generate code, documentation, or other artifacts.

impl Serialize for VersionSpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<String> for VersionSpec

type Error = SpecError

The type returned in the event of a conversion error.

fn try_from( value: String, ) -> Result<VersionSpec, <VersionSpec as TryFrom<String>>::Error>

Performs the conversion.

impl Eq for VersionSpec

impl StructuralPartialEq for VersionSpec