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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114



/// Creates a new configuration structure to initialize the MongoDB client
/// 
/// Create a new configuration structure to initialize the MongoDB client with a standard environment variable
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::client_config!(Opts);
///
/// fn main() {
///     std::env::set_var("MONGODB_HOST", "localhost");
///     std::env::set_var("DB_URL", "mongodb://root:root@${MONGODB_HOST}:27017");
/// 
///     let opts = Opts::parse();
/// 
///     assert_eq!(&opts.db_url, "mongodb://root:root@localhost:27017");
/// }
/// ```
/// 
/// Create a new configuration structure to initialize the MongoDB client with the specified environment variable
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::client_config!(Opts; "MONGO_DB_URL");
///
/// fn main() {
///     std::env::set_var("MONGODB_HOST", "localhost");
///     std::env::set_var("MONGO_DB_URL", "mongodb://root:root@${MONGODB_HOST}:27017");
/// 
///     let opts = Opts::parse();
/// 
///     assert_eq!(&opts.db_url, "mongodb://root:root@localhost:27017");
/// }
/// ```
#[macro_export]
macro_rules! client_config {
    ($opts:ident) => ($crate::client_config!{$opts; "DB_URL"});

    ($opts:ident; $db_url: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,
        }
    };
}

/// Creates a new factory to create a MongoDB client
/// 
/// Create mongodb client factory with standard environment variable for db url
/// 
/// ```
/// mongodb_macro::client!(ClientFactory; ClientFactoryOpts);
///
/// fn main() {
///     std::env::set_var("MONGODB_HOST", "localhost");
///     std::env::set_var("DB_URL", "mongodb://root:root@${MONGODB_HOST}:27017");
/// 
///     let factory = ClientFactory::parse();
/// 
///     // let client = factory.create().await.expect("failed to connect");
/// 
///     assert_eq!(&factory.config().db_url, "mongodb://root:root@localhost:27017");
/// }
/// ```
/// 
/// Create mongodb client factory with specified environment variable for db url
/// 
/// ```
/// mongodb_macro::client!(ClientFactory; ClientFactoryOpts; "MONGO_DB_URL");
///
/// fn main() {
///     std::env::set_var("MONGODB_HOST", "localhost");
///     std::env::set_var("MONGO_DB_URL", "mongodb://root:root@${MONGODB_HOST}:27017");
/// 
///     let factory = ClientFactory::parse();
///
///     // let client = factory.create().await.expect("failed to connect");
/// 
///     assert_eq!(&factory.config().db_url, "mongodb://root:root@localhost:27017");
/// }
/// ```
#[macro_export]
macro_rules! client {
    ($client_factory:ident; $opts:ident) => ($crate::client!{$client_factory; $opts; "DB_URL"});
    ($client_factory:ident; $opts:ident; $db_url:tt) => {

        $crate::client_config!($opts; $db_url);

        #[derive(Clone, Debug, PartialEq, Eq)]
        pub struct $client_factory($opts);

        impl $client_factory {
            fn parse() -> Self {
                use $crate::Parser;

                let opts = $opts::parse();

                Self(opts)
            }

            pub fn config(&self) -> &$opts {
                &self.0
            }

            pub async fn create(&self) -> Result<::mongodb::Client, ::mongodb::error::Error> {
                ::mongodb::Client::with_uri_str(&self.0.db_url).await
            }
        }
    };
}