Struct ObjectIdPrefix 

pub struct ObjectIdPrefix { /* private fields */ }

Four through the full hash width hexadecimal digits in one object format.

Parsing normalizes uppercase digits and preserves odd widths. It does not establish existence or uniqueness; use crate::Objects::resolve_prefix for that.

Implementations

impl ObjectIdPrefix

pub fn from_hex( format: ObjectFormat, text: &str, ) -> Result<Self, ParseObjectIdPrefixError>

Parses ASCII hexadecimal digits for the selected repository format.

Errors

Rejects fewer than four digits, more than the full width, or non-hexadecimal input.

use girt::{ObjectFormat, ObjectIdPrefix};
let prefix = ObjectIdPrefix::from_hex(ObjectFormat::Sha1, "B6FC4")?;
assert_eq!(prefix.to_string(), "b6fc4");

Examples found in repository

examples/short_ids.rs (line 13)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut args = std::env::args().skip(1);
    let path = args
        .next()
        .ok_or("usage: short_ids <repository> <hex-prefix>")?;
    let text = args.next().ok_or("missing hexadecimal prefix")?;

    let repository = Repository::discover(path)?;
    let objects = repository.objects()?;

    let prefix = ObjectIdPrefix::from_hex(repository.object_format(), &text)?;
    let id = objects.resolve_prefix(prefix)?;
    println!("{}", objects.abbreviate(id, objects.auto_abbrev_len())?);
    Ok(())
}

pub fn object_format(self) -> ObjectFormat

The selected hash format.

pub fn hex_len(self) -> usize

Number of hexadecimal digits, including an optional final half-byte.

pub fn matches(self, id: ObjectId) -> bool

Tests the prefix without reading storage.

Trait Implementations

impl Clone for ObjectIdPrefix

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ObjectIdPrefix

impl Debug for ObjectIdPrefix

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

Formats the value using the given formatter.

impl Display for ObjectIdPrefix

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

Formats the value using the given formatter.

impl Eq for ObjectIdPrefix

impl Hash for ObjectIdPrefix

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 PartialEq for ObjectIdPrefix

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ObjectIdPrefix