Struct qbsdiff::bsdiff::Bsdiff

pub struct Bsdiff<'s> { /* 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)
        .compression_level(Compression::Best)
        .compare(target, io::Cursor::new(&mut patch))?;
    Ok(patch)
}

Methods

impl<'s> Bsdiff<'s>

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

Prepares for delta compression and immediately sorts the suffix array.

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

pub fn dismatch_count(self, dis: usize) -> Self

Sets the threshold to determine dismatch (dis > 0, default is DISMATCH_COUNT).

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

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

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

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

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

Starts searching matches in target and constructing the patch file.

Returns the final size of bsdiff 4.x compatible patch file.