Enum git_repository::revision::spec::parse::RefsHint

pub enum RefsHint {
    PreferObjectOnFullLengthHexShaUseRefOtherwise,
    PreferObject,
    PreferRef,
    Fail,
}

A hint to know what to do if refs and object names are equal.

Variants

PreferObjectOnFullLengthHexShaUseRefOtherwise

This is the default, and leads to specs that look like objects identified by full hex sha and are objects to be used instead of similarly named references. The latter is not typical but can absolutely happen by accident. If the object prefix is shorter than the maximum hash length of the repository, use the reference instead, which is preferred as there are many valid object names like beef and cafe that are short and both valid and typical prefixes for objects. Git chooses this as default as well, even though it means that every object prefix is also looked up as ref.

PreferObject

No matter what, if it looks like an object prefix and has an object, use it. Note that no ref-lookup is made here which is the fastest option.

PreferRef

When an object is found for a given prefix, also check if a reference exists with that name and if it does, use that moving forward.

Fail

If there is an ambiguous situation, instead of silently choosing one over the other, fail instead.

Trait Implementations

impl Clone for RefsHint

fn clone(&self) -> RefsHint

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RefsHint

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

Formats the value using the given formatter.

impl Default for RefsHint

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq<RefsHint> for RefsHint

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for RefsHint

impl Eq for RefsHint

impl StructuralEq for RefsHint

impl StructuralPartialEq for RefsHint