rz-archive 0.15.0

Multi-format archive tool — tar, zip, 7z with a unified CLI
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use std::io;

use camino::Utf8PathBuf;

pub type Result<T> = std::result::Result<T, Error>;

#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("{0}")]
    Io(#[from] io::Error),

    #[error("unsupported format: {0}")]
    UnsupportedFormat(String),

    #[error("cannot infer format from path: {0}")]
    CannotInferFormat(Utf8PathBuf),

    #[error("cannot infer output path; specify --output")]
    CannotInferOutput,

    #[error("path is not valid UTF-8: {0}")]
    InvalidUtf8Path(String),

    #[error("7z: {0}")]
    SevenZ(#[from] sevenz_rust2::Error),

    #[error("zip: {0}")]
    Zip(#[from] zip::result::ZipError),

    #[error("invalid exclude pattern: {0}")]
    InvalidExcludePattern(String),

    #[error("file already exists: {0} (use --force to overwrite)")]
    FileExists(Utf8PathBuf),

    #[error("--strip-components is not supported for {0} format")]
    StripComponentsUnsupported(String),

    #[error(
        "--keep-newer is not supported for {0} format (entries lack reliable \
         mtime metadata); use --no-overwrite if you want to skip existing files"
    )]
    KeepNewerUnsupported(String),

    #[error(
        "{flag} is not supported for {format} format \
         (supported on tar-family formats: tar, tar-gz, tar-zst, tar-xz, tar-bz2)"
    )]
    ReproducibilityFlagUnsupported { flag: &'static str, format: String },

    #[error("{0} format does not support reading from stdin (requires seekable input)")]
    StdinNotSupported(String),

    #[error("{0} format does not support writing to stdout (requires seekable output)")]
    StdoutNotSupported(String),

    #[error("cannot infer format from stdin; specify --format")]
    CannotInferFormatStdin,

    #[error("no input provided; pass an archive path or pipe an archive into stdin")]
    NoInput,

    #[error(
        "--one-top-level needs a filename to derive the directory from; not supported with stdin input"
    )]
    OneTopLevelStdin,

    #[error("path traversal detected in archive entry: {0}")]
    PathTraversal(String),

    #[error("symlink target for `{path}` exceeds {max} bytes; refusing to read it")]
    SymlinkTargetTooLong { path: Utf8PathBuf, max: u64 },

    #[error(
        "zstd: the pure-Rust encoder only accepts --level 0 (store, no \
         compression); omit --level to use the default fast-compression mode"
    )]
    ZstdLevelUnsupported,

    #[error(
        "{operation} is not supported for {format} format \
         (supported on tar-family and zip)"
    )]
    ModifyUnsupported {
        operation: &'static str,
        format: String,
    },

    #[error("cannot read input `{path}`: {source}")]
    CannotReadInput {
        path: Utf8PathBuf,
        #[source]
        source: io::Error,
    },

    #[error(
        "no readable inputs (all paths were missing, unreadable, or excluded); \
         refusing to write an empty archive"
    )]
    NoReadableInputs,

    #[error("convert: input and output resolve to the same path: {0}")]
    ConvertSamePath(Utf8PathBuf),

    #[error("convert: cannot infer output format; specify --to or --output with an extension")]
    ConvertCannotInferOutputFormat,

    #[error("encryption is not supported for {0} format (only zip and 7z)")]
    EncryptionUnsupported(String),

    #[error("archive is encrypted; provide --password-stdin, --password-file, or --password")]
    PasswordRequired,

    #[error("password is empty")]
    EmptyPassword,

    #[error("{format} support is not compiled into this build (rebuild with --features {feature})")]
    FormatFeatureDisabled {
        format: String,
        feature: &'static str,
    },
}