fastapi-factory-utilities 0.7.2__tar.gz

fastapi_factory_utilities-0.7.2/LICENSE

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

fastapi_factory_utilities-0.7.2/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: fastapi_factory_utilities
+Version: 0.7.2
+Summary: Consolidate libraries and utilities to create microservices in Python with FastAPI, Beanie, Taskiq, AioPika and OpenTelemetry.
+License: MIT
+License-File: LICENSE
+Keywords: python,fastapi,beanie,taskiq,opentelemetry,microservices
+Author: miragecentury
+Author-email: victorien.vanroye@gmail.com
+Maintainer: miragecentury
+Maintainer-email: victorien.vanroye@gmail.com
+Requires-Python: >=3.12,<3.13
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: aio-pika (>=9.5.7,<10.0.0)
+Requires-Dist: aiohttp[speedups] (>=3.12.13,<4.0.0)
+Requires-Dist: beanie (>=1.30.0,<2.0.0)
+Requires-Dist: fastapi (>=0.115.13,<1)
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (>=1.26.0,<2.0.0)
+Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.26.0,<2.0.0)
+Requires-Dist: opentelemetry-instrumentation-aio-pika (>=0.59b0,<0.60)
+Requires-Dist: opentelemetry-instrumentation-aiohttp-client (>=0,<1)
+Requires-Dist: opentelemetry-instrumentation-fastapi (>=0,<1)
+Requires-Dist: opentelemetry-instrumentation-pymongo (>=0,<1)
+Requires-Dist: opentelemetry-propagator-b3 (>=1.26.0,<2.0.0)
+Requires-Dist: opentelemetry-sdk (>=1.26.0,<2.0.0)
+Requires-Dist: pyaml (>=25.1.0,<26.0.0)
+Requires-Dist: pydantic (>=2.8.2,<3.0.0)
+Requires-Dist: pyjwt (>=2.10.1,<3.0.0)
+Requires-Dist: pymongo (>=4.9.2,<4.16.0)
+Requires-Dist: reactivex (>=4.0.4,<5.0.0)
+Requires-Dist: structlog (>=24.1,<26.0)
+Requires-Dist: taskiq-dependencies (>=1.5.8,<2.0.0)
+Requires-Dist: taskiq-fastapi (>=0.3.5,<0.4.0)
+Requires-Dist: taskiq-redis (>=1.0.9,<2.0.0)
+Requires-Dist: typer (>=0,<1)
+Requires-Dist: uvicorn (>=0.34.3,<1)
+Project-URL: Homepage, https://github.com/DeerHide/fastapi_factory_utilities
+Project-URL: Repository, https://github.com/DeerHide/fastapi_factory_utilities
+Description-Content-Type: text/markdown
+
+# fastapi_factory_utilities
+
+Project Empty for Python with Poetry
+
+## Setup
+
+### Dev Tools
+
+#### Python
+
+<https://www.python.org/downloads/>
+
+```bash
+sudo apt install software-properties-common -y
+sudo add-apt-repository ppa:deadsnakes/ppa
+sudo apt update
+sudo apt install python3.12 -y
+```
+
+#### Poetry
+
+<https://python-poetry.org/>
+
+```bash
+curl -sSL https://install.python-poetry.org | python3.12 -
+```
+
+#### Pre-commit
+
+Included in the project while in virtual environment
+<https://pre-commit.com/>
+
+#### Docker
+
+<https://docs.docker.com/get-docker/>
+
+#### Skaffold
+
+<https://skaffold.dev>
+
+```bash
+curl -Lo skaffold https://storage.googleapis.com/skaffold/releases/latest/skaffold-linux-amd64
+chmod +x skaffold
+sudo mv skaffold /usr/local/bin
+```
+
+#### Buildpacks
+
+<https://buildpacks.io/>
+
+```bash
+sudo add-apt-repository ppa:cncf-buildpacks/pack-cli
+sudo apt-get update
+sudo apt-get install pack-cli
+```
+
+#### Paketo
+
+Included with the usage of buildpacks
+<https://paketo.io/>
+
+#### Portman
+
+```bash
+npm install -g @apideck/portman
+```
+
+### MongoDB
+
+<https://docs.mongodb.com/manual/installation/>
+
+```bash
+sudo apt install -y mongodb
+```
+
+### 1- Dev Environment
+
+```bash
+# Initialize python virtual environment and install dependencies
+./scripts/setup_dev_env.sh
+
+pre-commit run --all-files
+```
+
+### 2- Build and Run Application on Docker
+
+```bash
+./scripts/dev-in-container.sh
+```
+
+```bash
+./scripts/test_portman.sh
+```
+

fastapi_factory_utilities-0.7.2/README.md

@@ -0,0 +1,93 @@
+# fastapi_factory_utilities
+
+Project Empty for Python with Poetry
+
+## Setup
+
+### Dev Tools
+
+#### Python
+
+<https://www.python.org/downloads/>
+
+```bash
+sudo apt install software-properties-common -y
+sudo add-apt-repository ppa:deadsnakes/ppa
+sudo apt update
+sudo apt install python3.12 -y
+```
+
+#### Poetry
+
+<https://python-poetry.org/>
+
+```bash
+curl -sSL https://install.python-poetry.org | python3.12 -
+```
+
+#### Pre-commit
+
+Included in the project while in virtual environment
+<https://pre-commit.com/>
+
+#### Docker
+
+<https://docs.docker.com/get-docker/>
+
+#### Skaffold
+
+<https://skaffold.dev>
+
+```bash
+curl -Lo skaffold https://storage.googleapis.com/skaffold/releases/latest/skaffold-linux-amd64
+chmod +x skaffold
+sudo mv skaffold /usr/local/bin
+```
+
+#### Buildpacks
+
+<https://buildpacks.io/>
+
+```bash
+sudo add-apt-repository ppa:cncf-buildpacks/pack-cli
+sudo apt-get update
+sudo apt-get install pack-cli
+```
+
+#### Paketo
+
+Included with the usage of buildpacks
+<https://paketo.io/>
+
+#### Portman
+
+```bash
+npm install -g @apideck/portman
+```
+
+### MongoDB
+
+<https://docs.mongodb.com/manual/installation/>
+
+```bash
+sudo apt install -y mongodb
+```
+
+### 1- Dev Environment
+
+```bash
+# Initialize python virtual environment and install dependencies
+./scripts/setup_dev_env.sh
+
+pre-commit run --all-files
+```
+
+### 2- Build and Run Application on Docker
+
+```bash
+./scripts/dev-in-container.sh
+```
+
+```bash
+./scripts/test_portman.sh
+```

fastapi_factory_utilities-0.7.2/pyproject.toml

@@ -0,0 +1,154 @@
+[tool.poetry]
+name = "fastapi_factory_utilities"
+homepage = "https://github.com/DeerHide/fastapi_factory_utilities"
+repository = "https://github.com/DeerHide/fastapi_factory_utilities"
+keywords = ["python", "fastapi", "beanie", "taskiq", "opentelemetry", "microservices"]
+version = "0.7.2"
+description = "Consolidate libraries and utilities to create microservices in Python with FastAPI, Beanie, Taskiq, AioPika and OpenTelemetry."
+authors = ["miragecentury <victorien.vanroye@gmail.com>"]
+maintainers = ["miragecentury <victorien.vanroye@gmail.com>"]
+license = "MIT"
+readme = "README.md"
+packages = [
+    { include = "fastapi_factory_utilities", from = "src" },
+    { include = "fastapi_factory_utilities/py.typed", from = "src" },
+]
+classifiers = [
+    "Programming Language :: Python :: 3.12",
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+
+[[tool.poetry.source]]
+name = "velmios"
+url = "https://pypi.velmios.io/simple"
+priority = "explicit"
+
+[tool.poetry.dependencies]
+python = "~3.12"
+structlog = ">=24.1,<26.0"
+typer = "^0"
+pydantic = "^2.8.2"
+fastapi = ">=0.115.13,<1"
+uvicorn = ">=0.34.3,<1"
+opentelemetry-sdk = "^1.26.0"
+opentelemetry-exporter-otlp-proto-http = "^1.26.0"
+opentelemetry-exporter-otlp-proto-grpc = "^1.26.0"
+opentelemetry-instrumentation-fastapi = "^0"
+opentelemetry-propagator-b3 = "^1.26.0"
+beanie = "^1.30.0"
+opentelemetry-instrumentation-pymongo = "^0"
+pymongo = ">=4.9.2,<4.16.0"
+pyaml = "^25.1.0"
+reactivex = "^4.0.4"
+pyjwt = "^2.10.1"
+aiohttp = { version="^3.12.13", extras=["speedups"] }
+opentelemetry-instrumentation-aiohttp-client = "^0"
+aio-pika = "^9.5.7"
+opentelemetry-instrumentation-aio-pika = "^0.59b0"
+taskiq-dependencies = { version="^1.5.8", source="velmios"}
+taskiq-fastapi = "^0.3.5"
+taskiq-redis = "^1.0.9"
+
+[tool.poetry.group.test]
+optional = true
+
+[tool.poetry.group.test.dependencies]
+mypy = "^1.10.0"
+types-requests = "^2.32.0.20240712"
+types-pyyaml = "^6.0.12.20240311"
+pylint = {version=">=3.2.2,<5.0.0", extras=["spelling"]}
+black = "^25.9.0"
+pre-commit = "^4.0.1"
+pyupgrade = "^3.15.2"
+pytest = "^8.2.0"
+pytest-xdist = "^3.6.1"
+pytest-cov = "^7.0.0"
+ruff = "^0.14"
+pytest-asyncio = ">=0.25,<1.3"
+pytest-mongo = "^3.1.0"
+locust = "^2.32.4"
+testcontainers = { version="^4.9.0", extras=["mongodb","rabbitmq", "redis"] }
+types-deprecated = "^1.2.15.20241117"
+types-pygments = "^2.18.0.20240506"
+types-colorama = "^0.4.15.20240311"
+types-protobuf = ">=5.29.1.20241207,<7.0.0.0"
+types-psutil = ">=6.1.0.20241221,<8.0.0.0"
+types-pyopenssl = "^24.1.0.20240722"
+types-ujson = "^5.10.0.20240515"
+httpx = "^0.28.1"
+
+[tool.poetry.extras]
+
+[tool.poetry.scripts]
+fastapi_factory_utilities-example = "fastapi_factory_utilities.example.__main__:main"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+testpaths = "tests"
+addopts = "--import-mode=importlib -n auto --color=yes"
+filterwarnings = [
+    "ignore:.*datetime.datetime.utcfromtimestamp().*:DeprecationWarning", # reactivex
+    "ignore:.*datetime.datetime.utcnow().*:DeprecationWarning", # reactivex
+    "ignore::pydantic.warnings.PydanticDeprecatedSince211",
+    "ignore:The @wait_container_is_ready decorator is deprecated.*:DeprecationWarning", # testcontainers
+    "ignore:The wait_for_logs function with string or callable predicates is deprecated.*:DeprecationWarning", # testcontainers
+]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+mongo_params = ""
+
+[tool.black]
+line-length = 120
+target-version = ['py312']
+
+[tool.isort]
+profile = "black"
+
+[tool.mypy]
+python_version = "3.12"
+warn_unused_configs = true
+packages = "fastapi_factory_utilities"
+mypy_path  = "src:tests"
+namespace_packages = true
+plugins = ["pydantic.mypy"]
+follow_imports = "silent"
+follow_untyped_imports = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+disallow_any_generics = true
+check_untyped_defs = true
+no_implicit_reexport = true
+
+# for strict mypy: (this is the tricky one :-))
+disallow_untyped_defs = true
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+
+[tool.ruff]
+# Same as Black.
+line-length = 120
+indent-width = 4
+
+[tool.ruff.lint]
+select = ["D","F","E","W","I","UP","PL","N","RUF"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true
+docstring-code-line-length = 120
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/__main__.py

@@ -0,0 +1,6 @@
+"""Re-Use the main function from the example module."""
+
+from fastapi_factory_utilities.example import main
+
+if __name__ == "__main__":
+    main()

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/__init__.py

@@ -0,0 +1 @@
+"""Python Factory Core Module."""

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/api/__init__.py

@@ -0,0 +1,25 @@
+"""Define the API for the Python Factory."""
+
+from fastapi import APIRouter
+
+from .tags import TagEnum
+from .v1.sys import api_v1_sys
+
+api: APIRouter = APIRouter(prefix="/api")
+
+### API v1 ###
+# Prefix the API with /api/v1
+api_v1: APIRouter = APIRouter(prefix="/v1")
+api_v1.include_router(router=api_v1_sys)
+
+
+### API v2 ###
+# Prefix the API with /api/v2
+api_v2: APIRouter = APIRouter(prefix="/v2")
+
+
+### Include the API routers ###
+api.include_router(router=api_v1)
+api.include_router(router=api_v2)
+
+__all__: list[str] = ["TagEnum", "api"]

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/api/tags.py

@@ -0,0 +1,9 @@
+"""Provides the Tag as Enum."""
+
+from enum import StrEnum, auto
+
+
+class TagEnum(StrEnum):
+    """Define Tag for OpenAPI Description."""
+
+    SYS = auto()

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/api/v1/sys/__init__.py

@@ -0,0 +1,12 @@
+"""Package for system related API endpoints."""
+
+from fastapi import APIRouter
+
+from .health import api_v1_sys_health
+from .readiness import api_v1_sys_readiness
+
+api_v1_sys = APIRouter(prefix="/sys")
+api_v1_sys.include_router(router=api_v1_sys_health)
+api_v1_sys.include_router(router=api_v1_sys_readiness)
+
+__all__: list[str] = ["api_v1_sys"]

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/api/v1/sys/health.py

@@ -0,0 +1,97 @@
+"""API v1 sys health module.
+
+Provide the Get health endpoint
+"""
+
+from http import HTTPStatus
+
+from fastapi import APIRouter, Depends, Response
+from pydantic import BaseModel
+
+from fastapi_factory_utilities.core.services.status.enums import HealthStatusEnum
+from fastapi_factory_utilities.core.services.status.services import (
+    StatusService,
+    depends_status_service,
+)
+from fastapi_factory_utilities.core.services.status.types import ComponentInstanceKey
+
+api_v1_sys_health = APIRouter(prefix="/health")
+
+
+class HealthResponseModel(BaseModel):
+    """Health response schema."""
+
+    status: HealthStatusEnum
+
+
+@api_v1_sys_health.get(
+    path="",
+    tags=["sys"],
+    response_model=HealthResponseModel,
+    responses={
+        HTTPStatus.OK.value: {
+            "model": HealthResponseModel,
+            "description": "Health status.",
+        },
+        HTTPStatus.INTERNAL_SERVER_ERROR.value: {
+            "model": HealthResponseModel,
+            "description": "Internal server error.",
+        },
+    },
+)
+def get_api_v1_sys_health(
+    response: Response, status_service: StatusService = Depends(depends_status_service)
+) -> HealthResponseModel:
+    """Get the health of the system.
+
+    Args:
+        response (Response): The response object.
+        status_service (StatusService): The status service.
+
+    Returns:
+        HealthResponse: The health status.
+    """
+    status: HealthStatusEnum = status_service.get_status()["health"]
+    match status:
+        case HealthStatusEnum.HEALTHY:
+            response.status_code = HTTPStatus.OK.value
+        case HealthStatusEnum.UNHEALTHY:
+            response.status_code = HTTPStatus.INTERNAL_SERVER_ERROR.value
+    return HealthResponseModel(status=status)
+
+
+class ComponentHealthResponseModel(BaseModel):
+    """Component health response schema."""
+
+    components: dict[ComponentInstanceKey, HealthStatusEnum]
+
+
+@api_v1_sys_health.get(
+    path="/components",
+    tags=["sys"],
+    response_model=ComponentHealthResponseModel,
+    responses={
+        HTTPStatus.OK.value: {
+            "model": ComponentHealthResponseModel,
+            "description": "Health status of all components.",
+        },
+    },
+)
+def get_api_v1_sys_components_health(
+    status_service: StatusService = Depends(depends_status_service),
+) -> ComponentHealthResponseModel:
+    """Get the health of all components.
+
+    Args:
+        status_service (StatusService): The status service.
+
+    Returns:
+        list[ComponentHealthResponseModel]: The health status of all components.
+    """
+    components_dict: dict[ComponentInstanceKey, HealthStatusEnum] = {}
+
+    for _, components in status_service.get_components_status_by_type().items():
+        for key, status in components.items():
+            components_dict[key] = status["health"]
+
+    return ComponentHealthResponseModel(components=dict(components_dict))

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/api/v1/sys/readiness.py

@@ -0,0 +1,60 @@
+"""API v1 sys readiness module.
+
+Provide the Get readiness endpoint
+"""
+
+from http import HTTPStatus
+
+from fastapi import APIRouter, Depends, Response
+from pydantic import BaseModel
+
+from fastapi_factory_utilities.core.services.status.enums import ReadinessStatusEnum
+from fastapi_factory_utilities.core.services.status.services import (
+    StatusService,
+    depends_status_service,
+)
+
+api_v1_sys_readiness = APIRouter(prefix="/readiness")
+
+
+class ReadinessResponseModel(BaseModel):
+    """Readiness response schema."""
+
+    status: ReadinessStatusEnum
+
+
+@api_v1_sys_readiness.get(
+    path="",
+    tags=["sys"],
+    response_model=ReadinessResponseModel,
+    responses={
+        HTTPStatus.OK.value: {
+            "model": ReadinessResponseModel,
+            "description": "Readiness status.",
+        },
+        HTTPStatus.INTERNAL_SERVER_ERROR.value: {
+            "model": ReadinessResponseModel,
+            "description": "Internal server error.",
+        },
+    },
+)
+def get_api_v1_sys_readiness(
+    response: Response, status_service: StatusService = Depends(depends_status_service)
+) -> ReadinessResponseModel:
+    """Get the readiness of the system.
+
+    Args:
+        response (Response): The response object.
+        status_service (StatusService): The status service
+
+    Returns:
+        ReadinessResponse: The readiness status.
+    """
+    status: ReadinessStatusEnum = status_service.get_status()["readiness"]
+
+    match status:
+        case ReadinessStatusEnum.READY:
+            response.status_code = HTTPStatus.OK.value
+        case ReadinessStatusEnum.NOT_READY:
+            response.status_code = HTTPStatus.INTERNAL_SERVER_ERROR.value
+    return ReadinessResponseModel(status=status)

fastapi_factory_utilities-0.7.2/src/fastapi_factory_utilities/core/app/__init__.py

@@ -0,0 +1,23 @@
+"""Provides the core application module for the Python Factory."""
+
+from .application import ApplicationAbstract
+from .builder import ApplicationGenericBuilder
+from .config import (
+    BaseApplicationConfig,
+    DependencyConfig,
+    HttpServiceDependencyConfig,
+    RootConfig,
+    depends_dependency_config,
+)
+from .enums import EnvironmentEnum
+
+__all__: list[str] = [
+    "ApplicationAbstract",
+    "ApplicationGenericBuilder",
+    "BaseApplicationConfig",
+    "DependencyConfig",
+    "EnvironmentEnum",
+    "HttpServiceDependencyConfig",
+    "RootConfig",
+    "depends_dependency_config",
+]