Struct qbsdiff::bsdiff::Bsdiff

pub struct Bsdiff<'s, 't> { /* fields omitted */ }

Fast and memory saving bsdiff 4.x compatible delta compressor for execuatbles.

Source data size should not be greater than MAX_LENGTH (about 4 GiB).

Compares source with target and generates patch using the best compression level:

use std::io;
use qbsdiff::{Bsdiff, Compression};

fn bsdiff(source: &[u8], target: &[u8]) -> io::Result<Vec<u8>> {
    let mut patch = Vec::new();
    Bsdiff::new(source, target)
        .compression_level(Compression::Best)
        .compare(io::Cursor::new(&mut patch))?;
    Ok(patch)
}

Methods

impl<'s, 't> Bsdiff<'s, 't>

pub fn new(source: &'s [u8], target: &'t [u8]) -> Self

Create new configuration for bsdiff delta compression.

Panics if the length of source data is greater than MAX_LENGTH.

pub fn source(self, s: &'s [u8]) -> Self

Set the source data.

pub fn target(self, t: &'t [u8]) -> Self

Set the target data.

pub fn small_match(self, sm: usize) -> Self

Set the threshold to determine small match (default is SMALL_MATCH). If set to zero, no matches would be skipped.

pub fn compression_level(self, lv: Compression) -> Self

Set the compression level of bzip2 (default is LEVEL).

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

Set the buffer size for delta calculation (bs >= 128, default is BUFFER_SIZE).

pub fn compare<P: Write>(&self, patch: P) -> Result<u64>

Start searching matches in target and constructing the patch file.

The size of patch file would be returned if no error occurs.