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
115
116
117
118
119
120
121
122
123
124



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

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

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

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

        $crate::database_config!($opts; ($db_url, $db_name));

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

        impl $db_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::Database, ::mongodb::error::Error> {
                let client = ::mongodb::Client::with_uri_str(&self.0.db_url).await?;
                Ok(client.database(&self.0.db_name))
            }
        }
    };
}