tenants2fast-fastapi 0.1.0__tar.gz

tenants2fast_fastapi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Angel Daniel Sanchez Castillo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tenants2fast_fastapi-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+recursive-include docs *.md *.example
+recursive-include examples *.py
+recursive-include src/tenant2fast_fastapi *.py *.html
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store

tenants2fast_fastapi-0.1.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: tenants2fast-fastapi
+Version: 0.1.0
+Summary: Multi-tenancy management module for FastAPI with tenant isolation and permission-aware middleware
+Author-email: Angel Daniel Sanchez Castillo <angeldaniel.sanchezcastillo@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Angel Daniel Sanchez Castillo
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi
+Project-URL: Documentation, https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi/tree/main/docs
+Project-URL: Repository, https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi
+Project-URL: Issues, https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi/issues
+Keywords: fastapi,multitenancy,tenants,sqlmodel,middleware,rbac
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: permissions2fast-fastapi>=0.5.1
+Dynamic: license-file
+
+# tenants2fast-fastapi
+
+🏢 **Multi-tenancy management for FastAPI** — tenant isolation, JWT-aware middleware, and permission-gated endpoints, all wired up in minutes.
+
+Part of the **\*2fast-fastapi** ecosystem: [oauth2fast-fastapi](https://github.com/AngelDanielSanchezCastillo/oauth2fast-fastapi) → [permissions2fast-fastapi](https://github.com/AngelDanielSanchezCastillo/permissions2fast-fastapi) → **tenants2fast-fastapi**.
+
+---
+
+## Features
+
+- 🔐 **JWT-aware `TenantMiddleware`** — extracts user from Bearer token and sets tenant context automatically on every request
+- 🏗️ **Isolated tenant databases** — each tenant gets its own PostgreSQL database, created and initialized at runtime
+- 🗂️ **`Tenant` and `UserTenant` SQLModel models** — ready-to-use ORM models with audit timestamps
+- ⚡ **Redis caching** — tenant data and user permissions are cached via `permissions2fast-fastapi`
+- 🔒 **`require_permission` dependency** — guard any route with a single line using the RBAC system from `permissions2fast-fastapi`
+
+---
+
+## Installation
+
+```bash
+pip install tenants2fast-fastapi
+```
+
+Or with `uv`:
+
+```bash
+uv add tenants2fast-fastapi
+```
+
+---
+
+## Quick Start
+
+```python
+from fastapi import Depends, FastAPI
+from tenant2fast_fastapi import (
+    TenantMiddleware,
+    get_current_tenant,
+    get_current_user,
+    require_permission,
+)
+
+app = FastAPI()
+
+# 1. Register the middleware
+app.add_middleware(TenantMiddleware)
+
+# 2. Use dependencies in your endpoints
+@app.get("/me/tenant")
+async def my_tenant(tenant=Depends(get_current_tenant)):
+    return {"name": tenant.name, "slug": tenant.slug}
+
+@app.get("/reports", dependencies=[Depends(require_permission("/reports", "GET"))])
+async def reports(user=Depends(get_current_user)):
+    return {"user": user.email}
+```
+
+See [`examples/basic_usage.py`](examples/basic_usage.py) for a more complete example.
+
+---
+
+## Configuration
+
+All settings use the `TENANT_` prefix and can be provided via environment variables or a `.env` file.
+
+| Variable | Default | Description |
+|---|---|---|
+| `TENANT_DB_PREFIX` | `tenant_` | Prefix for per-tenant database names |
+| `TENANT_SUPERUSER_DB__HOSTNAME` | `localhost` | PG host for superuser operations |
+| `TENANT_SUPERUSER_DB__PORT` | `5432` | PG port |
+| `TENANT_SUPERUSER_DB__USERNAME` | `postgres` | PG superuser username |
+| `TENANT_SUPERUSER_DB__PASSWORD` | `postgres` | PG superuser password |
+| `TENANT_SUPERUSER_DB__NAME` | `postgres` | Default DB for superuser connection |
+| `TENANT_MAX_TENANT_CONNECTIONS` | `5` | Connection pool size per tenant |
+
+In addition, all variables required by `oauth2fast-fastapi` (JWT, DB connections, mail) and `permissions2fast-fastapi` (Redis) must be set — see their respective READMEs.
+
+---
+
+## Public API
+
+```python
+from tenant2fast_fastapi import (
+    Tenant,                   # SQLModel ORM model (table: tenants)
+    UserTenant,               # Many-to-many User ↔ Tenant (table: user_tenants)
+    TenantMiddleware,         # Starlette BaseHTTPMiddleware
+    get_current_tenant,       # FastAPI dependency → Tenant
+    get_current_user,         # FastAPI dependency → User (from oauth2fast-fastapi)
+    require_permission,       # Dependency factory → checks RBAC + cache
+    create_tenant_database,   # async — creates a PG database for a tenant
+    get_tenant_engine,        # returns (cached) AsyncEngine for a tenant DB
+    initialize_tenant_schema, # async — runs SQLModel.metadata.create_all on tenant DB
+)
+```
+
+---
+
+## Development
+
+```bash
+# Clone and install in editable mode with dev + test dependencies
+git clone https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi
+cd tenants2fast-fastapi
+uv sync --group dev --group test
+
+# Copy .env and adjust to your local setup
+cp .env .env.local   # or just edit .env directly
+
+# Run tests (requires PostgreSQL + Redis)
+uv run pytest tests/ -v
+
+# Build distribution
+uv build
+```
+
+---
+
+## Related Packages
+
+| Package | PyPI | Purpose |
+|---|---|---|
+| `log2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/log2fast-fastapi)](https://pypi.org/project/log2fast-fastapi/) | Structured logging |
+| `pgsqlasync2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/pgsqlasync2fast-fastapi)](https://pypi.org/project/pgsqlasync2fast-fastapi/) | Async PostgreSQL connection manager |
+| `mailing2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/mailing2fast-fastapi)](https://pypi.org/project/mailing2fast-fastapi/) | SMTP email sender |
+| `oauth2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/oauth2fast-fastapi)](https://pypi.org/project/oauth2fast-fastapi/) | JWT Auth + User management |
+| `permissions2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/permissions2fast-fastapi)](https://pypi.org/project/permissions2fast-fastapi/) | RBAC + Redis permission cache |
+
+---
+
+## License
+
+MIT © [Angel Daniel Sanchez Castillo](https://github.com/AngelDanielSanchezCastillo)

tenants2fast_fastapi-0.1.0/README.md

@@ -0,0 +1,133 @@
+# tenants2fast-fastapi
+
+🏢 **Multi-tenancy management for FastAPI** — tenant isolation, JWT-aware middleware, and permission-gated endpoints, all wired up in minutes.
+
+Part of the **\*2fast-fastapi** ecosystem: [oauth2fast-fastapi](https://github.com/AngelDanielSanchezCastillo/oauth2fast-fastapi) → [permissions2fast-fastapi](https://github.com/AngelDanielSanchezCastillo/permissions2fast-fastapi) → **tenants2fast-fastapi**.
+
+---
+
+## Features
+
+- 🔐 **JWT-aware `TenantMiddleware`** — extracts user from Bearer token and sets tenant context automatically on every request
+- 🏗️ **Isolated tenant databases** — each tenant gets its own PostgreSQL database, created and initialized at runtime
+- 🗂️ **`Tenant` and `UserTenant` SQLModel models** — ready-to-use ORM models with audit timestamps
+- ⚡ **Redis caching** — tenant data and user permissions are cached via `permissions2fast-fastapi`
+- 🔒 **`require_permission` dependency** — guard any route with a single line using the RBAC system from `permissions2fast-fastapi`
+
+---
+
+## Installation
+
+```bash
+pip install tenants2fast-fastapi
+```
+
+Or with `uv`:
+
+```bash
+uv add tenants2fast-fastapi
+```
+
+---
+
+## Quick Start
+
+```python
+from fastapi import Depends, FastAPI
+from tenant2fast_fastapi import (
+    TenantMiddleware,
+    get_current_tenant,
+    get_current_user,
+    require_permission,
+)
+
+app = FastAPI()
+
+# 1. Register the middleware
+app.add_middleware(TenantMiddleware)
+
+# 2. Use dependencies in your endpoints
+@app.get("/me/tenant")
+async def my_tenant(tenant=Depends(get_current_tenant)):
+    return {"name": tenant.name, "slug": tenant.slug}
+
+@app.get("/reports", dependencies=[Depends(require_permission("/reports", "GET"))])
+async def reports(user=Depends(get_current_user)):
+    return {"user": user.email}
+```
+
+See [`examples/basic_usage.py`](examples/basic_usage.py) for a more complete example.
+
+---
+
+## Configuration
+
+All settings use the `TENANT_` prefix and can be provided via environment variables or a `.env` file.
+
+| Variable | Default | Description |
+|---|---|---|
+| `TENANT_DB_PREFIX` | `tenant_` | Prefix for per-tenant database names |
+| `TENANT_SUPERUSER_DB__HOSTNAME` | `localhost` | PG host for superuser operations |
+| `TENANT_SUPERUSER_DB__PORT` | `5432` | PG port |
+| `TENANT_SUPERUSER_DB__USERNAME` | `postgres` | PG superuser username |
+| `TENANT_SUPERUSER_DB__PASSWORD` | `postgres` | PG superuser password |
+| `TENANT_SUPERUSER_DB__NAME` | `postgres` | Default DB for superuser connection |
+| `TENANT_MAX_TENANT_CONNECTIONS` | `5` | Connection pool size per tenant |
+
+In addition, all variables required by `oauth2fast-fastapi` (JWT, DB connections, mail) and `permissions2fast-fastapi` (Redis) must be set — see their respective READMEs.
+
+---
+
+## Public API
+
+```python
+from tenant2fast_fastapi import (
+    Tenant,                   # SQLModel ORM model (table: tenants)
+    UserTenant,               # Many-to-many User ↔ Tenant (table: user_tenants)
+    TenantMiddleware,         # Starlette BaseHTTPMiddleware
+    get_current_tenant,       # FastAPI dependency → Tenant
+    get_current_user,         # FastAPI dependency → User (from oauth2fast-fastapi)
+    require_permission,       # Dependency factory → checks RBAC + cache
+    create_tenant_database,   # async — creates a PG database for a tenant
+    get_tenant_engine,        # returns (cached) AsyncEngine for a tenant DB
+    initialize_tenant_schema, # async — runs SQLModel.metadata.create_all on tenant DB
+)
+```
+
+---
+
+## Development
+
+```bash
+# Clone and install in editable mode with dev + test dependencies
+git clone https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi
+cd tenants2fast-fastapi
+uv sync --group dev --group test
+
+# Copy .env and adjust to your local setup
+cp .env .env.local   # or just edit .env directly
+
+# Run tests (requires PostgreSQL + Redis)
+uv run pytest tests/ -v
+
+# Build distribution
+uv build
+```
+
+---
+
+## Related Packages
+
+| Package | PyPI | Purpose |
+|---|---|---|
+| `log2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/log2fast-fastapi)](https://pypi.org/project/log2fast-fastapi/) | Structured logging |
+| `pgsqlasync2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/pgsqlasync2fast-fastapi)](https://pypi.org/project/pgsqlasync2fast-fastapi/) | Async PostgreSQL connection manager |
+| `mailing2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/mailing2fast-fastapi)](https://pypi.org/project/mailing2fast-fastapi/) | SMTP email sender |
+| `oauth2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/oauth2fast-fastapi)](https://pypi.org/project/oauth2fast-fastapi/) | JWT Auth + User management |
+| `permissions2fast-fastapi` | [![PyPI](https://img.shields.io/pypi/v/permissions2fast-fastapi)](https://pypi.org/project/permissions2fast-fastapi/) | RBAC + Redis permission cache |
+
+---
+
+## License
+
+MIT © [Angel Daniel Sanchez Castillo](https://github.com/AngelDanielSanchezCastillo)

tenants2fast_fastapi-0.1.0/examples/basic_usage.py

@@ -0,0 +1,57 @@
+"""
+basic_usage.py – minimal example of tenants2fast-fastapi integration.
+
+Demonstrates how to:
+  1. Add TenantMiddleware to a FastAPI app
+  2. Use get_current_tenant and get_current_user as dependencies
+  3. Use require_permission to guard routes
+"""
+
+from fastapi import Depends, FastAPI
+
+from tenant2fast_fastapi import (
+    TenantMiddleware,
+    get_current_tenant,
+    get_current_user,
+    require_permission,
+)
+from tenant2fast_fastapi.models.tenant_model import Tenant2Read
+
+app = FastAPI(title="tenants2fast-fastapi Example")
+
+# ── Register the tenant middleware ────────────────────────────────────────────
+# Intercepts every request, decodes the JWT, and sets the tenant + user context
+# before the request reaches the endpoint.
+app.add_middleware(TenantMiddleware)
+
+
+# ── Protected endpoints ───────────────────────────────────────────────────────
+
+@app.get("/me/tenant", response_model=Tenant2Read)
+async def get_my_tenant(tenant=Depends(get_current_tenant)):
+    """Return the tenant for the authenticated user."""
+    return tenant
+
+
+@app.get("/me")
+async def get_me(user=Depends(get_current_user)):
+    """Return basic info about the authenticated user."""
+    return {"id": user.id, "email": user.email}
+
+
+@app.get(
+    "/reports",
+    dependencies=[Depends(require_permission("/reports", "GET"))],
+)
+async def get_reports(user=Depends(get_current_user)):
+    """
+    Permission-gated endpoint.
+    The user must have an explicit permission or a role that grants GET /reports.
+    """
+    return {"message": f"Hello {user.email}, here are your reports."}
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(app, host="0.0.0.0", port=8000)

tenants2fast_fastapi-0.1.0/pyproject.toml

@@ -0,0 +1,78 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tenants2fast-fastapi"
+version = "0.1.0"
+description = "Multi-tenancy management module for FastAPI with tenant isolation and permission-aware middleware"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {file = "LICENSE"}
+authors = [
+    {name = "Angel Daniel Sanchez Castillo", email = "angeldaniel.sanchezcastillo@gmail.com"}
+]
+keywords = ["fastapi", "multitenancy", "tenants", "sqlmodel", "middleware", "rbac"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Framework :: FastAPI",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    # Pulls in pgsqlasync2fast-fastapi, mailing2fast-fastapi,
+    # log2fast-fastapi, sqlmodel, fastapi, pydantic, etc. transitively.
+    "permissions2fast-fastapi>=0.5.1",
+]
+
+[dependency-groups]
+dev = [
+    "black",
+    "ruff",
+    "mypy>=1.0.0",
+    "pre-commit",
+    "build",
+    "twine",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "httpx>=0.24.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi"
+Documentation = "https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi/tree/main/docs"
+Repository = "https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi"
+Issues = "https://github.com/AngelDanielSanchezCastillo/tenants2fast-fastapi/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["tenant2fast_fastapi*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false

tenants2fast_fastapi-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tenants2fast_fastapi-0.1.0/src/tenant2fast_fastapi/__init__.py

@@ -0,0 +1,47 @@
+"""
+tenant2fast-fastapi
+
+Multi-tenancy system for FastAPI applications.
+Provides tenant management, user-tenant relationships, and tenant isolation.
+"""
+
+from .__version__ import __version__
+from .models.tenant_model import Tenant, TenantRead
+from .middleware.tenant_middleware import TenantMiddleware
+from .databases.tenant_db_factory import (
+    create_tenant_database,
+    get_tenant_engine,
+    initialize_tenant_schema,
+)
+from .dependencies import (
+    get_current_tenant,
+    get_current_user,
+    has_tenant_permission,
+    has_tenant_role,
+    get_current_tenant_user,
+    load_tenant_by_id,
+    get_tenant_context,
+    get_user_context,
+    set_tenant_context,
+    set_user_context,
+)
+
+__all__ = [
+    "__version__",
+    "Tenant",
+    "TenantRead",
+    "TenantMiddleware",
+    "get_current_tenant",
+    "get_current_user",
+    "has_tenant_permission",
+    "has_tenant_role",
+    "get_current_tenant_user",
+    "load_tenant_by_id",
+    "get_tenant_context",
+    "get_user_context",
+    "set_tenant_context",
+    "set_user_context",
+    "create_tenant_database",
+    "get_tenant_engine",
+    "initialize_tenant_schema",
+]

tenants2fast_fastapi-0.1.0/src/tenant2fast_fastapi/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

tenants2fast_fastapi-0.1.0/src/tenant2fast_fastapi/databases/__init__.py

@@ -0,0 +1,13 @@
+"""Database utilities for tenant2fast-fastapi"""
+
+from .tenant_db_factory import (
+    create_tenant_database,
+    delete_tenant_database,
+    initialize_tenant_schema,
+)
+
+__all__ = [
+    "create_tenant_database",
+    "delete_tenant_database",
+    "initialize_tenant_schema",
+]