devpablocristo-httpserver 0.2.0__tar.gz

devpablocristo_httpserver-0.2.0/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: devpablocristo-httpserver
+Version: 0.2.0
+Summary: FastAPI/Starlette helpers agnostic to product domain (alineado con los módulos técnicos HTTP de core)
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: starlette<1,>=0.41
+Provides-Extra: dev
+Requires-Dist: httpx<1,>=0.27; extra == "dev"
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: structlog>=24.0; extra == "dev"
+
+# devpablocristo-httpserver
+
+Primitivas HTTP reutilizables para FastAPI y Starlette publicadas como paquete versionado de `core`.

devpablocristo_httpserver-0.2.0/README.md

@@ -0,0 +1,3 @@
+# devpablocristo-httpserver
+
+Primitivas HTTP reutilizables para FastAPI y Starlette publicadas como paquete versionado de `core`.

devpablocristo_httpserver-0.2.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devpablocristo-httpserver"
+version = "0.2.0"
+description = "FastAPI/Starlette helpers agnostic to product domain (alineado con los módulos técnicos HTTP de core)"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "fastapi>=0.115,<1",
+    "starlette>=0.41,<1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "httpx>=0.27,<1",
+    "pytest>=8.3.0",
+    "pytest-asyncio>=0.24.0",
+    "ruff>=0.9.0",
+    "structlog>=24.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

devpablocristo_httpserver-0.2.0/setup.cfg

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

devpablocristo_httpserver-0.2.0/src/devpablocristo_httpserver.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: devpablocristo-httpserver
+Version: 0.2.0
+Summary: FastAPI/Starlette helpers agnostic to product domain (alineado con los módulos técnicos HTTP de core)
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: starlette<1,>=0.41
+Provides-Extra: dev
+Requires-Dist: httpx<1,>=0.27; extra == "dev"
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: structlog>=24.0; extra == "dev"
+
+# devpablocristo-httpserver
+
+Primitivas HTTP reutilizables para FastAPI y Starlette publicadas como paquete versionado de `core`.

devpablocristo_httpserver-0.2.0/src/devpablocristo_httpserver.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/devpablocristo_httpserver.egg-info/PKG-INFO
+src/devpablocristo_httpserver.egg-info/SOURCES.txt
+src/devpablocristo_httpserver.egg-info/dependency_links.txt
+src/devpablocristo_httpserver.egg-info/requires.txt
+src/devpablocristo_httpserver.egg-info/top_level.txt
+src/httpserver/__init__.py
+src/httpserver/errors.py
+src/httpserver/fastapi_bootstrap.py
+tests/test_fastapi_bootstrap.py

devpablocristo_httpserver-0.2.0/src/devpablocristo_httpserver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

devpablocristo_httpserver-0.2.0/src/devpablocristo_httpserver.egg-info/requires.txt

@@ -0,0 +1,9 @@
+fastapi<1,>=0.115
+starlette<1,>=0.41
+
+[dev]
+httpx<1,>=0.27
+pytest>=8.3.0
+pytest-asyncio>=0.24.0
+ruff>=0.9.0
+structlog>=24.0

devpablocristo_httpserver-0.2.0/src/devpablocristo_httpserver.egg-info/top_level.txt

@@ -0,0 +1 @@
+httpserver

devpablocristo_httpserver-0.2.0/src/httpserver/__init__.py

@@ -0,0 +1,16 @@
+"""HTTP server helpers for Python services (FastAPI/Starlette), sin dominio de IA."""
+
+from httpserver.errors import AppError, error_payload
+from httpserver.fastapi_bootstrap import (
+    apply_permissive_cors,
+    install_request_context_middleware,
+    register_common_exception_handlers,
+)
+
+__all__ = [
+    "AppError",
+    "apply_permissive_cors",
+    "error_payload",
+    "install_request_context_middleware",
+    "register_common_exception_handlers",
+]

devpablocristo_httpserver-0.2.0/src/httpserver/errors.py

@@ -0,0 +1,28 @@
+"""Tipos de error y payloads JSON para APIs HTTP (agnóstico de dominio)."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass(slots=True)
+class AppError(Exception):
+    code: str
+    message: str
+    status_code: int = 400
+    details: dict[str, Any] = field(default_factory=dict)
+
+    def __str__(self) -> str:
+        return self.message
+
+
+def error_payload(code: str, message: str, request_id: str, details: dict[str, Any] | None = None) -> dict[str, Any]:
+    return {
+        "error": {
+            "code": code,
+            "message": message,
+            "details": details or {},
+            "request_id": request_id,
+        }
+    }

devpablocristo_httpserver-0.2.0/src/httpserver/fastapi_bootstrap.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from typing import Any, Callable
+from uuid import uuid4
+
+from fastapi import FastAPI, HTTPException, Request
+from fastapi.exceptions import RequestValidationError
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+
+from httpserver.errors import AppError, error_payload
+
+
+def apply_permissive_cors(app: FastAPI, allowed_origins: list[str] | None = None) -> None:
+    """Aplica CORS. Si allowed_origins es None, permite todo sin credentials."""
+
+    if allowed_origins:
+        app.add_middleware(
+            CORSMiddleware,
+            allow_origins=allowed_origins,
+            allow_credentials=True,
+            allow_methods=["*"],
+            allow_headers=["*"],
+        )
+    else:
+        app.add_middleware(
+            CORSMiddleware,
+            allow_origins=["*"],
+            allow_credentials=False,
+            allow_methods=["*"],
+            allow_headers=["*"],
+        )
+
+
+def install_request_context_middleware(
+    app: FastAPI,
+    bind_request_context: Callable[[str], None],
+    clear_request_context: Callable[[], None],
+) -> None:
+    @app.middleware("http")
+    async def request_context_middleware(request: Request, call_next):  # type: ignore[no-untyped-def]
+        request_id = request.headers.get("X-Request-ID", f"req_{uuid4().hex[:12]}")
+        request.state.request_id = request_id
+        bind_request_context(request_id)
+        try:
+            response = await call_next(request)
+        finally:
+            clear_request_context()
+        response.headers["X-Request-ID"] = request_id
+        return response
+
+
+def register_common_exception_handlers(app: FastAPI, logger: Any) -> None:
+    @app.exception_handler(AppError)
+    async def handle_app_error(request: Request, exc: AppError) -> JSONResponse:
+        request_id = getattr(request.state, "request_id", "")
+        return JSONResponse(
+            status_code=exc.status_code,
+            content=error_payload(exc.code, exc.message, request_id, exc.details),
+        )
+
+    @app.exception_handler(HTTPException)
+    async def handle_http_error(request: Request, exc: HTTPException) -> JSONResponse:
+        request_id = getattr(request.state, "request_id", "")
+        return JSONResponse(
+            status_code=exc.status_code,
+            content=error_payload("http_error", str(exc.detail), request_id),
+        )
+
+    @app.exception_handler(RequestValidationError)
+    async def handle_validation_error(request: Request, exc: RequestValidationError) -> JSONResponse:
+        request_id = getattr(request.state, "request_id", "")
+        return JSONResponse(
+            status_code=422,
+            content=error_payload("validation_error", "request validation failed", request_id, {"errors": exc.errors()}),
+        )
+
+    @app.exception_handler(Exception)
+    async def handle_unexpected_error(request: Request, exc: Exception) -> JSONResponse:
+        request_id = getattr(request.state, "request_id", "")
+        logger.exception("unhandled_exception", error=str(exc), path=request.url.path)
+        return JSONResponse(
+            status_code=500,
+            content=error_payload("internal_error", "internal server error", request_id),
+        )

devpablocristo_httpserver-0.2.0/tests/test_fastapi_bootstrap.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import unittest
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from httpserver.fastapi_bootstrap import (
+    apply_permissive_cors,
+    install_request_context_middleware,
+    register_common_exception_handlers,
+)
+import structlog
+
+
+class FastAPIBootstrapTests(unittest.TestCase):
+    def test_bootstrap_helpers(self) -> None:
+        structlog.configure(wrapper_class=structlog.make_filtering_bound_logger(40))
+        log = structlog.get_logger("httpserver_test")
+
+        app = FastAPI()
+        apply_permissive_cors(app)
+        install_request_context_middleware(
+            app,
+            lambda _rid: None,
+            lambda: None,
+        )
+        register_common_exception_handlers(app, log)
+
+        @app.get("/healthz")
+        async def healthz() -> dict[str, str]:
+            return {"status": "ok"}
+
+        client = TestClient(app)
+        response = client.get("/healthz")
+        self.assertEqual(response.status_code, 200)
+        self.assertIn("X-Request-ID", response.headers)
+
+
+if __name__ == "__main__":
+    unittest.main()