gix-object 0.64.1

Immutable and mutable git objects with decoding and encoding support
Documentation
use bstr::ByteSlice;

use crate::parse::parse_signature;
use crate::{Tag, TagRef};

mod decode;

///
pub mod write;

///
pub mod ref_iter;

impl<'a> TagRef<'a> {
    /// Deserialize a tag from `data`.
    pub fn from_bytes(mut data: &'a [u8], hash_kind: gix_hash::Kind) -> Result<TagRef<'a>, crate::decode::Error> {
        let input = &mut data;
        match decode::git_tag(input, hash_kind) {
            Ok(tag) => Ok(tag),
            Err(err) => Err(err),
        }
    }
    /// The object this tag points to as `Id`.
    pub fn target(&self) -> gix_hash::ObjectId {
        gix_hash::ObjectId::from_hex(self.target).expect("prior validation")
    }

    /// Return the tagger, if present.
    pub fn tagger(&self) -> Result<Option<gix_actor::SignatureRef<'a>>, crate::decode::Error> {
        Ok(self
            .tagger
            .map(parse_signature)
            .transpose()?
            .map(|signature| signature.trim()))
    }

    /// Return the in-body cryptographic signature and its detected format.
    pub fn signature(&self) -> Option<crate::signature::SignatureRef<'a>> {
        self.signature.and_then(|data| {
            crate::signature::Format::from_signature(data).map(|format| crate::signature::SignatureRef { format, data })
        })
    }

    /// Copy all data into a fully-owned instance.
    pub fn into_owned(self) -> Result<crate::Tag, crate::decode::Error> {
        self.try_into()
    }
}

impl Tag {
    /// Return the in-body cryptographic signature and its detected format.
    pub fn signature(&self) -> Option<crate::signature::SignatureRef<'_>> {
        self.signature.as_ref().and_then(|data| {
            let data = data.as_bstr();
            crate::signature::Format::from_signature(data).map(|format| crate::signature::SignatureRef { format, data })
        })
    }
}