fenrir-framework 0.1.0__tar.gz

fenrir_framework-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IshikawaUta
+
+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.

fenrir_framework-0.1.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: fenrir-framework
+Version: 0.1.0
+Summary: A hybrid Python web framework combining Flask, FastAPI, Bottle, Falcon, and Sanic
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: asteri>=2.2.2
+Requires-Dist: itsdangerous>=2.0.0
+Requires-Dist: python-multipart>=0.0.18
+Dynamic: license-file
+
+<p align="center">
+  <img src="logo.jpg" alt="Fenrir Logo" width="300px"/>
+</p>
+
+# Fenrir Web Framework
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)
+[![Tests](https://img.shields.io/badge/Tests-478%20Passed-brightgreen.svg)]()
+[![Performance](https://img.shields.io/badge/Performance-High--Speed%20ASGI-orange.svg)]()
+
+**Fenrir** is a state-of-the-art, high-performance, hybrid Python web framework built on top of modern ASGI specifications. It elegantly merges the best programming paradigms from Python's most popular web frameworks (**Flask**, **FastAPI**, **Sanic**, **Falcon**, and **Bottle**) into a single unified workspace, powered locally by the premium **Asteri v2.2.2** application server.
+
+Whether you prefer the automatic Pydantic validation of FastAPI, the seamless context-locals of Flask, the raw class-based speed of Falcon, or the robust background task model of Sanic, **Fenrir** allows you to leverage them all simultaneously in the same codebase.
+
+---
+
+## 🌟 Key Features
+
+*   **⚡ High-Speed ASGI Core**: Extremely low-overhead routing and handler pipeline, achieving massive request throughput.
+*   **🧩 Framework Hybridization**:
+    *   **FastAPI Paradigm**: Native Pydantic v2 data validation, `Annotated` type decorators, automated parameter resolution (`Query`, `Path`, `Header`, `Cookie`, `Body`), dynamic dependency injection (`Depends`), and automated `response_model` serialization.
+    *   **Flask Paradigm**: Thread/Task-safe context locals (`request`, `g`, `session`), Jinja2 template rendering (`render_template`), and request teardown hooks.
+    *   **Falcon Paradigm**: Class-based resource controllers (`on_get`, `on_post`), before/after hooks, and in-place response mutation.
+    *   **Sanic Paradigm**: Global `sys.modules` patching (`install_sanic_compat()`), standard response helpers (`json`, `text`, `html`, `raw`, `redirect`), lifecycle listeners (`before_server_start`, etc.), and a background event scheduler (`app.add_task`).
+    *   **Bottle Paradigm**: Built-in WSGI-to-ASGI wrapper and legacy mount adapter (`app.mount_wsgi()`) to run old WSGI applications at ASGI speeds.
+*   **📖 Auto-Generated OpenAPI Docs**: Interactive **Swagger UI** (`/docs`) and **ReDoc** (`/redoc`) instantly generated from your Pydantic schemas and route metadata.
+*   **🔌 Modern Communications**: Out-of-the-box support for **WebSockets** and **Server-Sent Events (SSE)**.
+*   **🛠️ Premium CLI Tooling**: Visual route tables, interactive app shell, in-memory benchmarking suite, project scaffolding, and environment system inspection.
+
+---
+
+## 📦 Installation
+
+To install Fenrir in development mode, clone the repository and run:
+
+```bash
+pip install -e .
+```
+
+To install all optimal development and testing dependencies:
+
+```bash
+pip install pytest httpx watchdog pydantic jinja2 asteri>=2.2.2
+```
+
+---
+
+## 🚀 Quick Start (The Hybrid Power)
+
+Here is a simple example (`demo_app.py`) showcasing how Flask, FastAPI, Falcon, and Sanic styles coexist harmoniously in a single application:
+
+```python
+import logging
+from pydantic import BaseModel
+from fenrir import (
+    Fenrir, Blueprint, request, g, Depends, Query, Header,
+    render_template, Response, Form, File, UploadFile,
+    WebSocket, WebSocketDisconnect
+)
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("demo")
+
+# Initialize the Hybrid App
+app = Fenrir(title="Fenrir Hybrid Demo", version="1.0.0")
+
+# --- 1. FastAPI-Style Validation & DI ---
+class UserRegister(BaseModel):
+    username: str
+    email: str
+    age: int
+
+async def verify_api_key(x_api_key: str = Header(default=None)):
+    if x_api_key != "super-secret-key":
+        logger.warning("Invalid API key attempt")
+    return x_api_key
+
+# --- 2. Flask-Style Routing & Context-Locals ---
+@app.get("/")
+async def home():
+    name = request.args.get("name", "Fenrir Developer")
+    return render_template("index.html", name=name)
+
+# --- 3. Falcon-Style Class-Based Resources ---
+class ItemResource:
+    async def on_get(self, req, resp, item_id: int):
+        resp.status = 200
+        resp.media = {"item_id": item_id, "style": "Falcon Resource"}
+
+app.add_route("/items/<item_id:int>", ItemResource())
+
+# --- 4. Sanic-Style Listeners & Background Tasks ---
+@app.listener("before_server_start")
+async def setup_db(app_instance):
+    logger.info("Initializing mock database...")
+
+@app.middleware("request")
+async def log_request(req):
+    logger.info(f"Incoming: {req.method} {req.path}")
+    g.user_role = "guest"  # Share state using Flask-style 'g'
+
+# Run with Asteri ASGI server
+if __name__ == "__main__":
+    app.run(host="127.0.0.1", port=8000, workers=2)
+```
+
+---
+
+## 💻 CLI Command Reference
+
+Fenrir comes packed with a high-fidelity, visually rich command-line tool. Start the CLI by executing `fenrir` or `python -m fenrir.cli`.
+
+### 1. `fenrir run`
+Serve your application locally. Powered by **Asteri v2.2.2**, supporting dynamic multiprocessing, worker management, and live hot-reloading.
+```bash
+fenrir run demo_app:app --port 8000 --dev
+```
+*   **Flags**:
+    *   `-H`, `--host`: Host bind address (default: `127.0.0.1`).
+    *   `-p`, `--port`: Port number (default: `8000`).
+    *   `-w`, `--workers`: Number of concurrent workers (default: `1`).
+    *   `-d`, `--dev` / `--reload`: Active development mode with auto-reload.
+
+### 2. `fenrir routes`
+Print a beautiful, colorized structural table of all registered HTTP endpoints, methods, matching handlers, and associated blueprints.
+```bash
+fenrir routes demo_app:app
+```
+**Output Example:**
+```text
+----------------------------------------------------------------
+Path                  Methods        Handler           Blueprint
+----------------------------------------------------------------
+/openapi.json         GET, OPTIONS   openapi_endpoint  -        
+/docs                 GET, OPTIONS   swagger_ui        -        
+/                     GET, OPTIONS   home              -        
+/items/<item_id:int>  GET, POST      ItemResource      -        
+/api/register         OPTIONS, POST  register_user     api      
+/ws/chat              WEBSOCKET      chat_ws           -        
+----------------------------------------------------------------
+```
+
+### 3. `fenrir shell`
+Instantly spawn an interactive python shell pre-configured with all key framework classes and context loaded (`app`, `request`, `g`, `Response`, `Blueprint`, etc.).
+```bash
+fenrir shell demo_app:app
+```
+
+### 4. `fenrir bench`
+Perform in-memory framework benchmarking directly over ASGI using `HTTPX`. Eliminates network noise and tests raw pipeline speed under loaded constraints.
+```bash
+fenrir bench demo_app:app -i 1000 -t 5 -p / -m GET
+```
+
+### 5. `fenrir new`
+Scaffold a complete, cleanly structured template of a new Fenrir project directory in seconds.
+```bash
+fenrir new my_new_project
+```
+
+### 6. `fenrir info`
+Inspect the environment including Python details, OS details, Pydantic/Asteri versions, active compatibility layers, and route statistics.
+```bash
+fenrir info demo_app:app
+```
+
+---
+
+## 🧪 Comprehensive Test Suite
+
+Fenrir is thoroughly covered by an automated test suite comprising **478 tests** validating every single component, compat namespace, file upload, routing detail, and CLI functionality.
+
+Run the test suite using `pytest`:
+
+```bash
+pytest -v
+```
+
+### Output:
+```text
+======================== 477 passed, 1 skipped in 3.48s ========================
+```
+
+---
+
+## 🛠️ Package Distribution (PyPI Publish Ready)
+
+Fenrir is packed and ready for distribution.
+1. Build the distribution binaries:
+   ```bash
+   python -m build
+   ```
+2. Upload to PyPI using twine:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+---
+
+## 📜 License
+
+Fenrir is open-sourced software licensed under the [MIT License](LICENSE).

fenrir_framework-0.1.0/README.md

@@ -0,0 +1,203 @@
+<p align="center">
+  <img src="logo.jpg" alt="Fenrir Logo" width="300px"/>
+</p>
+
+# Fenrir Web Framework
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)
+[![Tests](https://img.shields.io/badge/Tests-478%20Passed-brightgreen.svg)]()
+[![Performance](https://img.shields.io/badge/Performance-High--Speed%20ASGI-orange.svg)]()
+
+**Fenrir** is a state-of-the-art, high-performance, hybrid Python web framework built on top of modern ASGI specifications. It elegantly merges the best programming paradigms from Python's most popular web frameworks (**Flask**, **FastAPI**, **Sanic**, **Falcon**, and **Bottle**) into a single unified workspace, powered locally by the premium **Asteri v2.2.2** application server.
+
+Whether you prefer the automatic Pydantic validation of FastAPI, the seamless context-locals of Flask, the raw class-based speed of Falcon, or the robust background task model of Sanic, **Fenrir** allows you to leverage them all simultaneously in the same codebase.
+
+---
+
+## 🌟 Key Features
+
+*   **⚡ High-Speed ASGI Core**: Extremely low-overhead routing and handler pipeline, achieving massive request throughput.
+*   **🧩 Framework Hybridization**:
+    *   **FastAPI Paradigm**: Native Pydantic v2 data validation, `Annotated` type decorators, automated parameter resolution (`Query`, `Path`, `Header`, `Cookie`, `Body`), dynamic dependency injection (`Depends`), and automated `response_model` serialization.
+    *   **Flask Paradigm**: Thread/Task-safe context locals (`request`, `g`, `session`), Jinja2 template rendering (`render_template`), and request teardown hooks.
+    *   **Falcon Paradigm**: Class-based resource controllers (`on_get`, `on_post`), before/after hooks, and in-place response mutation.
+    *   **Sanic Paradigm**: Global `sys.modules` patching (`install_sanic_compat()`), standard response helpers (`json`, `text`, `html`, `raw`, `redirect`), lifecycle listeners (`before_server_start`, etc.), and a background event scheduler (`app.add_task`).
+    *   **Bottle Paradigm**: Built-in WSGI-to-ASGI wrapper and legacy mount adapter (`app.mount_wsgi()`) to run old WSGI applications at ASGI speeds.
+*   **📖 Auto-Generated OpenAPI Docs**: Interactive **Swagger UI** (`/docs`) and **ReDoc** (`/redoc`) instantly generated from your Pydantic schemas and route metadata.
+*   **🔌 Modern Communications**: Out-of-the-box support for **WebSockets** and **Server-Sent Events (SSE)**.
+*   **🛠️ Premium CLI Tooling**: Visual route tables, interactive app shell, in-memory benchmarking suite, project scaffolding, and environment system inspection.
+
+---
+
+## 📦 Installation
+
+To install Fenrir in development mode, clone the repository and run:
+
+```bash
+pip install -e .
+```
+
+To install all optimal development and testing dependencies:
+
+```bash
+pip install pytest httpx watchdog pydantic jinja2 asteri>=2.2.2
+```
+
+---
+
+## 🚀 Quick Start (The Hybrid Power)
+
+Here is a simple example (`demo_app.py`) showcasing how Flask, FastAPI, Falcon, and Sanic styles coexist harmoniously in a single application:
+
+```python
+import logging
+from pydantic import BaseModel
+from fenrir import (
+    Fenrir, Blueprint, request, g, Depends, Query, Header,
+    render_template, Response, Form, File, UploadFile,
+    WebSocket, WebSocketDisconnect
+)
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("demo")
+
+# Initialize the Hybrid App
+app = Fenrir(title="Fenrir Hybrid Demo", version="1.0.0")
+
+# --- 1. FastAPI-Style Validation & DI ---
+class UserRegister(BaseModel):
+    username: str
+    email: str
+    age: int
+
+async def verify_api_key(x_api_key: str = Header(default=None)):
+    if x_api_key != "super-secret-key":
+        logger.warning("Invalid API key attempt")
+    return x_api_key
+
+# --- 2. Flask-Style Routing & Context-Locals ---
+@app.get("/")
+async def home():
+    name = request.args.get("name", "Fenrir Developer")
+    return render_template("index.html", name=name)
+
+# --- 3. Falcon-Style Class-Based Resources ---
+class ItemResource:
+    async def on_get(self, req, resp, item_id: int):
+        resp.status = 200
+        resp.media = {"item_id": item_id, "style": "Falcon Resource"}
+
+app.add_route("/items/<item_id:int>", ItemResource())
+
+# --- 4. Sanic-Style Listeners & Background Tasks ---
+@app.listener("before_server_start")
+async def setup_db(app_instance):
+    logger.info("Initializing mock database...")
+
+@app.middleware("request")
+async def log_request(req):
+    logger.info(f"Incoming: {req.method} {req.path}")
+    g.user_role = "guest"  # Share state using Flask-style 'g'
+
+# Run with Asteri ASGI server
+if __name__ == "__main__":
+    app.run(host="127.0.0.1", port=8000, workers=2)
+```
+
+---
+
+## 💻 CLI Command Reference
+
+Fenrir comes packed with a high-fidelity, visually rich command-line tool. Start the CLI by executing `fenrir` or `python -m fenrir.cli`.
+
+### 1. `fenrir run`
+Serve your application locally. Powered by **Asteri v2.2.2**, supporting dynamic multiprocessing, worker management, and live hot-reloading.
+```bash
+fenrir run demo_app:app --port 8000 --dev
+```
+*   **Flags**:
+    *   `-H`, `--host`: Host bind address (default: `127.0.0.1`).
+    *   `-p`, `--port`: Port number (default: `8000`).
+    *   `-w`, `--workers`: Number of concurrent workers (default: `1`).
+    *   `-d`, `--dev` / `--reload`: Active development mode with auto-reload.
+
+### 2. `fenrir routes`
+Print a beautiful, colorized structural table of all registered HTTP endpoints, methods, matching handlers, and associated blueprints.
+```bash
+fenrir routes demo_app:app
+```
+**Output Example:**
+```text
+----------------------------------------------------------------
+Path                  Methods        Handler           Blueprint
+----------------------------------------------------------------
+/openapi.json         GET, OPTIONS   openapi_endpoint  -        
+/docs                 GET, OPTIONS   swagger_ui        -        
+/                     GET, OPTIONS   home              -        
+/items/<item_id:int>  GET, POST      ItemResource      -        
+/api/register         OPTIONS, POST  register_user     api      
+/ws/chat              WEBSOCKET      chat_ws           -        
+----------------------------------------------------------------
+```
+
+### 3. `fenrir shell`
+Instantly spawn an interactive python shell pre-configured with all key framework classes and context loaded (`app`, `request`, `g`, `Response`, `Blueprint`, etc.).
+```bash
+fenrir shell demo_app:app
+```
+
+### 4. `fenrir bench`
+Perform in-memory framework benchmarking directly over ASGI using `HTTPX`. Eliminates network noise and tests raw pipeline speed under loaded constraints.
+```bash
+fenrir bench demo_app:app -i 1000 -t 5 -p / -m GET
+```
+
+### 5. `fenrir new`
+Scaffold a complete, cleanly structured template of a new Fenrir project directory in seconds.
+```bash
+fenrir new my_new_project
+```
+
+### 6. `fenrir info`
+Inspect the environment including Python details, OS details, Pydantic/Asteri versions, active compatibility layers, and route statistics.
+```bash
+fenrir info demo_app:app
+```
+
+---
+
+## 🧪 Comprehensive Test Suite
+
+Fenrir is thoroughly covered by an automated test suite comprising **478 tests** validating every single component, compat namespace, file upload, routing detail, and CLI functionality.
+
+Run the test suite using `pytest`:
+
+```bash
+pytest -v
+```
+
+### Output:
+```text
+======================== 477 passed, 1 skipped in 3.48s ========================
+```
+
+---
+
+## 🛠️ Package Distribution (PyPI Publish Ready)
+
+Fenrir is packed and ready for distribution.
+1. Build the distribution binaries:
+   ```bash
+   python -m build
+   ```
+2. Upload to PyPI using twine:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+---
+
+## 📜 License
+
+Fenrir is open-sourced software licensed under the [MIT License](LICENSE).

fenrir_framework-0.1.0/fenrir/__init__.py

@@ -0,0 +1,148 @@
+from fenrir.app import Fenrir, Blueprint
+from fenrir.context import request, g, current_app, session
+from fenrir.dependencies import Depends, Query, Header, Cookie, Body, Path, Form, File
+from fenrir.upload import UploadFile
+from fenrir.websocket import WebSocket, WebSocketDisconnect
+from fenrir.exceptions import (
+    HTTPException,
+    HTTPBadRequest,
+    HTTPUnauthorized,
+    HTTPForbidden,
+    HTTPNotFound,
+    HTTPMethodNotAllowed,
+    HTTPConflict,
+    HTTPUnprocessableEntity,
+    HTTPInternalServerError,
+)
+from fenrir.response import (
+    Response,
+    JSONResponse,
+    HTMLResponse,
+    TextResponse,
+    RedirectResponse,
+    StreamingResponse,
+    FileResponse,
+    PlainTextResponse,
+)
+from fenrir.templating import render_template, BaseTemplateRenderer, Jinja2Renderer
+from fenrir.views import View, MethodView
+from fenrir.helpers import url_for, send_file, send_from_directory, redirect
+from fenrir.routing import Router, Route, APIRouter
+from fenrir.sse import EventSourceResponse
+from fenrir.security import (
+    APIKeyCookie,
+    APIKeyHeader,
+    APIKeyQuery,
+    HTTPBasic,
+    HTTPBearer,
+    HTTPDigest,
+    OAuth2PasswordBearer,
+    OAuth2AuthorizationCodeBearer,
+    OpenIDConnect,
+)
+from fenrir.background import BackgroundTasks, BackgroundTask
+from fenrir.compat import WsgiToAsgi, install_bottle_compat, install_falcon_compat, install_sanic_compat
+from fenrir.bottle import Bottle
+import fenrir.bottle as bottle
+import fenrir.falcon as falcon
+import fenrir.sanic as sanic
+from fenrir.testing import TestClient, FenrirTestClient
+
+
+
+
+# Re-export Annotated for convenient use with param markers
+from typing import Annotated
+
+__version__ = "0.1.0"
+__all__ = [
+    # Core app
+    "Fenrir",
+    "Blueprint",
+    # Context
+    "request",
+    "g",
+    "current_app",
+    "session",
+    # Dependency injection
+    "Depends",
+    "Query",
+    "Header",
+    "Cookie",
+    "Body",
+    "Path",
+    "Form",
+    "File",
+    "Annotated",
+    # File upload
+    "UploadFile",
+    # WebSocket
+    "WebSocket",
+    "WebSocketDisconnect",
+    # Exceptions
+    "HTTPException",
+    "HTTPBadRequest",
+    "HTTPUnauthorized",
+    "HTTPForbidden",
+    "HTTPNotFound",
+    "HTTPMethodNotAllowed",
+    "HTTPConflict",
+    "HTTPUnprocessableEntity",
+    "HTTPInternalServerError",
+    # Responses
+    "Response",
+    "JSONResponse",
+    "HTMLResponse",
+    "TextResponse",
+    "RedirectResponse",
+    "StreamingResponse",
+    "FileResponse",
+    "PlainTextResponse",
+    # Templating
+    "render_template",
+    "BaseTemplateRenderer",
+    "Jinja2Renderer",
+    # Views
+    "View",
+    "MethodView",
+    # Helpers
+    "url_for",
+    "send_file",
+    "send_from_directory",
+    "redirect",
+    # Routing
+    "Router",
+    "Route",
+    "APIRouter",
+    # SSE
+    "EventSourceResponse",
+    # Security
+    "APIKeyCookie",
+    "APIKeyHeader",
+    "APIKeyQuery",
+    "HTTPBasic",
+    "HTTPBearer",
+    "HTTPDigest",
+    "OAuth2PasswordBearer",
+    "OAuth2AuthorizationCodeBearer",
+    "OpenIDConnect",
+    # Background tasks
+    "BackgroundTasks",
+    "BackgroundTask",
+    # WSGI/Falcon/Sanic compat
+    "WsgiToAsgi",
+    "install_bottle_compat",
+    "install_falcon_compat",
+    "install_sanic_compat",
+    # Bottle built-in
+    "Bottle",
+    "bottle",
+    # Falcon built-in
+    "falcon",
+    # Sanic built-in
+    "sanic",
+    # Testing
+    "TestClient",
+    "FenrirTestClient",
+]
+