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

extern crate clap;

use crate::configure::Configuration;
use crate::log::{Item, LogController};
use crate::util::{check_for_ongoing_event, describe, remainder, some_nws};
use clap::{App, AppSettings, Arg, ArgMatches, SubCommand};

fn after_help() -> &'static str {
    "You can record notes in your job log as well as events. But they are \
reported by the summary subcommand with only one timestamp, not two, and they \
aren't reported at all unless you specifically ask for them. E.g.,

  > job note -t paula -t birthday install Job Log

A note line in the log is identical to an event line, except '<NOTE>' is used as the separator \
between the timestamp and the tags:

  2020  1 18 12 10 26<NOTE>birthday paula:install Job Log

All prefixes of 'note' are aliases of the subcommand."
}

pub fn cli(mast: App<'static, 'static>, display_order: usize) -> App<'static, 'static> {
    mast.subcommand(
        SubCommand::with_name("note")
            .aliases(&["n", "no", "not"])
            .about("Adds a new note")
            .after_help(after_help())
            .arg(
                Arg::with_name("tag")
                .short("t")
                .long("tag")
                .multiple(true)
                .number_of_values(1)
                .help("Adds this tag to the note")
                .long_help("A tag is just a short description, like 'fun', or 'Louis'. Add a tag to a note to facilitate finding or grouping similar notes.")
                .value_name("tag")
                .validator(|v| if some_nws(&v) {Ok(())} else {Err(format!("tag {:?} needs some non-whitespace character", v))})
                .display_order(1)
            )
            .arg(
                Arg::with_name("copy-tags")
                .short("c")
                .long("copy-tags")
                .visible_alias("ct")
                .help("Copies tags from preceding note")
                .long_help("Copy to this note all the tags of the immediately preceding note. These tags will be in addition to any tags added via --tag.")
                .display_order(2)
            )
            .setting(AppSettings::TrailingVarArg)
            .arg(
                Arg::with_name("note")
                    .help("text to record")
                    .long_help(
                        "All the <note> arguments are concatenated to produce the text of the note.",
                    )
                    .value_name("note")
                    .required(true)
                    .multiple(true)
            )
            .display_order(display_order)
    )
}

pub fn run(directory: Option<&str>, matches: &ArgMatches) {
    let conf = Configuration::read(None, directory);
    let mut reader = LogController::new(None, &conf).expect("could not read log");
    check_for_ongoing_event(&mut reader, &conf);
    let description = remainder("note", matches);
    let mut tags: Vec<String> = if let Some(values) = matches.values_of("tag") {
        values.map(|s| s.to_owned()).collect()
    } else {
        vec![]
    };
    if matches.is_present("copy-tags") {
        if let Some(event) = reader.last_event() {
            for t in event.tags {
                tags.push(t);
            }
        }
    }
    let (note, offset) = reader.append_note(description, tags);
    describe("noted", None, Item::Note(note, offset), &conf);
}