1 unstable release

0.1.0 Apr 7, 2020

#58 in #delta

GPL-2.0+

16KB
386 lines

Rust FFI bindings for librsync2

Dynamically linked to librsync2 / librsync-dev

Features

  • Whole File API
    • Generate Signature
    • Load signature into memory
    • Create Delta
    • Apply delta onto file
  • Streaming API
  • Error handling

Usage

File API

Generating a Signature

Signatures are stored in memory even though the whole file api is used. Temporary directories are utilized to hold values until they get initialized in memory.

let path = PathBuf::from("some/file/location");
let (signature, stats) = Signature::new(&path).unwrap;

Generating a delta

Delta files are a Vec<u8> representations of rsync delta files. A delta takes a file signature and some new file to compute against

let path = PathBuf::from("some/file/location");
let (signature, stats) = Signature::new(&path).unwrap;

let some_new_path = PathBuf::from("the/file/changed/maybe");
let (delta, stats) = Delta::new(&mut signature, &some_new_path);

Applying a delta to a file

let path = PathBuf::from("some/file/location");
let (signature, stats) = Signature::new(&path).unwrap;

let some_new_path = PathBuf::from("the/file/changed/maybe");
let (delta, stats) = Delta::new(&mut signature, &some_new_path);

// will output the value of the new file as a Vec<u8> 
let new_file = patch_file(&path, delta);

Dependencies

~1.6–9.5MB
~99K SLoC