mdb-engine 0.1.6__tar.gz → 0.1.7__tar.gz

mdb_engine-0.1.7/PKG-INFO

@@ -0,0 +1,285 @@
+Metadata-Version: 2.4
+Name: mdb-engine
+Version: 0.1.7
+Summary: MongoDB Engine
+Home-page: https://github.com/ranfysvalle02/mdb-engine
+Author: Your Name
+Author-email: Your Name <your.email@example.com>
+License: AGPL-3.0
+Project-URL: Homepage, https://github.com/ranfysvalle02/mdb-engine
+Project-URL: Documentation, https://github.com/ranfysvalle02/mdb-engine#readme
+Project-URL: Repository, https://github.com/ranfysvalle02/mdb-engine
+Project-URL: Issues, https://github.com/ranfysvalle02/mdb-engine/issues
+Keywords: mongodb,runtime,engine,database,scoping
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: motor>=3.0.0
+Requires-Dist: pymongo>=4.0.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: bcrypt>=4.0.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: mem0ai>=1.0.0
+Requires-Dist: semantic-text-splitter>=0.9.0
+Requires-Dist: numpy<2.0.0,>=1.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: azure-identity>=1.15.0
+Requires-Dist: click>=8.0.0
+Provides-Extra: casbin
+Requires-Dist: casbin>=1.0.0; extra == "casbin"
+Requires-Dist: casbin-motor-adapter>=0.1.0; extra == "casbin"
+Provides-Extra: oso
+Requires-Dist: oso-cloud>=0.1.0; extra == "oso"
+Provides-Extra: llm
+Provides-Extra: test
+Requires-Dist: pytest>=7.4.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.1.0; extra == "test"
+Requires-Dist: pytest-mock>=3.11.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.1.0; extra == "test"
+Requires-Dist: testcontainers>=3.7.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: semgrep>=1.50.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: casbin>=1.0.0; extra == "all"
+Requires-Dist: casbin-motor-adapter>=0.1.0; extra == "all"
+Requires-Dist: oso-cloud>=0.1.0; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# mdb-engine
+
+**The MongoDB Engine for Python Apps** — Auto-sandboxing, index management, and auth in one package.
+
+[![PyPI](https://img.shields.io/pypi/v/mdb-engine)](https://pypi.org/project/mdb-engine/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://opensource.org/licenses/AGPL-3.0)
+
+---
+
+## Installation
+
+```bash
+pip install mdb-engine
+```
+
+---
+
+## 30-Second Quick Start
+
+```python
+from pathlib import Path
+from mdb_engine import MongoDBEngine
+
+# 1. Initialize the engine
+engine = MongoDBEngine(
+    mongo_uri="mongodb://localhost:27017",
+    db_name="my_database"
+)
+
+# 2. Create a FastAPI app with automatic lifecycle management
+app = engine.create_app(slug="my_app", manifest=Path("manifest.json"))
+
+# 3. Use the scoped database - all queries automatically isolated
+@app.post("/tasks")
+async def create_task(task: dict):
+    db = engine.get_scoped_db("my_app")
+    result = await db.tasks.insert_one(task)
+    return {"id": str(result.inserted_id)}
+```
+
+That's it. Your data is automatically sandboxed, indexes are created, and cleanup is handled.
+
+---
+
+## Basic Examples
+
+### 1. Index Management
+
+Define indexes in your `manifest.json` — they're auto-created on startup:
+
+```json
+{
+  "schema_version": "2.0",
+  "slug": "my_app",
+  "name": "My App",
+  "status": "active",
+  "managed_indexes": {
+    "tasks": [
+      {
+        "type": "regular",
+        "keys": {"status": 1, "created_at": -1},
+        "name": "status_sort"
+      },
+      {
+        "type": "regular",
+        "keys": {"priority": -1},
+        "name": "priority_idx"
+      }
+    ],
+    "users": [
+      {
+        "type": "regular",
+        "keys": {"email": 1},
+        "name": "email_unique",
+        "unique": true
+      }
+    ]
+  }
+}
+```
+
+Supported index types: `regular`, `text`, `vector`, `ttl`, `compound`.
+
+### 2. CRUD Operations (Auto-Scoped)
+
+All database operations are automatically scoped to your app:
+
+```python
+db = engine.get_scoped_db("my_app")
+
+# Create
+await db.tasks.insert_one({"title": "Build feature", "status": "pending"})
+
+# Read  
+tasks = await db.tasks.find({"status": "pending"}).to_list(length=10)
+
+# Update
+await db.tasks.update_one({"_id": task_id}, {"$set": {"status": "done"}})
+
+# Delete
+await db.tasks.delete_one({"_id": task_id})
+```
+
+**What happens under the hood:**
+```python
+# You write:
+await db.tasks.find({}).to_list(length=10)
+
+# Engine executes:
+# Collection: my_app_tasks
+# Query: {"app_id": "my_app"}
+```
+
+### 3. Health Checks
+
+Built-in observability:
+
+```python
+@app.get("/health")
+async def health():
+    status = await engine.get_health_status()
+    return {"status": status.get("status", "unknown")}
+```
+
+---
+
+## Why mdb-engine?
+
+- **Zero boilerplate** — No more connection setup, index creation scripts, or auth handlers
+- **Data isolation** — Multi-tenant ready with automatic app sandboxing
+- **Manifest-driven** — Define your app's "DNA" in JSON, not scattered code
+- **No lock-in** — Standard Motor/PyMongo underneath; export anytime with `mongodump --query='{"app_id":"my_app"}'`
+
+---
+
+## Advanced Features
+
+| Feature | Description | Learn More |
+|---------|-------------|------------|
+| **Authentication** | JWT + Casbin/OSO RBAC | [Auth Guide](https://github.com/ranfysvalle02/mdb-engine/blob/main/docs/AUTHZ.md) |
+| **Vector Search** | Atlas Vector Search + embeddings | [RAG Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/interactive_rag) |
+| **Memory Service** | Persistent AI memory with Mem0 | [Chat Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/chit_chat) |
+| **WebSockets** | Real-time updates from manifest | [Docs](https://github.com/ranfysvalle02/mdb-engine/blob/main/docs/ARCHITECTURE.md) |
+| **Multi-App** | Secure cross-app data access | [Multi-App Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app) |
+| **SSO** | Shared auth across apps | [Shared Auth Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app_shared) |
+
+---
+
+## Full Examples
+
+Clone and run:
+
+```bash
+git clone https://github.com/ranfysvalle02/mdb-engine.git
+cd mdb-engine/examples/basic/chit_chat
+docker-compose up --build
+```
+
+### Basic Examples
+
+| Example | Description |
+|---------|-------------|
+| [chit_chat](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/chit_chat) | AI chat with persistent memory |
+| [interactive_rag](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/interactive_rag) | RAG with vector search |
+| [oso_hello_world](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/oso_hello_world) | OSO Cloud authorization |
+| [parallax](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/parallax) | Dynamic schema generation |
+| [vector_hacking](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/vector_hacking) | Vector embeddings & attacks |
+
+### Advanced Examples
+
+| Example | Description |
+|---------|-------------|
+| [simple_app](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/simple_app) | Task management with `create_app()` pattern |
+| [multi_app](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app) | Multi-tenant with cross-app access |
+| [multi_app_shared](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app_shared) | SSO with shared user pool |
+
+---
+
+## Manual Setup (Alternative)
+
+If you need more control over the FastAPI lifecycle:
+
+```python
+from pathlib import Path
+from fastapi import FastAPI
+from mdb_engine import MongoDBEngine
+
+app = FastAPI()
+engine = MongoDBEngine(mongo_uri="mongodb://localhost:27017", db_name="my_database")
+
+@app.on_event("startup")
+async def startup():
+    await engine.initialize()
+    manifest = await engine.load_manifest(Path("manifest.json"))
+    await engine.register_app(manifest, create_indexes=True)
+
+@app.on_event("shutdown")
+async def shutdown():
+    await engine.shutdown()
+
+@app.get("/items")
+async def get_items():
+    db = engine.get_scoped_db("my_app")
+    return await db.items.find({}).to_list(length=10)
+```
+
+---
+
+## Links
+
+- [GitHub Repository](https://github.com/ranfysvalle02/mdb-engine)
+- [Documentation](https://github.com/ranfysvalle02/mdb-engine/tree/main/docs)
+- [All Examples](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples)
+- [Quick Start Guide](https://github.com/ranfysvalle02/mdb-engine/blob/main/docs/QUICK_START.md)
+- [Contributing](https://github.com/ranfysvalle02/mdb-engine/blob/main/CONTRIBUTING.md)
+
+---
+
+**Stop building scaffolding. Start building features.**

mdb_engine-0.1.7/README.md

@@ -0,0 +1,220 @@
+# mdb-engine
+
+**The MongoDB Engine for Python Apps** — Auto-sandboxing, index management, and auth in one package.
+
+[![PyPI](https://img.shields.io/pypi/v/mdb-engine)](https://pypi.org/project/mdb-engine/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://opensource.org/licenses/AGPL-3.0)
+
+---
+
+## Installation
+
+```bash
+pip install mdb-engine
+```
+
+---
+
+## 30-Second Quick Start
+
+```python
+from pathlib import Path
+from mdb_engine import MongoDBEngine
+
+# 1. Initialize the engine
+engine = MongoDBEngine(
+    mongo_uri="mongodb://localhost:27017",
+    db_name="my_database"
+)
+
+# 2. Create a FastAPI app with automatic lifecycle management
+app = engine.create_app(slug="my_app", manifest=Path("manifest.json"))
+
+# 3. Use the scoped database - all queries automatically isolated
+@app.post("/tasks")
+async def create_task(task: dict):
+    db = engine.get_scoped_db("my_app")
+    result = await db.tasks.insert_one(task)
+    return {"id": str(result.inserted_id)}
+```
+
+That's it. Your data is automatically sandboxed, indexes are created, and cleanup is handled.
+
+---
+
+## Basic Examples
+
+### 1. Index Management
+
+Define indexes in your `manifest.json` — they're auto-created on startup:
+
+```json
+{
+  "schema_version": "2.0",
+  "slug": "my_app",
+  "name": "My App",
+  "status": "active",
+  "managed_indexes": {
+    "tasks": [
+      {
+        "type": "regular",
+        "keys": {"status": 1, "created_at": -1},
+        "name": "status_sort"
+      },
+      {
+        "type": "regular",
+        "keys": {"priority": -1},
+        "name": "priority_idx"
+      }
+    ],
+    "users": [
+      {
+        "type": "regular",
+        "keys": {"email": 1},
+        "name": "email_unique",
+        "unique": true
+      }
+    ]
+  }
+}
+```
+
+Supported index types: `regular`, `text`, `vector`, `ttl`, `compound`.
+
+### 2. CRUD Operations (Auto-Scoped)
+
+All database operations are automatically scoped to your app:
+
+```python
+db = engine.get_scoped_db("my_app")
+
+# Create
+await db.tasks.insert_one({"title": "Build feature", "status": "pending"})
+
+# Read  
+tasks = await db.tasks.find({"status": "pending"}).to_list(length=10)
+
+# Update
+await db.tasks.update_one({"_id": task_id}, {"$set": {"status": "done"}})
+
+# Delete
+await db.tasks.delete_one({"_id": task_id})
+```
+
+**What happens under the hood:**
+```python
+# You write:
+await db.tasks.find({}).to_list(length=10)
+
+# Engine executes:
+# Collection: my_app_tasks
+# Query: {"app_id": "my_app"}
+```
+
+### 3. Health Checks
+
+Built-in observability:
+
+```python
+@app.get("/health")
+async def health():
+    status = await engine.get_health_status()
+    return {"status": status.get("status", "unknown")}
+```
+
+---
+
+## Why mdb-engine?
+
+- **Zero boilerplate** — No more connection setup, index creation scripts, or auth handlers
+- **Data isolation** — Multi-tenant ready with automatic app sandboxing
+- **Manifest-driven** — Define your app's "DNA" in JSON, not scattered code
+- **No lock-in** — Standard Motor/PyMongo underneath; export anytime with `mongodump --query='{"app_id":"my_app"}'`
+
+---
+
+## Advanced Features
+
+| Feature | Description | Learn More |
+|---------|-------------|------------|
+| **Authentication** | JWT + Casbin/OSO RBAC | [Auth Guide](https://github.com/ranfysvalle02/mdb-engine/blob/main/docs/AUTHZ.md) |
+| **Vector Search** | Atlas Vector Search + embeddings | [RAG Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/interactive_rag) |
+| **Memory Service** | Persistent AI memory with Mem0 | [Chat Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/chit_chat) |
+| **WebSockets** | Real-time updates from manifest | [Docs](https://github.com/ranfysvalle02/mdb-engine/blob/main/docs/ARCHITECTURE.md) |
+| **Multi-App** | Secure cross-app data access | [Multi-App Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app) |
+| **SSO** | Shared auth across apps | [Shared Auth Example](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app_shared) |
+
+---
+
+## Full Examples
+
+Clone and run:
+
+```bash
+git clone https://github.com/ranfysvalle02/mdb-engine.git
+cd mdb-engine/examples/basic/chit_chat
+docker-compose up --build
+```
+
+### Basic Examples
+
+| Example | Description |
+|---------|-------------|
+| [chit_chat](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/chit_chat) | AI chat with persistent memory |
+| [interactive_rag](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/interactive_rag) | RAG with vector search |
+| [oso_hello_world](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/oso_hello_world) | OSO Cloud authorization |
+| [parallax](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/parallax) | Dynamic schema generation |
+| [vector_hacking](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/basic/vector_hacking) | Vector embeddings & attacks |
+
+### Advanced Examples
+
+| Example | Description |
+|---------|-------------|
+| [simple_app](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/simple_app) | Task management with `create_app()` pattern |
+| [multi_app](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app) | Multi-tenant with cross-app access |
+| [multi_app_shared](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples/advanced/multi_app_shared) | SSO with shared user pool |
+
+---
+
+## Manual Setup (Alternative)
+
+If you need more control over the FastAPI lifecycle:
+
+```python
+from pathlib import Path
+from fastapi import FastAPI
+from mdb_engine import MongoDBEngine
+
+app = FastAPI()
+engine = MongoDBEngine(mongo_uri="mongodb://localhost:27017", db_name="my_database")
+
+@app.on_event("startup")
+async def startup():
+    await engine.initialize()
+    manifest = await engine.load_manifest(Path("manifest.json"))
+    await engine.register_app(manifest, create_indexes=True)
+
+@app.on_event("shutdown")
+async def shutdown():
+    await engine.shutdown()
+
+@app.get("/items")
+async def get_items():
+    db = engine.get_scoped_db("my_app")
+    return await db.items.find({}).to_list(length=10)
+```
+
+---
+
+## Links
+
+- [GitHub Repository](https://github.com/ranfysvalle02/mdb-engine)
+- [Documentation](https://github.com/ranfysvalle02/mdb-engine/tree/main/docs)
+- [All Examples](https://github.com/ranfysvalle02/mdb-engine/tree/main/examples)
+- [Quick Start Guide](https://github.com/ranfysvalle02/mdb-engine/blob/main/docs/QUICK_START.md)
+- [Contributing](https://github.com/ranfysvalle02/mdb-engine/blob/main/CONTRIBUTING.md)
+
+---
+
+**Stop building scaffolding. Start building features.**

mdb_engine-0.1.7/mdb_engine/__init__.py

@@ -0,0 +1,69 @@
+"""
+MDB_ENGINE - MongoDB Engine
+
+Enterprise-grade engine for building applications
+with automatic database scoping, authentication, and resource management.
+
+Usage:
+    # Simple usage
+    from mdb_engine import MongoDBEngine
+    engine = MongoDBEngine(mongo_uri=..., db_name=...)
+    await engine.initialize()
+    db = engine.get_scoped_db("my_app")
+
+    # With FastAPI integration
+    app = engine.create_app(slug="my_app", manifest=Path("manifest.json"))
+
+    # With Ray support (optional)
+    engine = MongoDBEngine(..., enable_ray=True)
+"""
+
+# Authentication
+from .auth import AuthorizationProvider, get_current_user, require_admin
+
+# Optional Ray integration
+# Core MongoDB Engine
+from .core import (
+    RAY_AVAILABLE,
+    AppRayActor,
+    ManifestParser,
+    ManifestValidator,
+    MongoDBEngine,
+    get_ray_actor_handle,
+    ray_actor_decorator,
+)
+
+# Database layer
+from .database import AppDB, ScopedMongoWrapper
+
+# Index management
+from .indexes import (
+    AsyncAtlasIndexManager,
+    AutoIndexManager,
+    run_index_creation_for_collection,
+)
+
+__version__ = "0.1.6"
+
+__all__ = [
+    # Core (includes FastAPI integration and optional Ray)
+    "MongoDBEngine",
+    "ManifestValidator",
+    "ManifestParser",
+    # Ray Integration (optional - only active if Ray installed)
+    "RAY_AVAILABLE",
+    "AppRayActor",
+    "get_ray_actor_handle",
+    "ray_actor_decorator",
+    # Database
+    "ScopedMongoWrapper",
+    "AppDB",
+    # Auth
+    "AuthorizationProvider",
+    "get_current_user",
+    "require_admin",
+    # Indexes
+    "AsyncAtlasIndexManager",
+    "AutoIndexManager",
+    "run_index_creation_for_collection",
+]