Enum git_repository::easy::head::Kind

pub enum Kind {
    Symbolic(Reference),
    Unborn(FullName),
    Detached {
        target: ObjectId,
        peeled: Option<ObjectId>,
    },
}

Represents the kind of HEAD reference.

Variants

Symbolic(Reference)

The existing reference the symbolic HEAD points to.

This is the common case.

Tuple Fields of Symbolic

0: Reference

Unborn(FullName)

The yet-to-be-created reference the symbolic HEAD refers to.

This is the case in a newly initialized repository.

Tuple Fields of Unborn

0: FullName

Detached

The head points to an object directly, not to a symbolic reference.

This state is less common and can occur when checking out commits directly.

Fields of Detached

target: ObjectId

The object to which the head points to

peeled: Option<ObjectId>

Possibly the final destination of target after following the object chain from tag objects to commits.

Implementations

impl Kind

pub fn attach<A>(self, access: &A) -> Head<'_, A>

Attach this instance with an access reference to produce a Head.