Enum Head 

pub enum Head {
    Branch {
        name: Arc<str>,
        commit: ObjectId,
    },
    Detached(ObjectId),
    Unborn(Arc<str>),
}

HEAD’s three shapes, one to one with gix’s head::Kind.

Detached carries the commit and no name; Unborn carries the name and no commit; a bare Cell<Arc<str>> could hold neither distinction. Branch carries both, because an attached, born HEAD always has one: the environment contract’s REPON_HEAD needs the resolved commit on this shape too, not only on Detached.

Deferred: on the wire, gix::ObjectId’s own Serialize impl writes a commit as a raw {"Sha1":[..20 numbers..]} array rather than a hex string, because gix does not offer a hex encoding and adding one here would mean either a hand-written Serialize impl or another crate on the allowlist for one field’s cosmetics. Functionally complete, not pretty; nothing in this ticket’s acceptance criteria asks for a particular encoding.

Variants

Branch

Attached to a branch, which points at a commit.

Fields

name: Arc<str>

commit: ObjectId

Detached(ObjectId)

Detached at a commit, with no branch name.

Unborn(Arc<str>)

A branch with no commit yet: ## No commits yet on <name>.

Trait Implementations

impl Clone for Head

fn clone(&self) -> Head

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Head

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

Formats the value using the given formatter.

impl Eq for Head

impl PartialEq for Head

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Head