twinleaf-tools 2.3.0

Tools for the Twinleaf I/O protocol for reading data from Twinleaf quantum sensors.
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

use clap::{
    builder::{PossibleValuesParser, TypedValueParser, ValueHint},
    Args, Subcommand,
};
use twinleaf::device::{util, RpcValueType};

use crate::TioOpts;

#[derive(Args, Debug)]
#[command(args_conflicts_with_subcommands = true, arg_required_else_help = true)]
pub struct RpcCli {
    #[command(flatten)]
    pub tio: TioOpts,

    #[command(subcommand)]
    pub subcommands: Option<RPCSubcommands>,

    /// RPC name to execute
    #[arg(value_hint = ValueHint::Other)]
    pub rpc_name: Option<String>,

    /// RPC argument value
    #[arg(
        allow_negative_numbers = true,
        value_name = "ARG",
        value_hint = ValueHint::Other,
        help_heading = "RPC Arguments"
    )]
    pub rpc_arg: Option<String>,

    /// RPC request type
    #[arg(
        short = 't',
        long = "req-type",
        value_parser = PossibleValuesParser::new(util::RPC_TYPE_NAMES)
            .map(|s: String| util::parse_rpc_type(&s).expect("validated by possible-values")),
        help_heading = "Type Options",
    )]
    pub req_type: Option<RpcValueType>,

    /// RPC reply type
    #[arg(
        short = 'T',
        long = "rep-type",
        value_parser = PossibleValuesParser::new(util::RPC_TYPE_NAMES)
            .map(|s: String| util::parse_rpc_type(&s).expect("validated by possible-values")),
        help_heading = "Type Options",
    )]
    pub rep_type: Option<RpcValueType>,

    /// Enable debug output
    #[arg(short = 'd', long)]
    pub debug: bool,
}

#[derive(Subcommand, Debug)]
pub enum RPCSubcommands {
    /// List available RPCs on the device
    List {
        #[command(flatten)]
        tio: TioOpts,
    },
    /// Dump RPC data from the device
    Dump {
        #[command(flatten)]
        tio: TioOpts,

        /// RPC name to dump
        #[arg(value_hint = ValueHint::Other)]
        rpc_name: String,

        /// Trigger a capture before dumping
        #[arg(long)]
        capture: bool,
    },
}