opentimestamps-cli 0.2.0

Rust client for OpenTimestamps timestamps
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

// Copyright (C) 2024 The OpenTimestamps developers

use camino::Utf8PathBuf;
use clap::{Args, Parser, Subcommand};
use std::time::Duration;

#[derive(PartialEq, Clone, Debug, Parser)]
#[command(author, version, about, long_about = None)]
pub struct CliOpts {
    /// The bitcoin options
    #[clap(flatten)]
    pub bitcoin: Option<BitcoinOpts>,

    /// The sub command
    #[command(subcommand)]
    pub command: CliCommand,
}

#[derive(Debug, Subcommand, Clone, PartialEq)]
#[clap(rename_all = "snake")]
pub enum CliCommand {
    #[clap(long_about = "Timestamp files")]
    Stamp {
        /// Filenames
        #[clap(name = "files", required = true, num_args = 1.., value_delimiter = ' ')]
        files: Vec<Utf8PathBuf>,
        /// Create timestamp with the aid of a remote calendar. May be specified multiple times.
        #[clap(name = "calendar_url", short, long)]
        calendar: Option<Vec<String>>,
        /// Timeout before giving up on a calendar.
        #[clap(name = "timeout", short, long)]
        #[arg(value_parser = parse_duration)]
        timeout: Option<Duration>,
    },

    #[clap(long_about = "Upgrade remote calendar timestamps to be locally verifiable")]
    Upgrade {
        /// Existing timestamp(s); moved to FILE.bak
        #[clap(name = "files", required = true, num_args = 1.., value_delimiter = ' ')]
        files: Vec<Utf8PathBuf>,
        /// Override calendars in timestamp
        #[clap(name = "calendar_url", short, long)]
        calendar: Option<Vec<String>>,
    },

    #[clap(long_about = "Show information on a timestamp")]
    Info {
        /// Filename
        #[clap(name = "file", required = true, index = 1)]
        file: Utf8PathBuf,
    },

    #[clap(long_about = "Verify a timestamp")]
    Verify {
        /// Timestamp file
        #[clap(name = "timestamp", required = true, index = 1)]
        timestamp: Utf8PathBuf,
        /// Specify target file explicitly
        #[clap(name = "target", index = 2)]
        target: Option<Utf8PathBuf>,
        /// Verify a (hex-encoded) digest rather than a file
        #[clap(name = "digest", index = 3)]
        digest: Option<String>,
    },
}

fn parse_duration(arg: &str) -> Result<std::time::Duration, std::num::ParseIntError> {
    let seconds = arg.parse()?;
    Ok(std::time::Duration::from_secs(seconds))
}

#[derive(PartialEq, Clone, Debug, Args)]
pub struct BitcoinOpts {
    /// Bitcoin node
    #[clap(long, global = true)]
    pub bitcoin_node: Option<String>,
    /// Bitcoin username
    #[clap(long, global = true)]
    pub bitcoin_username: Option<String>,
    /// Bitcoin password
    #[clap(long, global = true)]
    pub bitcoin_password: Option<String>,
}