zesven 1.1.0

A pure Rust implementation of the 7z archive format
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! Create an encrypted 7z archive with AES-256 encryption.
//!
//! This example demonstrates how to create password-protected archives:
//! - Setting up encryption with AES-256
//! - Configuring compression options
//! - Adding files and directories
//! - Getting compression statistics
//!
//! # Usage
//!
//! ```bash
//! cargo run --example create_encrypted --features aes -- output.7z secret_password file1.txt file2.txt
//! ```
//!
//! # Note
//!
//! This example requires the `aes` feature to be enabled.

#[cfg(feature = "aes")]
use zesven::{ArchivePath, Password, Result, WriteOptions, Writer};

#[cfg(feature = "aes")]
use std::env;

#[cfg(feature = "aes")]
fn main() -> Result<()> {
    let args: Vec<String> = env::args().collect();

    if args.len() < 4 {
        eprintln!(
            "Usage: {} <output.7z> <password> <file1> [file2...]",
            args[0]
        );
        eprintln!();
        eprintln!("Creates an encrypted 7z archive with the specified files.");
        eprintln!();
        eprintln!("Examples:");
        eprintln!("  {} secret.7z mypassword document.pdf", args[0]);
        eprintln!("  {} backup.7z strong_pass123 file1.txt file2.txt", args[0]);
        std::process::exit(1);
    }

    let output_path = &args[1];
    let password = &args[2];
    let input_files: Vec<&String> = args[3..].iter().collect();

    println!("Creating encrypted archive: {}", output_path);
    println!("Files to add: {}", input_files.len());

    // Configure write options with encryption
    let options = WriteOptions::new()
        .password(Password::new(password))
        .level(7)?; // Higher compression level (0-9)

    // Create the archive writer
    let mut writer = Writer::create_path(output_path)?.options(options);

    // Add each file to the archive
    for file_path in &input_files {
        let path = std::path::Path::new(file_path);

        if !path.exists() {
            eprintln!("Warning: File not found, skipping: {}", file_path);
            continue;
        }

        // Use the file name as the archive path
        let archive_name = path
            .file_name()
            .and_then(|n| n.to_str())
            .unwrap_or(file_path);

        let archive_path = ArchivePath::new(archive_name)?;
        println!("  Adding: {} -> {}", file_path, archive_name);

        writer.add_path(path, archive_path)?;
    }

    // Finish writing the archive
    let result = writer.finish()?;

    println!();
    println!("Archive created successfully!");
    println!("  Entries: {}", result.entries_written);
    println!("  Directories: {}", result.directories_written);
    println!("  Original size: {} bytes", result.total_size);
    println!("  Compressed size: {} bytes", result.compressed_size);
    println!(
        "  Compression ratio: {:.1}%",
        result.compression_ratio() * 100.0
    );
    println!("  Space saved: {:.1}%", result.space_savings() * 100.0);

    Ok(())
}

#[cfg(not(feature = "aes"))]
fn main() {
    eprintln!("This example requires the 'aes' feature.");
    eprintln!("Run with: cargo run --example create_encrypted --features aes -- <args>");
    std::process::exit(1);
}