clappos 0.3.8

A simple, flagless version of Clap that uses argument position for assignment with zero dependencies
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

# Clappos

## Description
Clappos is a simple, flagless alternative to Clap for building clean, simple CLI tools.

## Project status
This project is being actively developed and maintained by the Level9Turtles organization. For contribution information, 
or any other concerns/questions, please reach out to level9turtles.HAL@gmail.com
## Usage

### Installation
Add the following to your Cargo.toml
```TOML
clappos = "*"
```
or run
```bash
cargo add clappos
```
to get the latest version

### Examples

```Rust
use clappos::Clappos;

#[derive(Clappos)]
struct Args {
    /// help menu info for arg1
    string_arg: String,
    /// help menu info for arg2
    num_arg: i32,
    /// help menu info for arg3
    bool_arg: bool,
    /// help menu info for arg4
    op_string_arg: Option<String>,
    /// help menu info for arg5
    op_num_arg: Option<i32>
}

fn main() {
    let args = Args::parse(); // user input: `cargo run this 1 true that`
    println!("{}" args.string_arg); // => "this"
    println!("{}", args.num_arg); // => 1
    println!("{}", args.bool_arg); // => true
    println!("{}", args.op_string_arg); // => Some("that")
    println!("{}", args.op_num_arg); // => None
    
}
```

There is a trade-off for flagless CLI tools, which is that any optional arguments must come last, and a Some value 
cannot come after a None value when being used. In the future, I may add a feature to flag your optional arguments.

For now though, these examples are invalid:
```Rust
#[derive(Clappos)]
struct Args {
    optional_number: Option<i32>,
    required_string: String,      // this won't work because require arg comes after optional arg
}

#[derive(Clappos)]
struct Args {
    string_arg: String,
    op_num1: Option<i32>,        // this is valid, but currently a user could not pass op_num2 
    op_num2: Option<i32>,        // without also passing an op_num1. May fix this with flags in the future
          
}
```

## Authors and acknowledgment
This tool was written and is maintained by Adam Horn of the Level9Turtles High Altitude Lab. For questions and concerns
please email me at level9turtles.HAL@gmail.com

## License
This project is licensed under the MIT open source license.