mongospec 0.0.3

Async MongoDB ODM with msgspec integration and automatic collection binding

mongospec

Minimal async MongoDB ODM built for speed and simplicity, featuring automatic collection binding and msgspec integration.

Why mongospec?

• ⚡ Blazing fast - Uses msgspec (fastest Python serialization) and mongojet (fastest async MongoDB wrapper)
• 🧩 Dead simple - No complex abstractions, just clean document handling
• 🏎️ Zero overhead - Optimized for performance-critical applications

Installation

pip install mongospec

Quick Start

import asyncio
from datetime import datetime

import mongojet
import msgspec

import mongospec
from mongospec import MongoDocument


class User(MongoDocument):
    __collection_name__ = "users"
    __indexes__ = [{"keys": [("email", 1)], "options": {"unique": True}}]

    name: str
    email: str
    created_at: datetime = msgspec.field(default_factory=datetime.now)


async def main():
    mongo_client = await mongojet.create_client("mongodb://localhost:27017")
    try:
        await mongospec.init(mongo_client.get_database("db"), document_types=[User])

        # Create and insert user
        user = User(name="Alice", email="[e-mail]")
        await user.insert()

        # Find document
        found = await User.find_one({"email": "[e-mail]"})
        print(found.dump())
    finally:
        await mongospec.close()


asyncio.run(main())

Performance Features

• 🚀 msgspec-powered serialization (2-10x faster than alternatives)
• ⚡ mongojet backend (faster than Motor with identical API)
• 🧬 Compiled structs for document models
• 📉 Minimal abstraction overhead

⚠️ Early Alpha Notice
Basic CRUD operations supported. Designed for rapid prototyping. Not production-ready. API will evolve.