Struct git_pack::Bundle

pub struct Bundle {
    pub pack: File,
    pub index: File,
}

A bundle of pack data and the corresponding pack index

Fields

pack: File

The pack file corresponding to index

index: File

The index file corresponding to pack

Implementations

impl Bundle

Initialization

pub fn at(path: impl AsRef<Path>, object_hash: Kind) -> Result<Self, Error>

Create a Bundle from path, which is either a pack file (*.pack) or an index file (*.idx).

The corresponding complementary file is expected to be present.

The object_hash is a way to read (and write) the same file format with different hashes, as the hash kind isn’t stored within the file format itself.

impl Bundle

pub fn find<'a>( &self, id: impl AsRef<oid>, out: &'a mut Vec<u8>, cache: &mut impl DecodeEntry ) -> Result<Option<(Data<'a>, Location)>, Error>

Find an object with the given ObjectId and place its data into out.

cache is used to accelerate the lookup.

Note that ref deltas are automatically resolved within this pack only, which makes this implementation unusable for thin packs, which by now are expected to be resolved already.

pub fn get_object_by_index<'a>( &self, idx: u32, out: &'a mut Vec<u8>, cache: &mut impl DecodeEntry ) -> Result<(Data<'a>, Location), Error>

Special-use function to get an object given an index previously returned from internal_find_pack_index.

Panics

If index is out of bounds.

impl Bundle

pub fn verify_integrity<C, P, F>( &self, progress: P, should_interrupt: &AtomicBool, options: Options<F> ) -> Result<Outcome<P>, Error<Error>>where P: Progress, C: DecodeEntry, F: Fn() -> C + Send + Clone,

Similar to crate::index::File::verify_integrity() but more convenient to call as the presence of the pack file is a given.