zstd

这个库是zstd压缩库的Rust绑定。

文档

1 - 添加到 cargo.toml

$ cargo add zstd

# Cargo.toml

[dependencies]
zstd = "0.13"

2 - 使用方法

该库提供了Read和Write包装器来处理压缩和解压缩，以及方便的函数来简化常见任务。

例如，stream::copy_encode和stream::copy_decode是围绕std::io::copy的易于使用的包装器。请查看stream示例

use std::io;

// This function use the convenient `copy_encode` method
fn compress(level: i32) {
    zstd::stream::copy_encode(io::stdin(), io::stdout(), level).unwrap();
}

// This function does the same thing, directly using an `Encoder`:
fn compress_manually(level: i32) {
    let mut encoder = zstd::stream::Encoder::new(io::stdout(), level).unwrap();
    io::copy(&mut io::stdin(), &mut encoder).unwrap();
    encoder.finish().unwrap();
}

fn decompress() {
    zstd::stream::copy_decode(io::stdin(), io::stdout()).unwrap();
}

异步支持

async-compression crate提供了包括zstd-rs在内的各种压缩算法的异步集成。

自行编译

zstd作为子模块包含在内。要在克隆时获取所有内容，请使用

git clone https://github.com/gyscos/zstd-rs --recursive

或者，如果您没有使用--recursive标志克隆，请从仓库内部调用此命令

git submodule update --init

然后，运行cargo build应该会处理构建C库并将其链接到库中。

编译时bindgen

此库包含一个预生成的bindings.rs文件。您还可以使用bindgen功能在编译时生成新的绑定。

cargo build --features bindgen

待办事项

• 基准测试，优化...

免责声明

此实现主要受bozaro的lz4-rs的启发。

许可证

• zstd C库采用双重BSD/GPLv2许可证。
• 此zstd-rs绑定库采用MIT许可证。