https://github.com/space-wizards/bsdiff-rs

Binary diffing algorithm implemented in Rust
https://github.com/space-wizards/bsdiff-rs

bsdiff rust

Last synced: about 1 month ago
JSON representation

Binary diffing algorithm implemented in Rust

• Host: GitHub
• URL: https://github.com/space-wizards/bsdiff-rs
• Owner: space-wizards
• License: other
• Created: 2017-06-23T23:01:18.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-11T15:58:48.000Z (9 months ago)
• Last Synced: 2024-10-30T05:41:55.213Z (about 2 months ago)
• Topics: bsdiff, rust
• Language: Rust
• Homepage:
• Size: 1.43 MB
• Stars: 40
• Watchers: 15
• Forks: 11
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# bsdiff-rs

[![GitHub](https://img.shields.io/badge/github-bsdiff-8da0cb?logo=github)](https://github.com/space-wizards/bsdiff-rs)

[![crates.io version](https://img.shields.io/crates/v/bsdiff.svg)](https://crates.io/crates/bsdiff)

[![docs.rs docs](https://docs.rs/bsdiff/badge.svg)](https://docs.rs/bsdiff)

[![crates.io version](https://img.shields.io/crates/l/bsdiff.svg)](https://github.comspace-wizards/bsdiff-rss/blob/main/LICENSE-APACHE)

[![CI build](https://github.com/space-wizards/bsdiff-rs/actions/workflows/rust.yml/badge.svg)](https://github.com/space-wizards/bsdiff-rs/actions)

Bsdiff is a method of diffing files. This crate is a port of a [bsdiff library](https://github.com/mendsley/bsdiff).

High performance patching. All written in safe

Rust.

It is usually a good idea to use bsdiff alongside a compression algorithm like bzip2.

## Usage

```rust

fn main() {

    let one = vec![1, 2, 3, 4, 5];

    let two = vec![1, 2, 4, 6];

    let mut patch = Vec::new();

    bsdiff::diff(&one, &two, &mut patch).unwrap();

    let mut patched = Vec::with_capacity(two.len());

    bsdiff::patch(&one, &mut patch.as_slice(), &mut patched).unwrap();

    assert_eq!(patched, two);

}

```

## Diffing Files

```rust

fn diff_files(file_a: &str, file_b: &str, patch_file: &str) -> std::io::Result<()> {

    let old = std::fs::read(file_a)?;

    let new = std::fs::read(file_b)?;

    let mut patch = Vec::new();

    bsdiff::diff(&old, &new, &mut patch)?;

    // TODO: compress `patch` here

    std::fs::write(patch_file, &patch)

}

```

## Patching Files

```rust

fn patch_file(file_a: &str, patch_file: &str, file_b: &str) -> std::io::Result<()> {

    let old = std::fs::read(file_a)?;

    let patch = std::fs::read(patch_file)?;

    // TODO: decompress `patch` here

    let mut new = Vec::new();

    bsdiff::patch(&old, &mut patch.as_slice(), &mut new)?;

    std::fs::write(file_b, &new)

}

```