xzip 0.1.0

ZIP CLI with explicit filename encoding for pack and unpack workflows.
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

use std::path::PathBuf;

use clap::{Parser, Subcommand};

#[derive(Parser, Debug)]
#[command(
    name = "xzip",
    version,
    about = "ZIP tool with explicit filename encoding control",
    long_about = "Pack and unpack ZIP archives with configurable filename encoding.\n\
                  Defaults to utf-8 when --encoding is omitted; use -e gbk (or cp936) \
                  for archives created on zh_CN Windows systems."
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Command,
}

#[derive(Subcommand, Debug)]
pub enum Command {
    /// Pack a directory or file into a ZIP archive.
    Pack {
        /// Input file or directory to archive.
        #[arg(short = 'i', long)]
        input: PathBuf,
        /// Output ZIP file path.
        #[arg(short = 'o', long)]
        output: PathBuf,
        /// Filename encoding for ZIP entry names (default: utf-8).
        #[arg(short = 'e', long, value_name = "ENCODING", default_value = "utf-8")]
        encoding: String,
        /// Recursively include nested files and directories.
        #[arg(short = 'r', long)]
        recursive: bool,
        /// Only include paths matching this glob (repeatable).
        #[arg(long = "include", value_name = "GLOB")]
        include: Vec<String>,
        /// Exclude paths matching this glob (repeatable).
        #[arg(long = "exclude", value_name = "GLOB")]
        exclude: Vec<String>,
    },
    /// Unpack a ZIP archive using a specific filename encoding.
    Unpack {
        /// Input ZIP archive path.
        #[arg(short = 'i', long)]
        input: PathBuf,
        /// Output directory for extracted files.
        #[arg(short = 'o', long)]
        output: PathBuf,
        /// Filename encoding used for ZIP entry names (default: utf-8).
        #[arg(short = 'e', long, value_name = "ENCODING", default_value = "utf-8")]
        encoding: String,
        /// Only extract paths matching this glob (repeatable).
        #[arg(long = "include", value_name = "GLOB")]
        include: Vec<String>,
        /// Skip paths matching this glob (repeatable).
        #[arg(long = "exclude", value_name = "GLOB")]
        exclude: Vec<String>,
    },
}