Struct qbsdiff::bspatch::Bspatch

pub struct Bspatch<'p> { /* fields omitted */ }

Fast and memory saving patcher comaptible with bspatch.

Apply patch to source using a 4k buffer:

use std::io;
use qbsdiff::Bspatch;

fn bspatch(source: &[u8], patch: &[u8]) -> io::Result<Vec<u8>> {
    let mut target = Vec::new();
    Bspatch::new(patch)?
        .buffer_size(4096)
        .apply(source, io::Cursor::new(&mut target))?;
    Ok(target)
}

Preallocate target vector before applying patch:

use std::io;
use qbsdiff::Bspatch;

fn bspatch(source: &[u8], patch: &[u8]) -> io::Result<Vec<u8>> {
    let patcher = Bspatch::new(patch)?;
    let mut target = Vec::with_capacity(patcher.hint_target_size() as usize);
    patcher.apply(source, io::Cursor::new(&mut target))?;
    Ok(target)
}

Methods

impl<'p> Bspatch<'p>

pub fn new(patch: &'p [u8]) -> Result<Self>

Parse the patch file and create new patcher configuration.

Return error if failed to parse the patch header.

pub fn buffer_size(self, bs: usize) -> Self

Set the main copy buffer size, (bs > 128, default is BUFFER_SIZE).

pub fn delta_min(self, dm: usize) -> Self

Sets the initial delta cache size, (dm > 128, default is DELTA_MIN).

The delta cache is dynamic and can grow up when needed (but keeps not greater than the size of main copy buffer).

This might be deprecated in later version.

pub fn hint_target_size(&self) -> u64

Hint the final target file size, as provided in the patch header.

pub fn apply<T: Write>(self, source: &[u8], target: T) -> Result<u64>

Apply patch to the source data and output the stream of target.

The target data size would be returned if no error occurs.