Enum UrlTarget 

#[non_exhaustive]
pub enum UrlTarget {
    Object(Hash),
    #[non_exhaustive]
    Path {
        reference: String,
        path: String,
    },
}

What IssueObjectUrl binds a token to (§9.4 target).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Object(Hash)

object:<64 lowercase hex object id>.

#[non_exhaustive]

Path

path:<full ref name>:<unpadded base64url of the UTF-8 path>; the decoded path names a tree entry, empty the root tree. Built only through UrlTarget::path, which enforces the §9.4 grammar.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reference: String

The full ref name (SPEC-REFS §3).

path: String

The UTF-8 path, 0..MAX_PATH_BYTES bytes.

Implementations

impl UrlTarget

pub fn path( reference: impl Into<String>, path: impl Into<String>, ) -> Result<Self, TargetError>

A path target after checking the ref name and the §9.4 path rules.

Errors

TargetError for an invalid ref name, a path over MAX_PATH_BYTES bytes, or a nonempty path with a leading, trailing or repeated / or a ./.. entry.

pub fn field(&self) -> String

The canonical target field text.

pub fn parse_field(field: &str) -> Result<Self, TargetError>

Parse a target field. Ref names contain no :, so the field splits at its first two.

Errors

TargetError for anything Self::field does not produce.

Trait Implementations

impl Clone for UrlTarget

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 UrlTarget

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

Formats the value using the given formatter.

impl Eq for UrlTarget

impl PartialEq for UrlTarget

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UrlTarget