oximod 0.2.5

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

//! Basic usage example for the oximod crate
//!
//! Run with: `cargo run --example basic_usage`
//!
//! This demonstrates how to:
//! - Connect to MongoDB
//! - Define a model with the `Model` derive macro
//! - Save a document using the builder API
//! - Count documents (raw MongoDB vs OxiMod helper)
//! - Check existence using both APIs

use mongodb::bson::{doc, oid::ObjectId};
use oximod::{Model, OxiClient};
use serde::{Deserialize, Serialize};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Load MongoDB URI
    dotenv::dotenv().ok();
    let mongodb_uri = std::env::var("MONGODB_URI")
        .expect("MONGODB_URI must be set in your .env file or environment");

    // Init global client
    OxiClient::init_global(mongodb_uri).await?;

    #[derive(Debug, Serialize, Deserialize, Model)]
    #[db("basic_usage_db")]
    #[collection("users")]
    struct User {
        #[serde(skip_serializing_if = "Option::is_none")]
        _id: Option<ObjectId>,

        name: String,
        age: i32,

        #[default(true)]
        active: bool,
    }

    // Clean up previous runs
    User::clear().await?;

    // Insert user
    let user = User::new().name("User1").age(28);
    let id = user.save().await?;
    println!("✅ Saved user with _id: {}", id);

    // Get raw collection
    let collection = User::get_collection()?;

    // ---------------------------
    // COUNT (raw MongoDB)
    // ---------------------------

    let raw_count = collection.count_documents(doc! {}).await?;
    println!("📊 Raw count: {}", raw_count);

    // ---------------------------
    // COUNT (OxiMod helper)
    // ---------------------------

    let helper_count = User::count(doc! {}).await?;
    println!("⚡ Helper count: {}", helper_count);

    // Compare
    println!("Counts match: {}", raw_count == helper_count);

    // ---------------------------
    // EXISTS (raw MongoDB)
    // ---------------------------

    let raw_exists = collection
        .find_one(doc! { "name": "User1" })
        .await?
        .is_some();

    println!("🔎 Raw exists: {}", raw_exists);

    // ---------------------------
    // EXISTS (OxiMod helper)
    // ---------------------------

    let helper_exists = User::exists(doc! { "name": "User1" }).await?;

    println!("⚡ Helper exists: {}", helper_exists);

    println!("Exists match: {}", raw_exists == helper_exists);

    Ok(())
}