Rust 7z压缩解压库sevenz-rust的使用指南

简介

sevenz-rust是一个用于处理7z格式文件的纯Rust库，提供了压缩和解压7z文件的功能。它不依赖外部二进制文件或系统库，完全在Rust生态中实现。

主要特性

• 支持7z格式的压缩和解压
• 纯Rust实现，无外部依赖
• 支持多种压缩算法（LZMA/LZMA2等）
• 支持密码保护的压缩文件
• 跨平台支持

安装

在Cargo.toml中添加依赖：

[dependencies]
sevenz-rust = "0.2"

基本使用方法

解压7z文件

use sevenz_rust::SevenZArchive;
use std::path::Path;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 解压文件
    SevenZArchive::extract(
        Path::new("archive.7z"), 
        Path::new("output_dir")
    )?;
    Ok(())
}

带密码解压

use sevenz_rust::{SevenZArchive, Password};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    SevenZArchive::extract_with_password(
        "archive.7z", 
        "output_dir", 
        Password::from("mypassword")
    )?;
    Ok(())
}

创建7z压缩文件

use sevenz_rust::{SevenZArchive, SevenZArchiveEntry, SevenZMethod};
use std::path::Path;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut archive = SevenZArchive::create("output.7z")?;
    
    // 添加文件到压缩包
    archive.push_archive_entry(
        SevenZArchiveEntry::from_path(Path::new("file1.txt"), "file1.txt")?
            .set_method(SevenZMethod::LZMA)
    );
    
    // 添加整个目录
    archive.push_source_dir(Path::new("docs"), "docs")?;
    
    archive.write()?;
    Ok(())
}

带密码压缩

use sevenz_rust::{SevenZArchive, SevenZArchiveEntry, SevenZMethod, Password};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut archive = SevenZArchive::create_with_password(
        "secure.7z", 
        Password::from("secret123")
    )?;
    
    archive.push_archive_entry(
        SevenZArchiveEntry::from_path("sensitive.txt", "sensitive.txt")?
            .set_method(SevenZMethod::LZMA2)
    );
    
    archive.write()?;
    Ok(())
}

高级用法

自定义压缩参数

use sevenz_rust::{SevenZArchive, SevenZArchiveEntry, SevenZMethod, SevenZWriterOptions};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let options = SevenZWriterOptions {
        method: SevenZMethod::LZMA2,
        level: 9, // 压缩级别 1-9
        ..Default::default()
    };
    
    let mut archive = SevenZArchive::create_with_options("custom.7z", options)?;
    
    archive.push_archive_entry(
        SevenZArchiveEntry::from_path("large_file.bin", "large_file.bin")?
    );
    
    archive.write()?;
    Ok(())
}

处理大文件

use sevenz_rust::{SevenZArchive, SevenZArchiveEntry, SevenZMethod};
use std::fs::File;
use std::io::{self, BufReader};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut archive = SevenZArchive::create("large_files.7z")?;
    
    // 使用流式处理大文件
    let file = File::open("very_large_file.bin")?;
    let reader = BufReader::new(file);
    
    archive.push_archive_entry(
        SevenZArchiveEntry::from_reader(reader, "very_large_file.bin")?
            .set_method(SevenZMethod::LZMA2)
    );
    
    archive.write()?;
    Ok(())
}

完整示例

下面是一个完整的示例，演示如何压缩一个目录并设置密码保护：

use sevenz_rust::{SevenZArchive, SevenZArchiveEntry, SevenZMethod, Password};
use std::path::Path;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 创建带密码的7z压缩文件
    let mut archive = SevenZArchive::create_with_password(
        "backup.7z", 
        Password::from("mysecurepassword")
    )?;
    
    // 添加单个文件
    archive.push_archive_entry(
        SevenZArchiveEntry::from_path(Path::new("important.txt"), "important.txt")?
            .set_method(SevenZMethod::LZMA2)
    );
    
    // 添加整个目录
    archive.push_source_dir(Path::new("data"), "backup_data")?;
    
    // 写入压缩文件
    archive.write()?;
    
    println!("压缩完成！");
    Ok(())
}

注意事项

1. 对于非常大的文件，考虑使用流式处理以避免内存问题
2. 密码保护的7z文件使用AES-256加密
3. 目前不支持多卷压缩文件
4. 解压进度可以通过实现Progress trait来监控

sevenz-rust库提供了简单而强大的接口来处理7z文件，适合需要纯Rust解决方案的项目。