Struct radicle_git_ext::commit::CommitData

pub struct CommitData<Tree, Parent> { /* private fields */ }

A git commit in its object description form, i.e. the output of git cat-file for a commit object.

Implementations

impl CommitData<Oid, Oid>

pub fn read(repo: &Repository, oid: Oid) -> Result<Self, Read>

Read the Commit from the repo that is expected to be found at oid.

pub fn write(&self, repo: &Repository) -> Result<Oid, Write>

Write the given Commit to the repo. The resulting Oid is the identifier for this commit.

impl<Tree, Parent> CommitData<Tree, Parent>

pub fn new<P, I, T>( tree: Tree, parents: P, author: Author, committer: Author, headers: Headers, message: String, trailers: I, ) -> Self

where P: IntoIterator<Item = Parent>, I: IntoIterator<Item = T>, OwnedTrailer: From<T>,

pub fn tree(&self) -> &Tree

The tree this commit points to.

pub fn parents(&self) -> impl Iterator<Item = Parent> + '_

where Parent: Clone,

The parents of this commit.

pub fn author(&self) -> &Author

The author of this commit, i.e. the header corresponding to author.

pub fn committer(&self) -> &Author

The committer of this commit, i.e. the header corresponding to committer.

pub fn message(&self) -> &str

The message body of this commit.

pub fn signatures(&self) -> impl Iterator<Item = Signature<'_>> + '_

The Signatures found in this commit, i.e. the headers corresponding to gpgsig.

pub fn headers(&self) -> impl Iterator<Item = (&str, &str)>

The Headers found in this commit.

Note: these do not include tree, parent, author, and committer.

pub fn values<'a>(&'a self, name: &'a str) -> impl Iterator<Item = &'a str> + '_

Iterate over the Headers values that match the provided name.

pub fn push_header(&mut self, name: &str, value: &str)

Push a header to the end of the headers section.

pub fn trailers(&self) -> impl Iterator<Item = &OwnedTrailer>

pub fn map_tree<U, E, F>(self, f: F) -> Result<CommitData<U, Parent>, E>

where F: FnOnce(Tree) -> Result<U, E>,

Convert the CommitData::tree into a value of type U. The conversion function f can be fallible.

For example, map_tree can be used to turn raw tree data into an Oid by writing it to a repository.

pub fn map_parents<U, E, F>(self, f: F) -> Result<CommitData<Tree, U>, E>

where F: FnMut(Parent) -> Result<U, E>,

Convert the CommitData::parents into a vector containing values of type U. The conversion function f can be fallible.

For example, map_parents can be used to resolve the Oids to their respective git2::Commits.

Trait Implementations

impl<Tree: Debug, Parent: Debug> Debug for CommitData<Tree, Parent>

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

Formats the value using the given formatter.