lz4_flex

Fastest LZ4 implementation in Rust. Originally based on redox-os' lz4 compression, but now a complete rewrite. The results in the table are from a benchmark in this project (66Kb JSON).

Compressor	Compression	Decompression
lz4_flex unsafe	711 MiB/s	3733 MiB/s
lz4_flex safe	628 MiB/s	1433 MiB/s
lz4_cpp	914 MiB/s	3793 MiB/s
lz4_fear	443 MiB/s	836 MiB/s

Features

Very good logo
LZ4 Block format
High performance
1s clean release build time
Feature flags to configure safe/unsafe code usage

Usage:

Compression and decompression uses no usafe via the default feature flags "safe-encode" and "safe-decode". If you need more performance you can disable them (e.g. with no-default-features).

Safe:

lz4_flex = { version = "0.5.1" }

Performance:

lz4_flex = { version = "0.5.1", default-features = false }

use lz4_flex::{compress_prepend_size, decompress_size_prepended};

fn main(){
    let input: &[u8] = b"Hello people, what's up?";
    let compressed = compress_prepend_size(input);
    let uncompressed = decompress_size_prepended(&compressed).unwrap();
    assert_eq!(input, uncompressed);
}

Benchmarks

The benchmark is run with criterion, the test files are in the benches folder.

Currently 3 implementations are compared, this one, the redox-version, lz-fear and the c++ version via rust bindings. The lz4-flex version is tested with the feature flags safe-decode and safe-encode switched on and off.