rsecure 0.6.1

A simple file encryption and decryption tool using AES-GCM.
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
123
124
125
126
127
128
129
130
131

use clap::{Args, Parser, Subcommand};

#[derive(Parser, Debug)]
#[clap(
    about = "Secure file encryption using pure Rust and AES 🔒",
    version = env!("CARGO_PKG_VERSION"),
    author = "Containerscrew info@containerscrew.com",
    arg_required_else_help = true,
    after_help = print_after_help_message(),
)]
pub struct RsecureCliArgs {
    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Debug, Subcommand)]
pub enum Commands {
    #[clap(about = "Encrypt a file in plain text  using your AES key.")]
    Encrypt(EncryptionArgs),
    #[clap(about = "Decrypt an encrypted file using your AES private key.")]
    Decrypt(DecryptionArgs),
    #[clap(about = "Create a new AES key pair.")]
    CreateKey(CreateKeyArgs),
}

#[derive(Debug, Args, Clone, PartialEq, Eq)]
pub struct EncryptionArgs {
    #[command(flatten)]
    pub common: CommonArgs,

    #[arg(
        short = 'e',
        long = "exclude-dir",
        help = "Exclude directories to encrypt",
        value_delimiter = ' ',
        num_args = 1..,
        required = false
    )]
    pub exclude_dir: Option<Vec<String>>,

    #[arg(
        long = "passphrase",
        default_value_t = false,
        help = "Use a passphrase (Argon2id) instead of a key file. Prompts on stdin (no echo)."
    )]
    pub passphrase: bool,

    #[arg(
        long = "argon2-memory",
        help = "Argon2id memory cost in KiB (default: 19456 ~ 19 MiB)",
        value_parser = clap::value_parser!(u32).range(8..),
        default_value = "19456"
    )]
    pub argon2_m_cost: u32,

    #[arg(
        long = "argon2-time",
        help = "Argon2id time cost / iterations (default: 2)",
        value_parser = clap::value_parser!(u32).range(1..),
        default_value = "2"
    )]
    pub argon2_t_cost: u32,

    #[arg(
        long = "argon2-parallelism",
        help = "Argon2id parallelism / lanes (default: 1)",
        value_parser = clap::value_parser!(u8).range(1..),
        default_value = "1"
    )]
    pub argon2_p_cost: u8,
}

#[derive(Debug, Args, Clone, PartialEq, Eq)]
pub struct DecryptionArgs {
    #[command(flatten)]
    pub common: CommonArgs,
}

#[derive(Debug, Args, Clone, PartialEq, Eq)]
pub struct CommonArgs {
    #[arg(
        short = 'p',
        long = "private-key-path",
        help = "Path to the AES key file (omit when using --passphrase)"
    )]
    pub private_key_path: Option<String>,

    #[arg(
        short = 's',
        long = "source",
        help = "Path to the source file or folder with files to encrypt or decrypt"
    )]
    pub source: String,

    #[arg(
        short = 'r',
        long = "remove-file",
        default_value_t = false,
        required = false,
        help = "Path to the file to remove after encryption or decryption"
    )]
    pub remove_file: bool,
}

#[derive(Debug, Args)]
pub struct CreateKeyArgs {
    #[arg(
        short = 'o',
        long = "output",
        help = "Output path for the generated AES key"
    )]
    pub output: String,
}

fn print_after_help_message() -> String {
    String::from(
        "Author: containerscrew \nLicense: GPL3\nWebsite: github.com/containerscrew/rsecure",
    )
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_print_after_help_message() {
        let expected =
            "Author: containerscrew \nLicense: GPL3\nWebsite: github.com/containerscrew/rsecure";
        assert_eq!(print_after_help_message(), expected);
    }
}