Struct git_repository::Commit

pub struct Commit<'repo> {
    pub id: ObjectId,
    pub data: Vec<u8>,
    /* private fields */
}

A decoded commit object with access to its owning repository.

Please note that the limitations described in Object apply here as well.

Fields

id: ObjectId

The id of the commit

data: Vec<u8>

The fully decoded commit data

Implementations

impl<'repo> Commit<'repo>

pub fn detached(&self) -> DetachedObject

Create an owned instance of this object, copying our data in the process.

pub fn detach(self) -> DetachedObject

Sever the connection to the Repository and turn this instance into a standalone object.

impl<'repo> Commit<'repo>

pub fn short_id(&self) -> Result<Prefix, Error>

Turn this objects id into a shortened id with a length in hex as configured by core.abbrev.

pub fn message(&self) -> Result<MessageRef<'_>, Error>

Parse the commits message into a MessageRef

pub fn message_raw(&self) -> Result<&BStr, Error>

Decode the entire commit object in full and return the raw message bytes.

pub fn time(&self) -> Result<Time, Error>

Decode the commit and obtain the time at which the commit was created.

For the time at which it was authored, refer to .decode()?.author.time.

pub fn decode(&self) -> Result<CommitRef<'_>, Error>

Decode the entire commit object and return it for accessing all commit information.

It will allocate only if there are more than 2 parents.

Note that the returned commit object does make lookup easy and should be used for successive calls to string-ish information to avoid decoding the object more than once.

pub fn iter(&self) -> CommitRefIter<'_>

Return an iterator over tokens, representing this commit piece by piece.

pub fn author(&self) -> Result<SignatureRef<'_>, Error>

Return the commits author, with surrounding whitespace trimmed.

pub fn committer(&self) -> Result<SignatureRef<'_>, Error>

Return the commits committer. with surrounding whitespace trimmed.

pub fn parent_ids(&self) -> impl Iterator<Item = Id<'repo>> + '_

Decode this commits parent ids on the fly without allocating.

pub fn tree(&self) -> Result<Tree<'repo>, Error>

Parse the commit and return the the tree object it points to.

pub fn tree_id(&self) -> Result<ObjectId, Error>

Parse the commit and return the the tree id it points to.

pub fn id(&self) -> Id<'repo>

Return our id own id with connection to this repository.

pub fn ancestors(&self) -> Ancestors<'repo>

Obtain a platform for traversing ancestors of this commit.

Trait Implementations

impl<'r> Debug for Commit<'r>

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

Formats the value using the given formatter.

impl<'a> Drop for Commit<'a>

fn drop(&mut self)

Executes the destructor for this type.

impl<'repo> From<Commit<'repo>> for DetachedObject

fn from(v: Commit<'repo>) -> Self

Converts to this type from the input type.

impl<'repo> From<Commit<'repo>> for Object<'repo>

fn from(v: Commit<'repo>) -> Self

Converts to this type from the input type.

impl<'repo> TryFrom<Object<'repo>> for Commit<'repo>

type Error = Object<'repo>

The type returned in the event of a conversion error.

fn try_from(value: Object<'repo>) -> Result<Self, Self::Error>

Performs the conversion.