Struct Reference

pub struct Reference {
    pub name: FullName,
    pub target: Target,
    pub peeled: Option<ObjectId>,
}

A fully owned backend agnostic reference

Fields

name: FullName

The path to uniquely identify this ref within its store.

target: Target

The target of the reference, either a symbolic reference by full name or a possibly intermediate object by its id.

peeled: Option<ObjectId>

The fully peeled object to which this reference ultimately points to after following all symbolic refs and all annotated tags. Only guaranteed to be set after Reference::peel_to_id_in_place() was called or if this reference originated from a packed ref.

Implementations

impl Reference

pub fn kind(&self) -> Kind

Returns the kind of reference based on its target

pub fn name_without_namespace( &self, namespace: &Namespace, ) -> Option<&FullNameRef>

Return the full validated name of the reference, with the given namespace stripped if possible.

If the reference name wasn’t prefixed with namespace, None is returned instead.

pub fn strip_namespace(&mut self, namespace: &Namespace) -> &mut Self

Strip the given namespace from our name as well as the name, but not the reference we point to.

Trait Implementations

impl Clone for Reference

fn clone(&self) -> Reference

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Reference

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Reference

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'p> From<Reference<'p>> for Reference

fn from(value: Reference<'p>) -> Self

Converts to this type from the input type.

impl From<Reference> for Reference

fn from(value: Reference) -> Self

Converts to this type from the input type.

impl From<Reference> for Reference

fn from(value: Reference) -> Self

Converts to this type from the input type.

impl Hash for Reference

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 Reference

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

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

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

fn log_iter<'a, 's>(&'a self, store: &'s Store) -> Platform<'a, 's>

A step towards obtaining forward or reverse iterators on reference logs.

fn log_exists(&self, store: &Store) -> bool

For details, see Reference::log_exists().

fn peel_to_id_in_place( &mut self, store: &Store, objects: &dyn Find, ) -> Result<ObjectId, Error>

Follow all symbolic targets this reference might point to and peel the underlying object to the end of the tag-chain, returning the first non-tag object the annotated tag points to, using objects to access them and store to lookup symbolic references.

fn peel_to_id_in_place_packed( &mut self, store: &Store, objects: &dyn Find, packed: Option<&Buffer>, ) -> Result<ObjectId, Error>

Like ReferenceExt::peel_to_id_in_place(), but with support for a known stable packed buffer to use for resolving symbolic links.

fn follow_to_object_in_place_packed( &mut self, store: &Store, packed: Option<&Buffer>, ) -> Result<ObjectId, Error>

Like ReferenceExt::follow(), but follows all symbolic references while gracefully handling loops, altering this instance in place.

fn follow(&self, store: &Store) -> Option<Result<Reference, Error>>

Follow this symbolic reference one level and return the ref it refers to.

fn follow_packed( &self, store: &Store, packed: Option<&Buffer>, ) -> Option<Result<Reference, Error>>

Follow this symbolic reference one level and return the ref it refers to, possibly providing access to packed references for lookup if it contains the referent.

impl Serialize for Reference

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Reference

impl StructuralPartialEq for Reference