MongoForge

Magic filters for MongoDB

Installation

pip install mongoforge

Basic example

from pymongo import MongoClient
from mongoforge import F

cluster = MongoClient(...)
collection = cluster.db.users

if user := collection.find_one(F._id == 1): # {"_id": 1}
    print(user)
else:
    collection.insert_one(...)

Additional filters

# Or filter
F.or_f(F.name == "Alex", F.age > 18)

# In
F.name.in_({"Alex", "Bob"})

Available filters

Like ORM

from typing import Annotated
from pydantic import Field

from pymongo import MongoClient

from mongoforge import F, Q
from mongoforge.orm import Model

cluster = MongoClient("mongodb://localhost:27017")


class User(Model):
    id: Annotated[int, Field(..., alias="_id")]
    name: Annotated[str | None, Field(None)]
    balance: Annotated[int, Field(0)]

    class Meta:
        collection = cluster.db.users


user = User.one(F.name == "Alex")
if not user:
    User.insert(_id=1, name="Alex")
else:
    print(user.id, user.name, user.balance)
    user.update(Q(balance__inc=100))