trk 0.2.0

Simple terminal-based time-series data recorder and plotter.
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

use structopt::StructOpt;

use std::path::PathBuf;
use std::num::ParseFloatError;

use std::str::FromStr;

fn parse_measurement(input: &str) -> Result<f64, ParseFloatError> {
    f64::from_str(input)
}

#[derive(StructOpt)]
pub enum Command {
    /// Add a new measurement to the given series
    #[structopt(name = "add")]
    AddMeasurement {
        #[structopt(short = "s", long = "series")]
        series: String,

        #[structopt(parse(try_from_str = "parse_measurement"))]
        value: Option<f64>,

        /// Auto-create the series if it doesn't exist
        #[structopt(short = "c")]
        create: bool
    },

    /// Slurp in series:val pairs from stdin
    #[structopt(name = "bulk")]
    AddBulk {
        /// Auto-create series if they doesn't exist
        #[structopt(short = "c")]
        create: bool
    },

    /// Add a series
    #[structopt(name = "add-series")]
    AddSeries {
        #[structopt(short = "n", long = "name")]
        name: Option<String>,

        /// Unit for values (eg ms, bps, pps)
        #[structopt(short = "u", long = "unit")]
        unit: Option<String>
    },

    /// Delete a series
    #[structopt(name = "delete-series")]
    DeleteSeries {
        #[structopt(short = "s", long = "series")]
        series: Option<String>
    },

    /// Plot a series
    #[structopt(name = "plot")]
    Plot {
        #[structopt(short = "s", long = "series")]
        series: Option<String>,

        /// Number of points to plot (default 50)
        #[structopt(short = "p", default_value = "50")]
        points: u8,

        /// Show a table as well
        #[structopt(short = "t", long = "table")]
        table: bool,
    }
}

#[derive(StructOpt)]
#[structopt(name = "trk", about = "Simple CLI-based metric tracker and plotter")]
pub struct Config {
    /// Path to store data
    #[structopt(short = "d", long = "data-root", parse(from_os_str))]
    pub data_root: Option<PathBuf>,

    /// Source name
    #[structopt(short = "f", long = "data-file", default_value = "default", parse(from_os_str))]
    pub file: PathBuf,

    /// Log file
    #[structopt(short = "l", long = "log", parse(from_os_str))]
    pub log_file: Option<PathBuf>,

    #[structopt(subcommand)]
    pub subcmd: Command
}

pub fn init() -> Config {
    Config::from_args()
}