Enum Header 

pub enum Header {
    Commit,
    Tree,
    Blob,
    Tag,
    RefDelta {
        base_id: ObjectId,
    },
    OfsDelta {
        base_distance: u64,
    },
}

The header portion of a pack data entry, identifying the kind of stored object.

Variants

Commit

The object is a commit

Tree

The object is a tree

Blob

The object is a blob

Tag

The object is a tag

RefDelta

Describes a delta-object which needs to be applied to a base identified by base_id. The base may occur anywhere in the same pack or in the parent repository, as it does in a thin-pack.

The naming is exactly the same as the canonical implementation uses, namely REF_DELTA.

Fields

base_id: ObjectId

OfsDelta

Describes a delta-object present in this pack which acts as base for this object. The base object is measured as a distance from this objects pack offset, so that base_pack_offset = this_objects_pack_offset - base_distance

Note

The naming is exactly the same as the canonical implementation uses, namely OFS_DELTA.

Fields

base_distance: u64

Implementations

impl Header

pub fn verified_base_pack_offset( pack_offset: Offset, distance: u64, ) -> Option<Offset>

Subtract distance from pack_offset safely without the chance for overflow or no-ops if distance is 0.

pub fn as_kind(&self) -> Option<Kind>

Convert the header’s object kind into gix_object::Kind if possible

pub fn as_type_id(&self) -> u8

Convert this header’s object kind into the packs internal representation

pub fn is_delta(&self) -> bool

Return’s true if this is a delta object, i.e. not a full object.

pub fn is_base(&self) -> bool

Return’s true if this is a base object, i.e. not a delta object.

impl Header

pub fn write_to( &self, decompressed_size_in_bytes: u64, out: &mut dyn Write, ) -> Result<usize>

Encode this header along the given decompressed_size_in_bytes into the out write stream for use within a data pack.

Returns the amount of bytes written to out. decompressed_size_in_bytes is the full size in bytes of the object that this header represents

pub fn size(&self, decompressed_size: u64) -> usize

The size of the header in bytes when written in canonical form.

This is the number of bytes Self::write_to() would emit for decompressed_size. It does not inspect existing pack bytes and therefore does not preserve non-canonical overlong size encodings. Use data::Entry::header_size() for decoded entries when the result has to match the header length present in the pack.

Trait Implementations

impl Clone for Header

fn clone(&self) -> Header

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Header

impl Debug for Header

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Header

Available on crate feature serde only.

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Header

impl Hash for Header

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Header

fn cmp(&self, other: &Header) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Header

fn eq(&self, other: &Header) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Header

fn partial_cmp(&self, other: &Header) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Header

Available on crate feature serde only.

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Header