cliproc 2.1.1

A fast, low-level, and configurable command-line processor
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

use std::env;
use std::error::Error;
use std::fmt::Display;

use cliproc::cli;
use cliproc::proc;
use cliproc::{stage::Memory, Cli, Command};
use cliproc::{Arg, Help};

use std::process::ExitCode;

fn main() -> ExitCode {
    Cli::default().parse(env::args()).go::<Add>()
}

#[derive(PartialEq, Debug)]
struct Add {
    left: u8,
    right: u8,
    verbose: bool,
}

impl Add {
    pub fn run(&self) -> u16 {
        self.left as u16 + self.right as u16
    }
}

#[derive(Debug, PartialEq)]
pub enum AddError {
    Overflow,
}

impl Display for AddError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "an overflow has occurred")
    }
}

impl Error for AddError {}

impl Command for Add {
    fn interpret(cli: &mut Cli<Memory>) -> cli::Result<Self> {
        cli.help(Help::with(HELP).flag("help").switch('h'))?;
        Ok(Add {
            verbose: cli.check(Arg::flag("verbose"))?,
            left: cli.require(Arg::positional("left"))?,
            right: cli.require(Arg::positional("right"))?,
        })
    }

    fn execute(self) -> proc::Result {
        let sum = self.run();
        if sum > u8::MAX.into() {
            Err(AddError::Overflow)?
        } else {
            match self.verbose {
                true => println!("{} + {} = {}", self.left, self.right, sum),
                false => println!("{}", sum),
            }
            Ok(())
        }
    }
}

const HELP: &str = "\
Adds two numbers together.

Usage:
    add [options] <left> <right> 

Args:
    <left>       left-hand operand
    <right>       right-hand operand

Options:
    --verbose   display computation work
";

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    fn backend_logic() {
        let prog = Add {
            left: 10,
            right: 9,
            verbose: false,
        };
        assert_eq!(prog.run(), 19);
    }
}