#lzma #xz #encoding


Rust bindings to liblzma providing Read/Write streams as well as low-level in-memory encoding/decoding

7 releases

Uses old Rust 2015

0.1.6 Oct 11, 2018
0.1.5 May 9, 2018
0.1.4 Dec 31, 2017
0.1.3 Apr 12, 2017
0.1.0 Mar 21, 2016

#99 in Compression

Download history 12668/week @ 2020-11-04 12526/week @ 2020-11-11 13228/week @ 2020-11-18 13569/week @ 2020-11-25 12300/week @ 2020-12-02 11919/week @ 2020-12-09 11735/week @ 2020-12-16 7651/week @ 2020-12-23 9483/week @ 2020-12-30 12644/week @ 2021-01-06 11212/week @ 2021-01-13 12028/week @ 2021-01-20 10661/week @ 2021-01-27 10774/week @ 2021-02-03 10927/week @ 2021-02-10 11854/week @ 2021-02-17

62,137 downloads per month
Used in 87 crates (65 directly)


24K SLoC

C 18K SLoC // 0.2% comments Visual Studio Project 2K SLoC Rust 1.5K SLoC // 0.0% comments Automake 560 SLoC // 0.2% comments Shell 333 SLoC // 0.3% comments GNU Style Assembly 294 SLoC // 0.4% comments BASH 244 SLoC // 0.3% comments Visual Studio Solution 146 SLoC


Build Status Build status


Bindings to the liblzma implementation in Rust, also provides types to read/write xz streams.

# Cargo.toml
xz2 = "0.1"


This project is licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


LZMA/XZ encoding and decoding streams

This library is a binding to liblzma currently to provide LZMA and xz encoding/decoding streams. I/O streams are provided in the read, write, and bufread modules (same types, different bounds). Raw in-memory compression/decompression is provided via the stream module and contains many of the raw APIs in liblzma.


use std::io::prelude::*;
use xz2::read::{XzEncoder, XzDecoder};

// Round trip some bytes from a byte source, into a compressor, into a
// decompressor, and finally into a vector.
let data = "Hello, World!".as_bytes();
let compressor = XzEncoder::new(data, 9);
let mut decompressor = XzDecoder::new(compressor);

let mut contents = String::new();
decompressor.read_to_string(&mut contents).unwrap();
assert_eq!(contents, "Hello, World!");

Async I/O

This crate optionally can support async I/O streams with the Tokio stack via the tokio feature of this crate:

xz2 = { version = "0.3", features = ["tokio"] }

All methods are internally capable of working with streams that may return ErrorKind::WouldBlock when they're not ready to perform the particular operation.

Note that care needs to be taken when using these objects, however. The Tokio runtime, in particular, requires that data is fully flushed before dropping streams. For compatibility with blocking streams all streams are flushed/written when they are dropped, and this is not always a suitable time to perform I/O. If I/O streams are flushed before drop, however, then these operations will be a noop.