arti 2.1.0

A rust implementation of the Tor privacy tools.
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

//! Low-level, plumbing subcommands.

use std::str::FromStr;

use anyhow::Result;
use clap::{ArgMatches, Args, FromArgMatches, Parser, Subcommand};

use arti_client::{InertTorClient, TorClient, TorClientConfig};
use tor_keymgr::KeystoreId;
use tor_rtcompat::Runtime;

/// The `keys-raw` subcommands the arti CLI will be augmented with.
#[derive(Debug, Parser)]
pub(crate) enum RawSubcommands {
    /// Run plumbing key management commands.
    #[command(subcommand)]
    KeysRaw(RawSubcommand),
}

/// The `keys-raw` subcommand.
#[derive(Subcommand, Debug, Clone)]
pub(crate) enum RawSubcommand {
    /// Remove keystore entry by raw ID.
    RemoveById(RemoveByIdArgs),
}

/// The arguments of the [`RemoveById`](RawSubcommand::RemoveById) subcommand.
#[derive(Debug, Clone, Args)]
pub(crate) struct RemoveByIdArgs {
    /// The raw ID of the keystore entry to remove.
    ///
    /// The raw ID of an entry can be obtained from the field "Location" of the
    /// output of `arti keys list`.
    raw_entry_id: String,

    /// Identifier of the keystore to remove the entry from.
    /// If omitted, the primary store will be used ("arti").
    #[arg(short, long, default_value_t = String::from("arti"))]
    keystore_id: String,
}

/// Run the `keys-raw` subcommand.
pub(crate) fn run<R: Runtime>(
    runtime: R,
    keys_matches: &ArgMatches,
    config: &TorClientConfig,
) -> Result<()> {
    let subcommand =
        RawSubcommand::from_arg_matches(keys_matches).expect("Could not parse keys subcommand");
    let client = TorClient::with_runtime(runtime)
        .config(config.clone())
        .create_inert()?;

    match subcommand {
        RawSubcommand::RemoveById(args) => run_raw_remove(&args, &client),
    }
}

/// Run `key raw-remove-by-id` subcommand.
fn run_raw_remove(args: &RemoveByIdArgs, client: &InertTorClient) -> Result<()> {
    let keymgr = client.keymgr()?;
    let keystore_id = KeystoreId::from_str(&args.keystore_id)?;
    keymgr.remove_unchecked(&args.raw_entry_id, &keystore_id)?;

    Ok(())
}