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
125



/// Creates a new configuration structure to initialize the MongoDB collection
/// 
/// Create a new configuration structure to initialize the MongoDB collection with a standard environment variable
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::collection_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();
/// }
/// ```
/// 
/// Create a new configuration structure to initialize the MongoDB collection with the specified environment variable
/// 
/// ```
/// use mongodb_macro::Parser;
/// mongodb_macro::collection_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! collection_config {
    ($opts:ident) => ($crate::config!{$opts});

    ($opts:ident; ($db_url:tt, $db_name:tt, $collection_name:tt)) => 
    ($crate::config!{$opts; $db_url, $db_name, $collection_name});
}

/// Creates a new factory to create a MongoDB collection
/// 
/// Create mongodb collection factory with standard environment variable for database url, database name and collection name
/// 
/// ```
/// mongodb_macro::collection!(CollectionFactory; CollectionFactoryOpts);
///
/// 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 factory = CollectionFactory::parse();
/// 
///     // let collection = factory.create<Bson>().await.expect("failed to connect");
/// }
/// ```
/// 
/// Create mongodb collection factory with specified environment variable for database url, database name and collection name
/// 
/// ```
/// mongodb_macro::collection!(CollectionFactory; CollectionFactoryOpts; ("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 factory = CollectionFactory::parse();
///
///     // let collection = factory.create<Bson>().await.expect("failed to connect");
/// }
/// ```
/// 
/// Create a mongodb collection factory with nested environment variables into standard environment variables
/// 
/// ```
/// mongodb_macro::collection!(CollectionFactory; CollectionFactoryOpts);
///
/// 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");
///     std::env::set_var("COLLECTION_NAME", "users");
/// 
///     let factory = CollectionFactory::parse();
/// 
///     // let collection = factory.create<Bson>().await.expect("failed to connect");
/// 
///     assert_eq!(&factory.config().db_url, "mongodb://root:root@localhost:27017");
/// }
/// ```
#[macro_export]
macro_rules! collection {
    ($collection_factory:ident; $opts:ident) => ($crate::collection!{$collection_factory; $opts; ("DB_URL", "DB_NAME", "COLLECTION_NAME")});

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

        $crate::collection_config!($opts; ($db_url, $db_name, $collection_name));

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

        impl $collection_factory {
            fn parse() -> Self {
                use $crate::Parser;
                
                let opts = $opts::parse();

                Self(opts)
            }

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

            pub async fn create<T>(&self) -> Result<::mongodb::Collection<T>, ::mongodb::error::Error> {
                let client = ::mongodb::Client::with_uri_str(&self.0.db_url).await?;
                let db = client.database(&self.0.db_name);
                Ok(db.collection::<T>(&self.0.collection_name))
            }
        }
    };
}