libimagrt 0.10.1

Library for the imag core distribution
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

//
// 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 runtime::Runtime;
use clap::App;
use failure::Fallible as Result;

pub trait ImagApplication {
    fn run(rt: Runtime) -> Result<()>;
    fn build_cli<'a>(app: App<'a, 'a>) -> App<'a, 'a>;
    fn name() -> &'static str;
    fn version() -> &'static str;
    fn description() -> &'static str;
}


#[macro_export]
macro_rules! simple_imag_application_binary {
    ($application_library:ident, $application_implementor:ident) => {
        extern crate libimagerror;
        extern crate failure;
        extern crate $application_library;

        use failure::{Error, Fallible as Result, ResultExt};

        fn main() {
            use libimagerror::trace::MapErrTrace;
            use libimagrt::application::ImagApplication;
            use libimagrt::setup::generate_runtime_setup;
            use $application_library::$application_implementor;

            let version = make_imag_version!();
            let rt = generate_runtime_setup($application_implementor::name(),
                                            &version,
                                            $application_implementor::description(),
                                            $application_implementor::build_cli);

            $application_implementor::run(rt)
                .context(format!("Failed to run {}", $application_implementor::name()))
                .map_err(Error::from)
                .map_err_trace_exit_unwrap();
        }
    };
}