mongodb 3.6.0

The official MongoDB driver for Rust
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

use macro_magic::export_tokens;

use crate::{
    action::{deeplink, export_doc, option_setters, options_doc},
    client_encryption::{ClientEncryption, MasterKey},
};

impl ClientEncryption {
    /// Creates a new key document and inserts into the key vault collection.
    ///
    /// `await` will return d[`Result<Binary>`] (subtype 0x04) with the _id of the created
    /// document as a UUID.
    #[deeplink]
    #[options_doc(create_data_keys)]
    pub fn create_data_key(&self, master_key: impl Into<MasterKey>) -> CreateDataKey<'_> {
        CreateDataKey {
            client_enc: self,
            master_key: master_key.into(),
            options: None,
            #[cfg(test)]
            test_kms_provider: None,
        }
    }
}

/// Create a new key document and insert it into the key vault collection.  Construct via
/// [`ClientEncryption::create_data_key`].
#[must_use]
pub struct CreateDataKey<'a> {
    pub(crate) client_enc: &'a ClientEncryption,
    pub(crate) master_key: MasterKey,
    pub(crate) options: Option<DataKeyOptions>,
    #[cfg(test)]
    pub(crate) test_kms_provider: Option<mongocrypt::ctx::KmsProvider>,
}

/// Options for creating a data key.
#[derive(Debug, Clone, Default)]
#[non_exhaustive]
#[export_tokens]
pub struct DataKeyOptions {
    /// An optional list of alternate names that can be used to reference the key.
    pub key_alt_names: Option<Vec<String>>,
    /// A buffer of 96 bytes to use as custom key material for the data key being
    /// created.  If unset, key material for the new data key is generated from a cryptographically
    /// secure random device.
    pub key_material: Option<Vec<u8>>,
}

#[option_setters(DataKeyOptions)]
#[export_doc(create_data_keys)]
impl CreateDataKey<'_> {
    #[cfg(test)]
    pub(crate) fn test_kms_provider(mut self, value: mongocrypt::ctx::KmsProvider) -> Self {
        self.test_kms_provider = Some(value);
        self
    }
}

// Action impl in src/client/csfle/client_encryption/create_data_key.rs