Rust压缩与解压库eszip的使用 - 高效处理ESZIP格式文件压缩与解压

简介

eszip是一个Rust库，专门用于处理ESZIP格式文件的压缩与解压。ESZIP是一种高效的压缩格式，特别适合需要快速压缩和解压的场景。该库提供了简单的API接口，可以轻松集成到Rust项目中。

安装

在Cargo.toml中添加依赖：

[dependencies]
eszip = "0.1"  # 请检查最新版本

基本使用方法

压缩文件

use eszip::compress;

fn main() -> std::io::Result<()> {
    let data = b"这是需要压缩的文本数据";
    let compressed = compress(data)?;
    
    // 将压缩数据写入文件
    std::fs::write("example.eszip", compressed)?;
    Ok(())
}

解压文件

use eszip::decompress;

fn main() -> std::io::Result<()> {
    let compressed_data = std::fs::read("example.eszip")?;
    let decompressed = decompress(&compressed_data)?;
    
    println!("解压后的数据: {}", String::from_utf8_lossy(&decompressed));
    Ok(())
}

高级用法

流式压缩

use eszip::Compressor;
use std::io::Write;

fn main() -> std::io::Result<()> {
    let mut compressor = Compressor::new();
    
    // 分块写入数据
    compressor.write_all(b"第一部分数据")?;
    compressor.write_all(b"第二部分数据")?;
    
    // 获取最终压缩结果
    let compressed = compressor.finish()?;
    std::fs::write("streamed.eszip", compressed)?;
    
    Ok(())
}

自定义压缩级别

use eszip::{compress_with_level, CompressionLevel};

fn main() -> std::io::Result<()> {
    let data = b"需要根据不同的压缩级别处理的数据";
    
    // 使用最快压缩
    let fast_compressed = compress_with_level(data, CompressionLevel::Fastest)?;
    
    // 使用最佳压缩率
    let best_compressed = compress_with_level(data, CompressionLevel::Best)?;
    
    Ok(())
}

完整示例

下面是一个完整的示例，展示如何使用eszip库进行文件压缩、解压和错误处理：

use eszip::{compress, decompress, compress_with_level, CompressionLevel, Compressor, Error};
use std::io::Write;

fn main() -> Result<(), Error> {
    // 示例1: 基本压缩与解压
    let original_data = b"这是示例文本数据，将被压缩和解压";
    println!("原始数据大小: {}字节", original_data.len());
    
    // 压缩数据
    let compressed_data = compress(original_data)?;
    println!("压缩后大小: {}字节", compressed_data.len());
    
    // 解压数据
    let decompressed_data = decompress(&compressed_data)?;
    println!("解压后数据: {}", String::from_utf8_lossy(&decompressed_data));
    
    // 示例2: 流式压缩
    let mut compressor = Compressor::new();
    compressor.write_all(b"第一部分流数据")?;
    compressor.write_all(b"第二部分流数据")?;
    let stream_compressed = compressor.finish()?;
    
    // 示例3: 不同压缩级别
    let data = b"测试不同压缩级别的性能差异";
    let fast = compress_with_level(data, CompressionLevel::Fastest)?;
    let best = compress_with_level(data, CompressionLevel::Best)?;
    println!("最快压缩大小: {}, 最佳压缩大小: {}", fast.len(), best.len());
    
    // 示例4: 错误处理
    match decompress(b"无效数据") {
        Ok(_) => println!("解压成功"),
        Err(Error::InvalidFormat) => eprintln!("错误: 无效的压缩格式"),
        Err(e) => eprintln!("其他错误: {}", e),
    }
    
    Ok(())
}

性能提示

1. 对于大文件，建议使用流式处理以避免内存问题
2. 根据场景选择合适的压缩级别
3. ESZIP格式特别适合需要快速解压的场景

错误处理

use eszip::{decompress, Error};

fn try_decompress(path: &str) -> Result<Vec<u8>, Error> {
    let compressed_data = std::fs::read(path)?;
    decompress(&compressed_data)
}

fn main() {
    match try_decompress("invalid.eszip") {
        Ok(data) => println!("解压成功: {}字节", data.len()),
        Err(Error::InvalidFormat) => eprintln!("文件格式无效"),
        Err(e) => eprintln!("解压失败: {}", e),
    }
}

eszip库提供了简单高效的ESZIP格式处理能力，适合需要快速压缩解压操作的Rust应用场景。