Struct branchless::git::ResolvedReferenceInfo[][src]

pub struct ResolvedReferenceInfo<'a> {
    pub oid: Option<NonZeroOid>,
    pub reference_name: Option<Cow<'a, OsStr>>,
}
Expand description

A snapshot of information about a certain reference. Updates to the reference after this value is obtained are not reflected.

HEAD is typically a symbolic reference, which means that it’s a reference that points to another reference. Usually, the other reference is a branch. In this way, you can check out a branch and move the branch (e.g. by committing) and HEAD is also effectively updated (you can traverse the pointed-to reference and get the current commit OID).

There are a couple of interesting edge cases to worry about:

  • HEAD is detached. This means that it’s pointing directly to a commit and is not a symbolic reference for the time being. This is uncommon in normal Git usage, but very common in git-branchless usage.
  • HEAD is unborn. This means that it doesn’t even exist yet. This happens when a repository has been freshly initialized, but no commits have been made, for example.

Fields

oid: Option<NonZeroOid>

The OID of the commit that HEAD points to. If HEAD is unborn, then this is None.

reference_name: Option<Cow<'a, OsStr>>

The name of the reference that HEAD points to symbolically. If HEAD is detached, then this is None.

Implementations

Get the name of the branch, if any. Returns None if HEAD is detached. The refs/heads/ prefix, if any, is stripped.

Trait Implementations

Formats the value using the given formatter. Read more

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

This method tests for !=.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Compare self to key and return true if they are equal.

Performs the conversion.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Performs the conversion.

Set the foreground color generically Read more

Set the background color generically. Read more

Change the foreground color to black

Change the foreground color to black

Change the foreground color to red

Change the foreground color to red

Change the foreground color to green

Change the foreground color to green

Change the foreground color to yellow

Change the foreground color to yellow

Change the foreground color to blue

Change the foreground color to blue

Change the foreground color to magenta

Change the foreground color to magenta

Change the foreground color to purple

Change the foreground color to purple

Change the foreground color to cyan

Change the foreground color to cyan

Change the foreground color to white

Change the foreground color to white

Change the foreground color to bright black

Change the foreground color to bright black

Change the foreground color to bright red

Change the foreground color to bright red

Change the foreground color to bright green

Change the foreground color to bright green

Change the foreground color to bright yellow

Change the foreground color to bright yellow

Change the foreground color to bright blue

Change the foreground color to bright blue

Change the foreground color to bright magenta

Change the foreground color to bright magenta

Change the foreground color to bright purple

Change the foreground color to bright purple

Change the foreground color to bright cyan

Change the foreground color to bright cyan

Change the foreground color to bright white

Change the foreground color to bright white

Make the text bold

Make the text dim

Make the text italicized

Make the text italicized

Make the text blink

Make the text blink (but fast!)

Swap the foreground and background colors

Hide the text

Cross out the text

Set the foreground color at runtime. Only use if you do not know which color will be used at compile-time. If the color is constant, use either OwoColorize::fg or a color-specific method, such as OwoColorize::green, Read more

Set the background color at runtime. Only use if you do not know what color to use at compile-time. If the color is constant, use either OwoColorize::bg or a color-specific method, such as OwoColorize::on_yellow, Read more

Sets the foreground color to an RGB value.

Sets the background color to an RGB value.

Apply a runtime-determined style

The alignment of pointer.

The type for initializers.

Initializes a with the given initializer. Read more

Dereferences the given pointer. Read more

Mutably dereferences the given pointer. Read more

Drops the object pointed to by the given pointer. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Calls the given closure and return the result. Read more

Calls the given closure on self.

Calls the given closure on self.

Calls the given closure if condition == true.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more