Struct git_repository::easy::ObjectRef

pub struct ObjectRef<'repo, A> {
    pub id: ObjectId,
    pub kind: Kind,
    pub data: Ref<'repo, [u8]>,
    // some fields omitted
}

A decoded object with a reference to its owning repository.

Limitations

Note that it holds a reference to a buffer of it’s associated repository handle, so there can only be one at a time, per handle.

Fields

id: ObjectId

The id of the object

kind: Kind

The kind of the object

data: Ref<'repo, [u8]>

The fully decoded object data

Implementations

impl<'repo, A> ObjectRef<'repo, A> where
    A: Access + Sized, 

pub fn peel_to_kind(self, kind: Kind) -> Result<Self, Error>

Follow tags to their target and commits to trees until the given kind of object is encountered.

Note that this object doesn’t necessarily have to be the end of the chain. Typical values are Kind::Commit or Kind::Tree.

pub fn peel_tags_to_end(self) -> Result<Self, Error>

Follow all tag object targets until a commit, tree or blob is reached.

Note that this method is different from peel_to_kind(…) as it won’t peel commits to their tree, but handles tags only.

impl<'repo, A> ObjectRef<'repo, A> where
    A: Access + Sized, 

pub fn into_tree(self) -> TreeRef<'repo, A>

Transform this object into a tree, or panic if it is none.

pub fn try_into_tree(self) -> Result<TreeRef<'repo, A>, Self>

Transform this object into a tree, or return it as part of the Err if it is no tree.

impl<'repo, A> ObjectRef<'repo, A>

pub fn to_owned(&self) -> Object

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

pub fn into_owned(self) -> Object

Turn this instance into an owned one, copying our data in the process.

pub fn detach(self) -> Object

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

Note that the data buffer will be copied in the process.

impl<'repo, A> ObjectRef<'repo, A> where
    A: Access + Sized, 

pub fn to_commit(&self) -> CommitRef<'_>

Obtain a fully parsed commit whose fields reference our data buffer,

Panic

• this object is not a commit
• the commit could not be decoded

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

Obtain a fully parsed commit whose fields reference our data buffer.

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

Obtain a an iterator over commit tokens like in to_commit_iter().

Panic

• this object is not a commit

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

Obtain a commit token iterator from the data in this instance, if it is a commit.

pub fn to_tag_iter(&self) -> TagRefIter<'_>

Obtain a tag token iterator from the data in this instance.

Panic

• this object is not a tag

pub fn try_to_tag_iter(&self) -> Option<TagRefIter<'_>>

Obtain a tag token iterator from the data in this instance.

Panic

• this object is not a tag

pub fn to_tag(&self) -> TagRef<'_>

Obtain a tag object from the data in this instance.

Panic

• this object is not a tag
• the tag could not be decoded

pub fn try_to_tag(&self) -> Result<TagRef<'_>, Error>

Obtain a fully parsed tag object whose fields reference our data buffer.

Trait Implementations

impl<'repo, A> AsRef<[u8]> for ObjectRef<'repo, A>

fn as_ref(&self) -> &[u8]

Performs the conversion.

impl<'repo, A> Debug for ObjectRef<'repo, A>

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

Formats the value using the given formatter.

impl<'repo, A> From<ObjectRef<'repo, A>> for Object

fn from(r: ObjectRef<'repo, A>) -> Self

Performs the conversion.

impl<'repo, A, B> PartialEq<ObjectRef<'repo, A>> for Oid<'repo, B>

fn eq(&self, other: &ObjectRef<'repo, A>) -> bool

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

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

This method tests for !=.

impl<'repo, A> TryFrom<ObjectRef<'repo, A>> for TreeRef<'repo, A>

type Error = ObjectRef<'repo, A>

The type returned in the event of a conversion error.

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

Performs the conversion.