imag-link 0.10.1

Part of the imag core distribution: imag-link command
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

//
// imag - the personal information management suite for the commandline
// Copyright (C) 2015-2020 Matthias Beyer <mail@beyermatthias.de> and contributors
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; version
// 2.1 of the License.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//

use std::path::PathBuf;

use clap::{Arg, ArgMatches, App, SubCommand};
use failure::Fallible as Result;

use libimagstore::storeid::StoreId;
use libimagstore::storeid::IntoStoreId;
use libimagrt::runtime::IdPathProvider;

pub fn build_ui<'a>(app: App<'a, 'a>) -> App<'a, 'a> {
    app
        .subcommand(SubCommand::with_name("remove")
                .about("Remove a link between two or more entries")
                .version("0.1")
                .arg(Arg::with_name("from")
                     .index(1)
                     .takes_value(true)
                     .required(true)
                     .multiple(false)
                     .help("Remove Link from this entry")
                     .value_name("ENTRY"))
                .arg(Arg::with_name("to")
                     .index(2)
                     .takes_value(true)
                     .required(true)
                     .multiple(true)
                     .help("Remove links to these entries")
                     .value_name("ENTRIES"))
                )
        .subcommand(SubCommand::with_name("unlink")
                .about("Remove all links from an entry")
                .version("0.1")
                .arg(Arg::with_name("from")
                     .index(1)
                     .takes_value(true)
                     .required(true)
                     .multiple(true)
                     .help("Remove links from these entries")
                     .value_name("ENTRY"))
                )

        .subcommand(SubCommand::with_name("list")
                .about("List links to this entry")
                .version("0.1")
                .arg(Arg::with_name("entries")
                     .index(1)
                     .takes_value(true)
                     .multiple(true)
                     .required(true)
                     .help("List these entries, seperate by comma")
                     .value_name("ENTRIES"))

                .arg(Arg::with_name("list-externals-too")
                     .long("list-external")
                     .takes_value(false)
                     .required(false)
                     .help("Also list external links (debugging helper that might be removed at some point"))

                .arg(Arg::with_name("list-plain")
                     .long("plain")
                     .multiple(false)
                     .takes_value(false)
                     .required(false)
                     .help("List plain rather than in ASCII table"))
                )

        .arg(Arg::with_name("check-consistency")
             .long("check-consistency")
             .short("C")
             .takes_value(false)
             .required(false)
             .help("Check the link-consistency in the store (might be time-consuming)"))

        .arg(Arg::with_name("from")
             .index(1)
             .takes_value(true)
             .required(false)
             .multiple(false)
             .help("Link from this entry")
             .requires("to")
             .value_name("ENTRY"))

        .arg(Arg::with_name("to")
             .index(2)
             .takes_value(true)
             .required(false)
             .multiple(true)
             .help("Link to this entries")
             .requires("from")
             .value_name("ENTRIES"))

        .arg(Arg::with_name("directional")
             .long("direction")
             .takes_value(false)
             .required(false)
             .multiple(false)
             .help("When creating links, make them directional")
             .requires_all(&["from", "to"]))

}

/// PathProvider
///
/// This PathProvider does _not_ return the "from" value of the commandline call if no subcommand
/// is given.
///
/// It has to be fetched by main() by hand.
pub struct PathProvider;
impl IdPathProvider for PathProvider {
    fn get_ids(matches: &ArgMatches) -> Result<Option<Vec<StoreId>>> {
        fn get_id_paths(field: &str, subm: &ArgMatches) -> Result<Option<Vec<StoreId>>> {
            subm.values_of(field)
                .map(|v| v
                     .map(PathBuf::from)
                     .map(|pb| pb.into_storeid())
                     .collect::<Result<Vec<_>>>()
                )
                .transpose()
        }
        let ids = match matches.subcommand() {
            ("remove", Some(subm)) => Some(get_id_paths("to", subm)),
            ("unlink", Some(subm)) => Some(get_id_paths("from", subm)),
            ("list", Some(subm)) => Some(get_id_paths("entries", subm)),
            _ => None,
        };

        ids
            .unwrap_or_else(|| get_id_paths("to", matches))
    }
}