oximod 0.1.8

MongoDB ODM for Rust inspired by Mongoose
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

mod common;

use common::init;
use mongodb::bson::oid::ObjectId;
use oximod::Model;
use serde::{ Deserialize, Serialize };
use testresult::TestResult;

/// A simple model used to test the `new`, `default`, and builder APIs.
#[derive(Model, Serialize, Deserialize, Debug, PartialEq)]
#[db("test")]
#[collection("builder_tests")]
pub struct User {
    #[serde(skip_serializing_if = "Option::is_none")]
    _id: Option<ObjectId>,
    name: String,
    age: i32,
    active: bool,
}

// Run test: cargo nextest run new_and_default_are_equivalent
#[tokio::test]
async fn new_and_default_are_equivalent() -> TestResult {
    let user_new = User::new();
    let user_default = User::default();

    assert_eq!(user_new, user_default);
    Ok(())
}

// Run test: cargo nextest run builder_sets_all_fields
#[tokio::test]
async fn builder_sets_all_fields() -> TestResult {
    let id = ObjectId::new();
    let user = User::default().id(id.clone()).name("User1".to_string()).age(30).active(true);

    assert_eq!(user._id, Some(id));
    assert_eq!(user.name, "User1");
    assert_eq!(user.age, 30);
    assert!(user.active);

    Ok(())
}

// Run test: cargo nextest run builder_partial_fields_default_rest
#[tokio::test]
async fn builder_partial_fields_default_rest() -> TestResult {
    let user = User::default().name("User1".to_string());

    // name should be set, rest should be their respective defaults
    assert_eq!(user.name, "User1");
    assert_eq!(user.age, 0);
    assert_eq!(user.active, false);
    assert_eq!(user._id, None);

    Ok(())
}

// Run test: cargo nextest run builder_and_save_works_end_to_end
#[tokio::test]
async fn builder_and_save_works_end_to_end() -> TestResult {
    init().await;
    User::clear().await?;

    let saved_id = User::default().name("User1".to_string()).age(42).active(true).save().await?;

    assert_ne!(saved_id, ObjectId::default());

    let fetched = User::find_by_id(saved_id).await?;
    assert!(fetched.is_some());

    let user = fetched.unwrap();
    assert_eq!(user.name, "User1");
    assert_eq!(user.age, 42);
    assert!(user.active);

    Ok(())
}

// Run test: cargo nextest run builder_using_custom_document_id_setter
#[tokio::test]
async fn builder_using_custom_document_id_setter() -> TestResult {
    init().await;

    #[derive(Model, Serialize, Deserialize, Debug, PartialEq)]
    #[db("test")]
    #[collection("builder_tests")]
    #[document_id_setter_ident("my_custom_id_setter")]
    pub struct User {
        #[serde(skip_serializing_if = "Option::is_none")]
        _id: Option<ObjectId>,
        name: String,
        age: i32,
        active: bool,
        id: String,
    }

    User::clear().await?;

    let saved_id = User::default()
        .my_custom_id_setter(ObjectId::new()) // this provides maximum flexibility with field names
        .id("3894HR934HR00NJ23R324R".to_string())
        .name("User1".to_string())
        .age(42)
        .active(true)
        .save().await?;

    assert_ne!(saved_id, ObjectId::default());

    let fetched = User::find_by_id(saved_id).await?;
    assert!(fetched.is_some());

    let user = fetched.unwrap();
    assert_eq!(user.name, "User1");
    assert_eq!(user.age, 42);
    assert!(user.active);

    Ok(())
}