mongodb-macro 1.0.4

MongoDB Macro is a crate with macros for quickly creating structures to work with mongodb
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

/// Quick and easy creates a new configuration to connect to MongoDB
/// 
/// Creating a configuration structure when using one database in a project:
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::config!(Opts);
///
/// fn main() {
///     std::env::set_var("DB_URL", "mongodb://root:root@localhost:27017");
///     std::env::set_var("DB_NAME", "test");
///     std::env::set_var("COLLECTION_NAME", "users");
/// 
///     let opts = Opts::parse();
/// }
/// ```
/// 
/// Creating a configuration structure when using multiple databases in a project:
/// 
/// This sets the prefix to the environment variables.
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::config!(Opts, "MONGO");
///
/// fn main() {
///     std::env::set_var("MONGO_DB_URL", "mongodb://root:root@localhost:27017");
///     std::env::set_var("MONGO_DB_NAME", "test");
///     std::env::set_var("MONGO_COLLECTION_NAME", "users");
/// 
///     let opts = Opts::parse();
/// }
/// ```
/// 
/// Creating a configuration structure with explicit fields:
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::config!(Opts; "MONGO_DB_URL", "MONGO_DB_NAME", "MONGO_COLLECTION_NAME");
///
/// fn main() {

///     std::env::set_var("MONGO_DB_URL", "mongodb://root:root@localhost:27017");
///     std::env::set_var("MONGO_DB_NAME", "test");
///     std::env::set_var("MONGO_COLLECTION_NAME", "users");
/// 
///     let opts = Opts::parse();
/// }
/// ```
#[macro_export]
macro_rules! config {
    ($opts:ident, $prefix:tt) => ($crate::config!{$opts, $prefix; ("DB_URL", "DB_NAME", "COLLECTION_NAME")});

    ($opts:ident, $prefix:tt; ($db_url:tt, $db_name:tt, $collection_name:tt)) => {

        #[derive(Clone, Debug, PartialEq, Eq, $crate::Parser)]
        pub struct $opts {

            /// env by default DB_URL
            #[clap(env = concat!($prefix, "_", $db_url))]
            pub db_url: nested_env_parser::Env,

            /// env by default DB_NAME
            #[clap(env = concat!($prefix, "_", $db_name))]
            pub db_name: nested_env_parser::Env,

            /// env by default COLLECTION_NAME
            #[clap(env = concat!($prefix, "_", $collection_name))]
            pub collection_name: nested_env_parser::Env,
        }
    };
    
    ($opts:ident) => ($crate::config!{$opts; "DB_URL", "DB_NAME", "COLLECTION_NAME"});

    ($opts:ident; $db_url:tt, $db_name:tt, $collection_name:tt) => {
        
        #[derive(Clone, Debug, PartialEq, Eq, $crate::Parser)]
        pub struct $opts {

            /// env by default DB_URL
            #[clap(env = $db_url)]
            pub db_url: $crate::Env,

            /// env by default DB_NAME
            #[clap(env = $db_name)]
            pub db_name: $crate::Env,

            /// env by default COLLECTION_NAME
            #[clap(env = $collection_name)]
            pub collection_name: $crate::Env,
        }
    };
}