About this project

OxiMod is a schema‑aware modeling layer for Rust that sits on top of the official MongoDB driver. It provides a Derive macro for collection‑backed and embedded models, enabling concise model definitions with validation, default values, indexes, and lifecycle hooks. The library adds typed query builders, update/delete helpers, aggregation pipelines, bulk writes, and session‑aware operations while still exposing the raw `mongodb::Collection` for advanced use‑cases such as compound indexes or custom pipelines. Installation is straightforward via Cargo, requiring `oximod`, `mongodb`, `serde` with derive support, and an async runtime like Tokio. A quick‑start example shows how to define a `User` model, connect to a MongoDB instance, create documents, and perform filtered queries. Full documentation, guides, and runnable examples are available in the repository, covering all features from validation to index drift reconciliation. The project is MIT‑licensed and targets Rust 1.88+ with the MongoDB driver 3.8+.