Struct RegistryId 

pub struct RegistryId { /* private fields */ }

A registry-qualified identifier, <registry>:<name>, checked where it is read.

The qualification is load-bearing rather than decorative: one repository here publishes onevcs-cli to PyPI and to npm, on two cadences, so an unqualified onevcs-cli names two artifacts and a consumer waiting on it cannot say which one it got.

The registry half is an open vocabulary. crate, pypi and npm are what this repository’s own probe answers for, but a declaration is written by six repositories and a closed set here would refuse an artifact somebody genuinely publishes — a container image, a registry nobody has needed yet — at the one boundary that has no way to grant an exception. What is closed is the shape: exactly one colon, both halves present, and a name spelled in the alphabet every registry serves.

The name half is exactly what that registry serves, which for npm includes a scoped package: npm:@oneharness/cli-linux-x64 is a name npm publishes, and a grammar that refused it would force a producer to choose between declaring an artifact npm does not serve and hiding one it does. So a name is either a plain one — a letter or a digit, then the alphabet crates.io, PyPI and npm all serve — or the scoped form @scope/name, whose two halves are each a plain one. That is the whole of the leading @: it takes a scope and exactly one /, so @, @/x, @scope/ and @scope/a/b are all still refused.

Implementations

impl RegistryId

pub fn registry(&self) -> &str

The registry half — crate, pypi, npm, or whatever else a producer declared.

pub fn name(&self) -> &str

The name half, spelled exactly as that registry serves it.

Trait Implementations

impl Clone for RegistryId

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RegistryId

The identifier itself, quoted — never the wrapper, for the reason TargetName spells its own: every refusal that names one writes it with {:?}, and a derived Debug would spell a struct at an operator who wrote crate:onevcs.

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RegistryId

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RegistryId

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

Formats the value using the given formatter.

impl Eq for RegistryId

impl From<RegistryId> for String

fn from(id: RegistryId) -> Self

Converts to this type from the input type.

impl FromStr for RegistryId

The conversion an argument parser and a consumer both reach for, which is the same check the document gets.

type Err = String

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

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

impl Hash for RegistryId

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 RegistryId

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,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for RegistryId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for RegistryId

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

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 Serialize for RegistryId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RegistryId

impl TryFrom<String> for RegistryId

type Error = String

The type returned in the event of a conversion error.

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

Performs the conversion.