hfile 0.5.2

Hfile is a command-line interface (CLI) tool for generating hash values of files
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

use clap::{
    Arg, ArgAction, Command, ValueEnum,
    builder::{
        EnumValueParser,
        styling::{AnsiColor, Effects, Styles},
    },
};

const ABOUT: &str = "hfile generates cryptographic hashes from files.";

#[derive(ValueEnum, Copy, Clone, Debug, PartialEq, Eq)]
pub enum Algorithm {
    Md5,
    Sha1,
    Sha256,
    Sha384,
    Sha512,
    Blake,
}

impl Algorithm {
    #[must_use]
    pub const fn digest_len(self) -> usize {
        match self {
            Self::Md5 => 32,
            Self::Sha1 => 40,
            Self::Sha256 | Self::Blake => 64,
            Self::Sha384 => 96,
            Self::Sha512 => 128,
        }
    }
}

#[must_use]
pub fn new() -> Command {
    let styles = Styles::styled()
        .header(AnsiColor::Yellow.on_default() | Effects::BOLD)
        .usage(AnsiColor::Green.on_default() | Effects::BOLD)
        .literal(AnsiColor::Blue.on_default() | Effects::BOLD)
        .placeholder(AnsiColor::Green.on_default())
        .error(AnsiColor::Red.on_default() | Effects::BOLD)
        .invalid(AnsiColor::Red.on_default() | Effects::BOLD)
        .valid(AnsiColor::Green.on_default());

    Command::new(env!("CARGO_PKG_NAME"))
        .author(env!("CARGO_PKG_AUTHORS"))
        .version(env!("CARGO_PKG_VERSION"))
        .about(ABOUT)
        .styles(styles)
        .arg(
            Arg::new("algorithm")
                .short('a')
                .long("algorithm")
                .value_parser(EnumValueParser::<Algorithm>::new())
                .value_name("ALGORITHM")
                .default_value("blake"),
        )
        .arg(
            Arg::new("size")
                .short('s')
                .long("size")
                .help("Show size of file")
                .action(ArgAction::SetTrue),
        )
        .arg(
            Arg::new("file")
                .value_name("FILE")
                .required_unless_present_any(["path", "duplicates", "check"]),
        )
        .arg(
            Arg::new("duplicates")
                .short('d')
                .long("duplicates")
                .help("Find duplicates")
                .action(ArgAction::SetTrue)
                .requires("path"),
        )
        .arg(
            Arg::new("path")
                .short('p')
                .long("path")
                .help("Create hash for all files under path")
                .value_name("PATH"),
        )
        .arg(
            Arg::new("check")
                .short('c')
                .long("check")
                .help("Read checksums from file and verify them")
                .value_name("CHECK")
                .conflicts_with_all(["path", "duplicates", "size", "file"]),
        )
}

#[cfg(test)]
mod tests {
    use super::new;
    use clap::ColorChoice;

    #[test]
    fn command_debug_assert() {
        new().debug_assert();
    }

    #[test]
    fn help_uses_ansi_styles() {
        let mut command = new().color(ColorChoice::Always);
        let help = command.render_help().ansi().to_string();

        assert!(help.contains("\u{1b}["));
        assert!(help.contains("Usage:"));
        assert!(help.contains("--algorithm"));
    }
}