oxidelta 0.1.4

VCDIFF (RFC 3284) delta encoder/decoder — Rust reimplementation of xdelta3
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# Oxidelta Announcement Draft

## Oxidelta 0.1.0

We are releasing **Oxidelta**, a production-focused Rust implementation of VCDIFF (RFC 3284) for delta patch generation and application.

## Why Oxidelta

- Rust-native library and CLI
- Strong test coverage (unit, integration, property tests)
- Interop validation against xdelta3
- Modern CI/release automation and cross-platform binary publishing

## Feature Comparison

| Capability | xdelta3 | Oxidelta |
|---|---|---|
| Core VCDIFF encode/decode | Yes | Yes |
| LZMA secondary compression | Yes | Yes |
| Zlib secondary compression extension | No | Yes |
| Rust library API | No | Yes |
| Idiomatic subcommand CLI | No | Yes |
| Cross-platform release automation | Varies by downstream | Built-in via GitHub Actions |

## Performance Snapshot

Benchmark reference: `PERFORMANCE.md`

```mermaid
xychart-beta
    title "Encode Throughput (MiB/s)"
    x-axis [64KiB, 1MiB, 8MiB]
    y-axis "MiB/s" 0 --> 900
    bar [780, 394, 476]
```

Sample encode latency comparison (1 MiB workload):

- Oxidelta: ~1.374587 ms
- xdelta3: ~1.580913 ms

## Migration

For xdelta CLI users:

- Migration guide: `MIGRATION.md`
- Workflow conversion script: `scripts/migrate-from-xdelta.sh`

Example:

```bash
xdelta -e -s old.bin new.bin patch.vcdiff
# becomes
oxidelta encode --source old.bin new.bin patch.vcdiff
```

## Install

```bash
cargo install --locked oxidelta
```

Prebuilt binaries for Linux, macOS, and Windows are published in GitHub Releases.