stardex 0.1.2

A zero-trust, streaming tar parser + per-file hasher for backup pipelines.
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

use clap::Parser;

use crate::hash::HashAlgo;
use crate::output::OutputFormat;
use crate::DEFAULT_BUFFER_SIZE;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
pub struct Cli {
    /// Hashing algorithm to use
    #[arg(long, value_enum, default_value_t = HashAlgo::Blake3)]
    pub algo: HashAlgo,

    /// Output format
    #[arg(long, value_enum, default_value_t = OutputFormat::Jsonl)]
    pub format: OutputFormat,

    /// Buffer size in bytes for reading file content (e.g. "64K", "1M", "2M")
    #[arg(long, default_value_t = DEFAULT_BUFFER_SIZE, value_parser = parse_size)]
    pub buffer_size: usize,

    /// Prevent broken pipes by draining stdin on error
    #[arg(long)]
    pub no_fail: bool,

    /// Emit SQL schema and wrap inserts in BEGIN/COMMIT when using --format sql
    #[arg(long)]
    pub init_sql: bool,

    /// Calculate a global hash for the entire tar stream
    #[arg(long, value_enum)]
    pub global_hash: Option<HashAlgo>,

    /// Output path for the global summary (JSON)
    #[arg(long)]
    pub summary_out: Option<std::path::PathBuf>,
}

fn parse_size(s: &str) -> Result<usize, String> {
    let trimmed = s.trim();
    let (num, multiplier) = if let Some(stripped) =
        trimmed.strip_suffix(|c: char| c.eq_ignore_ascii_case(&'k'))
    {
        (stripped, 1024)
    } else if let Some(stripped) = trimmed.strip_suffix(|c: char| c.eq_ignore_ascii_case(&'m')) {
        (stripped, 1024 * 1024)
    } else if let Some(stripped) = trimmed.strip_suffix(|c: char| c.eq_ignore_ascii_case(&'g')) {
        (stripped, 1024 * 1024 * 1024)
    } else {
        (trimmed, 1)
    };

    num.parse::<usize>()
        .map(|n| n * multiplier)
        .map_err(|_| format!("Invalid size '{}'", s))
}