Enum UnresolvedVersionSpec

pub enum UnresolvedVersionSpec {
    Canary,
    Alias(CompactString),
    Req(VersionReq),
    ReqAny(Vec<VersionReq>),
    Calendar(CalVer),
    Semantic(SemVer),
}

Represents an unresolved version or alias that must be resolved to a fully-qualified version.

Variants

Canary

A special canary target.

Alias(CompactString)

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

Req(VersionReq)

A partial version, requirement, or range (^, ~, etc).

ReqAny(Vec<VersionReq>)

A list of requirements to match any against (joined by ||).

Calendar(CalVer)

A fully-qualified calendar version.

Semantic(SemVer)

A fully-qualified semantic version.

Implementations

impl UnresolvedVersionSpec

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

where T: AsRef<str>,

Parse the provided string into an unresolved 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.
• If contains ||, split and parse each item with VersionReq, and map as ReqAny.
• If contains , or (space), parse with VersionReq, and map as Req.
• If starts with =, ^, ~, >, <, or *, parse with VersionReq, and map as Req.
• Else parse as Semantic or Calendar types.

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_resolved_spec(&self) -> VersionSpec

Convert the current unresolved specification to a resolved specification. Note that this does not actually resolve or validate against a manifest, and instead simply constructs the VersionSpec.

Furthermore, the Req and ReqAny variants will return a “latest” alias, as they are not resolved or valid versions.

Trait Implementations

impl AsRef<UnresolvedVersionSpec> for ToolSpec

fn as_ref(&self) -> &UnresolvedVersionSpec

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

impl AsRef<UnresolvedVersionSpec> for UnresolvedVersionSpec

fn as_ref(&self) -> &UnresolvedVersionSpec

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

impl Clone for UnresolvedVersionSpec

fn clone(&self) -> UnresolvedVersionSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnresolvedVersionSpec

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

Formats the value using the given formatter.

impl Default for UnresolvedVersionSpec

fn default() -> UnresolvedVersionSpec

Returns a latest alias.

impl<'de> Deserialize<'de> for UnresolvedVersionSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for UnresolvedVersionSpec

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

Formats the value using the given formatter.

impl From<UnresolvedVersionSpec> for ToolSpec

fn from(value: UnresolvedVersionSpec) -> Self

Converts to this type from the input type.

impl FromStr for UnresolvedVersionSpec

type Err = SpecError

The associated error which can be returned from parsing.

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

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

impl Hash for UnresolvedVersionSpec

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 UnresolvedVersionSpec

fn into(self) -> String

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

impl Ord for UnresolvedVersionSpec

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

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

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

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

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 UnresolvedVersionSpec

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 UnresolvedVersionSpec

type Error = SpecError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Eq for UnresolvedVersionSpec

impl StructuralPartialEq for UnresolvedVersionSpec