structconf 0.5.0

Combine clap and rust-ini into a single procedural macro
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

//! This example shows how each of the available attributes is used.
//! You can run `cargo run --example showcase --` followed by any
//! flags you'd like to pass, or create `./config.ini` to test out the
//! config file.

#![allow(dead_code)]

use structconf::{clap, StructConf};
use strum_macros::{Display, EnumString};

#[derive(Debug, Display, EnumString)]
pub enum Count {
    One,
    Two,
    Three,
}

impl Default for Count {
    fn default() -> Self {
        Count::One
    }
}

#[derive(Debug, StructConf)]
struct Config {
    // Option available in the config file and the argument parser
    #[conf(help = "description for the argument parser.")]
    pub default: i32,

    // Option only for the argument parser
    #[conf(no_file, help = "not available in the config file")]
    pub args_opt: u8,

    // Option only for the config file
    #[conf(no_short, no_long)]
    pub conf_opt: String,

    // Skipped fields
    #[conf(no_short, no_long, no_file)]
    pub ignored: bool,

    // Configurable names
    #[conf(
        short = "x",
        long = "renamed-opt",
        file = "my_opt",
        help = "custom names."
    )]
    pub renamed: String,

    // Negated arguments
    #[conf(
        negated_arg,
        short = "n",
        long = "no-pancakes",
        help = "disable pancakes."
    )]
    pub pancakes: bool,

    // Custom default values
    #[conf(help = "default: 123.45", default = "123.45")]
    pub floating: f64,

    // Optional values
    #[conf(no_short, no_long)]
    pub optional_field: Option<String>,

    #[conf(help = "custom type")]
    // Custom types
    pub count: Count,
}

pub fn main() {
    let app = clap::App::new("demo");
    let conf = Config::parse(app, "config.ini");
    println!("Parsed config: {:#?}", conf);
}