LazyQL 0.1.1

A FastAPI and Strawberry GraphQL library to create CRUD APIs over MongoDB with advanced filtering capabilities.

🦥 LazyQL

LazyQL is a powerful Python library designed to instantly generate full-featured GraphQL CRUD APIs using Pydantic models and MongoDB (via Motor).

It automates the tedious parts of backend development—schema generation, resolvers, filtering, and database interactions—while providing built-in enterprise-grade features like audit logging, soft deletes, and field-level permissions.

---

🚀 Key Features

• Instant CRUD: Generate Strawberry GraphQL Query and Mutation types directly from Pydantic models.
• MongoDB & Async: Built on top of motor for high-performance asynchronous database interactions.
• Advanced Filtering: Built-in support for rich filters (e.g., name_contains, age_gte, tags_in).
• Audit Logging: Automatic tracking of all changes (Create, Update, Delete, Restore) in a Time Series collection.
• Soft Deletes: Native support for soft deletion and restoration of documents.
• Permissions: Granular permission system for create, update, delete, and list operations.
• ACID Transactions: Support for MongoDB transactions when a client session is available.
• Extensible: Easily customize and extend generated resolvers and schemas.

---

📦 Installation

pip install lazyql

---

⚡ Quick Start

Define your data model and generate a GraphQL API in seconds.

1. Define your Model

Inherit from BaseDBModel to get automatic ID, timestamps (created_at, updated_at), and audit fields.

from lazyql import BaseDBModel
from pydantic import Field

class User(BaseDBModel):
    name: str
    email: str
    role: str = Field(default="user")
    age: int

2. Generate GraphQL Schema

Use create_crud_api to build the Query and Mutation classes.

import strawberry
from lazyql import create_crud_api

# Generate CRUD resolvers
Query, Mutation = create_crud_api(
    model=User,
    collection_name="users"
)

# Create the executable schema
schema = strawberry.Schema(query=Query, mutation=Mutation)

3. Run It

Integrate with your favorite ASGI framework (e.g., FastAPI, Starlette).

---

📄 License

LazyQL is licensed under the MIT License. See the LICENSE file for details.