#mongo-db #index #indexed #collection #derive #bson #mongo-indexed

macro mongo_indexed_derive

derive macro to declaratively index mongo collections

6 releases (2 stable)

2.0.0 Aug 16, 2024
1.0.0 Jun 27, 2024
0.3.0 May 13, 2024
0.2.2 Jan 13, 2024
0.1.0 Nov 2, 2023

#17 in #mongo

Download history 167/week @ 2024-06-25 36/week @ 2024-07-02 12/week @ 2024-07-09 34/week @ 2024-07-16 21/week @ 2024-07-23 31/week @ 2024-07-30 64/week @ 2024-08-06 214/week @ 2024-08-13 25/week @ 2024-08-20 31/week @ 2024-08-27 4/week @ 2024-09-03 40/week @ 2024-09-10 19/week @ 2024-09-17 43/week @ 2024-09-24 60/week @ 2024-10-01 38/week @ 2024-10-08

184 downloads per month
Used in 3 crates (via mongo_indexed)

GPL-3.0-or-later

5KB
111 lines

Configure mongo indexing right on your rust structs

Example

use mongo_indexed::doc;
use mongo_indexed_derive::MongoIndexed;
use mongodb::{bson::oid::ObjectId, options::ClientOptions};
use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize, Deserialize, MongoIndexed)]
#[unique_doc_index({ "username": 1, "email": 1 })]
#[collection_name(users)] // By default, this will be the name of the struct it's defined on, in this case 'User'.
pub struct User {
    #[serde(rename = "_id")]
    pub id: ObjectId,

    #[index]
    pub username: String,

    #[index]
    pub email: String,
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // instantiate your mongo client
    let mongo =
        mongodb::Client::with_options(ClientOptions::parse("mongodb://localhost:27017").await?)?;
    let db = mongo.database("my-db");

    // Since index calls are a no-op if the indexes do not change, your APIs can
    // safely use create_indexes = true even when restarting all the time. 
    // Just be careful if the indexes change and the collection is large.
    let create_indexes = true;

    // will return a handle to 'users' collection on 'my-db', which has the specified indexes created.
    let users = mongo_indexed::collection::<User>(&db, create_indexes).await?;

    let user = users.find_one(doc! { "username": "mogh" }, None).await?;
    println!("{user:?}");

    Ok(())
}

Dependencies

~260–710KB
~17K SLoC