fastapiabclib 4.2.0__tar.gz

fastapiabclib-4.2.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.3
+Name: fastapiabclib
+Version: 4.2.0
+Summary: Exception handling and utilities for FastAPI applications
+License: MIT
+Author: Aleksandr Yurlov
+Author-email: sasha.yur@mail.ru
+Requires-Python: >=3.10,<4.0
+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
+Requires-Dist: fastabc (>=4.3.0,<5.0.0)

fastapiabclib-4.2.0/fastapilib/__init__.py

@@ -0,0 +1,30 @@
+from fastabc import Api, App
+
+from .constants import HTTP_CODE_ERROR_DEFAULT, HTTP_CODE_START
+from .exceptions import (
+    BadRequestHTTPError,
+    BaseHTTPError,
+    ForbiddenHTTPError,
+    InternalHTTPError,
+    NotAllowHTTPError,
+    NotFoundHTTPError,
+    UnauthorizedHTTPError,
+)
+from .output import abort, json
+
+__version__ = "4.3.0"
+__all__ = [
+    "Api",
+    "App",
+    "abort",
+    "json",
+    "BadRequestHTTPError",
+    "BaseHTTPError",
+    "ForbiddenHTTPError",
+    "InternalHTTPError",
+    "NotAllowHTTPError",
+    "NotFoundHTTPError",
+    "UnauthorizedHTTPError",
+    "HTTP_CODE_START",
+    "HTTP_CODE_ERROR_DEFAULT",
+]

fastapiabclib-4.2.0/fastapilib/constants.py

@@ -0,0 +1,2 @@
+HTTP_CODE_START = 100
+HTTP_CODE_ERROR_DEFAULT = 500

fastapiabclib-4.2.0/fastapilib/exceptions.py

@@ -0,0 +1,44 @@
+from fastapi import HTTPException
+
+from .constants import HTTP_CODE_ERROR_DEFAULT, HTTP_CODE_START
+
+__all__ = ["HTTPException"]
+
+
+class BaseHTTPError(Exception):
+    def __init__(self, message: str, code: int) -> None:
+        self.code = code if code > HTTP_CODE_START else HTTP_CODE_ERROR_DEFAULT
+        self.message = message
+
+    def __str__(self):
+        return f"{self.message} ({self.code})"
+
+
+class BadRequestHTTPError(BaseHTTPError):
+    def __init__(self, message: str = "Bad Request") -> None:
+        super().__init__(message, 400)
+
+
+class UnauthorizedHTTPError(BaseHTTPError):
+    def __init__(self, message: str = "Authorization Required") -> None:
+        super().__init__(message, 401)
+
+
+class ForbiddenHTTPError(BaseHTTPError):
+    def __init__(self, message: str = "Forbidden") -> None:
+        super().__init__(message, 403)
+
+
+class NotFoundHTTPError(BaseHTTPError):
+    def __init__(self, message: str = "Not Found") -> None:
+        super().__init__(message, 404)
+
+
+class NotAllowHTTPError(BaseHTTPError):
+    def __init__(self, message: str = "Method Not Allowed") -> None:
+        super().__init__(message, 405)
+
+
+class InternalHTTPError(BaseHTTPError):
+    def __init__(self, message: str = "Internal Server Error") -> None:
+        super().__init__(message, 500)

fastapiabclib-4.2.0/fastapilib/output.py

@@ -0,0 +1,42 @@
+from typing import Any
+
+from fastapi import HTTPException
+from fastapi.responses import JSONResponse
+
+from .exceptions import BadRequestHTTPError, BaseHTTPError, InternalHTTPError
+from .structures import JSONError
+
+
+def json(content: Any, status_code: int = 200) -> JSONResponse:
+    """
+    Создаёт JSONResponse (аналог sanic.response.json для совместимости).
+
+    Args:
+        content: Данные для JSON-ответа
+        status_code: HTTP статус-код (по умолчанию 200)
+
+    Returns:
+        JSONResponse с указанными данными и статус-кодом
+
+    Example:
+        >>> return json({"message": "Success"}, 201)
+        >>> return json([item.to_dict() for item in items])
+    """
+    return JSONResponse(content=content, status_code=status_code)
+
+
+def abort(exception: Exception | BaseException, description: str | None = None) -> JSONResponse:
+    if isinstance(exception, BaseHTTPError):
+        pass
+    elif isinstance(exception, (ValueError, KeyError, TypeError)):
+        description = description if description is not None else str(exception)
+        exception = BadRequestHTTPError()
+    elif isinstance(exception, HTTPException):
+        exception = BaseHTTPError(str(exception.detail), exception.status_code)
+    else:
+        exception = InternalHTTPError()
+
+    return JSONResponse(
+        content=JSONError.create(exception, description).to_dict(),
+        status_code=exception.code
+    )

fastapiabclib-4.2.0/fastapilib/structures.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class JSONError:
+    message: str
+    description: str
+    error: Exception
+
+    @classmethod
+    def create(cls, exception: Exception, description: str | None = None) -> JSONError:
+        return cls(
+            message=getattr(exception, "message", str(exception)),
+            description=description if isinstance(description, str) else "",
+            error=exception,
+        )
+
+    def to_dict(self):
+        return {
+            "message": self.message,
+            "description": self.description,
+            "error": f"{type(self.error)} - {self.error}",
+        }

fastapiabclib-4.2.0/pyproject.toml

@@ -0,0 +1,20 @@
+[tool.poetry]
+name = "fastapiabclib"
+version = "4.2.0"
+description = "Exception handling and utilities for FastAPI applications"
+authors = ["Aleksandr Yurlov <sasha.yur@mail.ru>"]
+license = "MIT"
+packages = [
+    { include = "fastapilib" }
+]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+fastabc = "^4.3.0"
+
+[tool.poetry.group.dev.dependencies]
+build = "^1.2.2.post1"
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"