mitrid_core 0.9.4

Core library of the Mitrid framework
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

//! # CLI
//!
//! `cli` is the module providing the trait used to manage and interact with the framework applications
//! from the command line.

use std::collections::HashMap;

use base::Result;
use base::{ConstantSize, VariableSize};
use base::Datable;
use app::command::Request;
use app::{Env, Config, Logger, Manager};

/// Trait implemented by CLI types.
pub trait CLI<M, E, C, L, D, MnP, A, StP, SvP, ClP, CP, AAd, AP, AR>
    where   M: Manager<E, C, D, MnP, A, StP, SvP, ClP, CP, AAd, AP, AR>,
            E: Env,
            C: Config<D, MnP, A, StP, SvP, ClP, CP>,
            L: Logger,
            D: Datable + ConstantSize,
            MnP: Datable,
            A: Ord + Datable + VariableSize,
            StP: Datable,
            SvP: Datable,
            ClP: Datable,
            CP: Datable,
            AAd: Ord + Datable,
            AP: Datable,
            AR: Datable
{
    /// Returns the CLI environment.
    fn env(&self) -> E;

    /// Returns the CLI configurations.
    fn config(&self) -> C;

    /// Returns the CLI logger.
    fn logger(&self) -> L;

    /// Creates a `Manager`.
    fn create_manager(&mut self, manager_params: &MnP) -> Result<()>;
    
    /// Returns the apps `Manager`, if present.
    fn manager(&self) -> Option<M>;
    
    /// Logs a `Result`.
    fn log_result<T: Sized>(&mut self, res: &Result<T>);

    /// Parses CLI args.
    fn parse_vars_and_args(&mut self, vars: &HashMap<String, String>, args: &Vec<String>) -> Result<Request<AAd, AP>>;

    /// Parses the CLI command.
    fn parse_cmd(&mut self) -> Result<Request<AAd, AP>> {
        let res_vars = self.env().vars();
        self.log_result(&res_vars);

        let res_args = self.env().args();
        self.log_result(&res_args);

        let vars = res_vars?;
        let args = res_args?;
        self.parse_vars_and_args(&vars, &args)
    }
    
    /// Runs the CLI.
    fn run(&mut self) {
        let env = self.env();

        let config = self.config();
        let config_check = config.check();
        self.log_result(&config_check);

        let res_req = self.parse_cmd();
        self.log_result(&res_req);

        let req = res_req.unwrap();

        if let Some(mut manager) = self.manager() {
            manager.exec(&env, &config, &req)
        } else {
            let res = self.create_manager(&config.manager_params());
            self.log_result(&res);
            res.unwrap();

            self.manager().unwrap().exec(&env, &config, &req)
        }
    }
}