fastapi-factory-utilities 0.5.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

fastapi_factory_utilities/core/plugins/opentelemetry_plugin/__init__.py

@@ -1,130 +1,17 @@
 """OpenTelemetry Plugin Module."""
 
-import asyncio
-from typing import cast
-
-from opentelemetry.instrumentation.aiohttp_client import AioHttpClientInstrumentor
-from opentelemetry.instrumentation.fastapi import (  # pyright: ignore[reportMissingTypeStubs]
-    FastAPIInstrumentor,
-)
-from opentelemetry.sdk.metrics import MeterProvider
-from opentelemetry.sdk.trace import TracerProvider
-from structlog.stdlib import BoundLogger, get_logger
-
-from fastapi_factory_utilities.core.protocols import ApplicationAbstractProtocol
-
-from .builder import OpenTelemetryPluginBuilder
-from .configs import OpenTelemetryConfig
+from .configs import OpenTelemetryConfig, OpenTelemetryMeterConfig, OpenTelemetryTracerConfig
 from .exceptions import OpenTelemetryPluginBaseException, OpenTelemetryPluginConfigError
+from .plugins import OpenTelemetryPlugin, depends_meter_provider, depends_otel_config, depends_tracer_provider
 
 __all__: list[str] = [
     "OpenTelemetryConfig",
+    "OpenTelemetryMeterConfig",
+    "OpenTelemetryPlugin",
     "OpenTelemetryPluginBaseException",
-    "OpenTelemetryPluginBuilder",
     "OpenTelemetryPluginConfigError",
+    "OpenTelemetryTracerConfig",
+    "depends_meter_provider",
+    "depends_otel_config",
+    "depends_tracer_provider",
 ]
-
-_logger: BoundLogger = get_logger()
-
-
-def pre_conditions_check(application: ApplicationAbstractProtocol) -> bool:
-    """Check the pre-conditions for the OpenTelemetry plugin.
-
-    Args:
-        application (BaseApplicationProtocol): The application.
-
-    Returns:
-        bool: True if the pre-conditions are met, False otherwise.
-    """
-    del application
-    return True
-
-
-def on_load(
-    application: ApplicationAbstractProtocol,
-) -> None:
-    """Actions to perform on load for the OpenTelemetry plugin.
-
-    Args:
-        application (BaseApplicationProtocol): The application.
-    """
-    # Build the OpenTelemetry Resources, TracerProvider and MeterProvider
-    try:
-        otel_builder: OpenTelemetryPluginBuilder = OpenTelemetryPluginBuilder(application=application).build_all()
-    except OpenTelemetryPluginBaseException as exception:
-        _logger.error(f"OpenTelemetry plugin failed to start. {exception}")
-        return
-    # Configuration is never None at this point (checked in the builder and raises an exception)
-    otel_config: OpenTelemetryConfig = cast(OpenTelemetryConfig, otel_builder.config)
-    # Save as state in the FastAPI application
-    application.get_asgi_app().state.tracer_provider = otel_builder.tracer_provider
-    application.get_asgi_app().state.meter_provider = otel_builder.meter_provider
-    application.get_asgi_app().state.otel_config = otel_config
-    # Instrument the FastAPI application
-    FastAPIInstrumentor.instrument_app(  # pyright: ignore[reportUnknownMemberType]
-        app=application.get_asgi_app(),
-        tracer_provider=otel_builder.tracer_provider,
-        meter_provider=otel_builder.meter_provider,
-        excluded_urls=otel_config.excluded_urls,
-    )
-    # Instrument the AioHttpClient
-    AioHttpClientInstrumentor().instrument(  # pyright: ignore[reportUnknownMemberType]
-        tracer_provider=otel_builder.tracer_provider,
-        meter_provider=otel_builder.meter_provider,
-    )
-
-    _logger.debug(f"OpenTelemetry plugin loaded. {otel_config.activate=}")
-
-
-async def on_startup(
-    application: ApplicationAbstractProtocol,
-) -> None:
-    """Actions to perform on startup for the OpenTelemetry plugin.
-
-    Args:
-        application (BaseApplicationProtocol): The application.
-
-    Returns:
-        None
-    """
-    del application
-    _logger.debug("OpenTelemetry plugin started.")
-
-
-async def on_shutdown(application: ApplicationAbstractProtocol) -> None:
-    """Actions to perform on shutdown for the OpenTelemetry plugin.
-
-    Args:
-        application (BaseApplicationProtocol): The application.
-
-    Returns:
-        None
-    """
-    tracer_provider: TracerProvider = application.get_asgi_app().state.tracer_provider
-    meter_provider: MeterProvider = application.get_asgi_app().state.meter_provider
-    otel_config: OpenTelemetryConfig = application.get_asgi_app().state.otel_config
-
-    seconds_to_ms_multiplier: int = 1000
-
-    async def close_tracer_provider() -> None:
-        """Close the tracer provider."""
-        tracer_provider.force_flush(timeout_millis=otel_config.closing_timeout * seconds_to_ms_multiplier)
-        # No Delay for the shutdown of the tracer provider
-        tracer_provider.shutdown()
-
-    async def close_meter_provider() -> None:
-        """Close the meter provider.
-
-        Split the timeout in half for the flush and shutdown.
-        """
-        meter_provider.force_flush(timeout_millis=int(otel_config.closing_timeout / 2) * seconds_to_ms_multiplier)
-        meter_provider.shutdown(timeout_millis=int(otel_config.closing_timeout / 2) * seconds_to_ms_multiplier)
-
-    _logger.debug("OpenTelemetry plugin stop requested. Flushing and closing...")
-
-    await asyncio.gather(
-        close_tracer_provider(),
-        close_meter_provider(),
-    )
-
-    _logger.debug("OpenTelemetry plugin closed.")

fastapi_factory_utilities/core/plugins/opentelemetry_plugin/instruments/__init__.py

@@ -0,0 +1,85 @@
+"""Instruments for the OpenTelemetry plugin."""
+
+# pyright: reportMissingTypeStubs=false
+
+from collections.abc import Callable
+from importlib.util import find_spec
+from typing import Any
+
+from opentelemetry.sdk.metrics import MeterProvider
+from opentelemetry.sdk.trace import TracerProvider
+
+from fastapi_factory_utilities.core.plugins.opentelemetry_plugin.configs import OpenTelemetryConfig
+from fastapi_factory_utilities.core.protocols import ApplicationAbstractProtocol
+
+
+def instrument_fastapi(
+    application: ApplicationAbstractProtocol,
+    config: OpenTelemetryConfig,
+    meter_provider: MeterProvider,
+    tracer_provider: TracerProvider,
+) -> None:
+    """Instrument the FastAPI application."""
+    if find_spec(name="fastapi") and find_spec(name="opentelemetry.instrumentation.fastapi"):
+        from opentelemetry.instrumentation.fastapi import (  # pylint: disable=import-outside-toplevel # noqa: PLC0415
+            FastAPIInstrumentor,
+        )
+
+        excluded_urls_str: str | None = None if len(config.excluded_urls) == 0 else ",".join(config.excluded_urls)
+        FastAPIInstrumentor.instrument_app(  # pyright: ignore[reportUnknownMemberType]
+            app=application.get_asgi_app(),
+            tracer_provider=tracer_provider,
+            meter_provider=meter_provider,
+            excluded_urls=excluded_urls_str,
+        )
+
+
+def instrument_aiohttp(
+    application: ApplicationAbstractProtocol,  # pylint: disable=unused-argument
+    config: OpenTelemetryConfig,  # pylint: disable=unused-argument
+    meter_provider: MeterProvider,
+    tracer_provider: TracerProvider,
+) -> None:
+    """Instrument the Aiohttp application.
+
+    Args:
+        application (ApplicationAbstractProtocol): The application.
+        config (OpenTelemetryConfig): The configuration.
+        meter_provider (MeterProvider): The meter provider.
+        tracer_provider (TracerProvider): The tracer provider.
+
+    Returns:
+        None
+    """
+    if find_spec(name="aiohttp") and find_spec(name="opentelemetry.instrumentation.aiohttp_client"):
+        from opentelemetry.instrumentation.aiohttp_client import (  # pylint: disable=import-outside-toplevel # noqa: PLC0415
+            AioHttpClientInstrumentor,
+        )
+
+        AioHttpClientInstrumentor().instrument(  # pyright: ignore[reportUnknownMemberType]
+            tracer_provider=tracer_provider,
+            meter_provider=meter_provider,
+        )
+
+
+def instrument_aio_pika(
+    application: ApplicationAbstractProtocol,  # pylint: disable=unused-argument
+    config: OpenTelemetryConfig,  # pylint: disable=unused-argument
+    meter_provider: MeterProvider,
+    tracer_provider: TracerProvider,
+) -> None:
+    """Instrument the AioPika application."""
+    if find_spec(name="aio_pika") and find_spec(name="opentelemetry.instrumentation.aio_pika"):
+        from opentelemetry.instrumentation.aio_pika import (  # pylint: disable=import-outside-toplevel # noqa: PLC0415
+            AioPikaInstrumentor,
+        )
+
+        AioPikaInstrumentor().instrument(  # pyright: ignore[reportUnknownMemberType]
+            tracer_provider=tracer_provider,
+            meter_provider=meter_provider,
+        )
+
+
+INSTRUMENTS: list[Callable[..., Any]] = [instrument_fastapi, instrument_aiohttp, instrument_aio_pika]
+
+__all__: list[str] = ["INSTRUMENTS"]

fastapi_factory_utilities/core/plugins/opentelemetry_plugin/plugins.py

@@ -0,0 +1,137 @@
+"""Provides the OpenTelemetry plugin."""
+
+import asyncio
+from typing import Self, cast
+
+from fastapi import Request
+from opentelemetry.sdk.metrics import MeterProvider
+from opentelemetry.sdk.trace import TracerProvider
+from structlog.stdlib import BoundLogger, get_logger
+
+from fastapi_factory_utilities.core.plugins.abstracts import PluginAbstract
+
+from .builder import OpenTelemetryPluginBuilder
+from .configs import OpenTelemetryConfig
+from .exceptions import OpenTelemetryPluginBaseException, OpenTelemetryPluginConfigError
+from .instruments import INSTRUMENTS
+
+__all__: list[str] = [
+    "OpenTelemetryConfig",
+    "OpenTelemetryPluginBaseException",
+    "OpenTelemetryPluginBuilder",
+    "OpenTelemetryPluginConfigError",
+]
+
+_logger: BoundLogger = get_logger()
+
+
+class OpenTelemetryPlugin(PluginAbstract):
+    """OpenTelemetry plugin."""
+
+    SECONDS_TO_MS_MULTIPLIER: int = 1000
+
+    def __init__(self) -> None:
+        """Initialize the OpenTelemetry plugin."""
+        super().__init__()
+        self._otel_config: OpenTelemetryConfig | None = None
+        self._tracer_provider: TracerProvider | None = None
+        self._meter_provider: MeterProvider | None = None
+
+    def _build(self) -> Self:
+        """Build the OpenTelemetry plugin."""
+        assert self._application is not None
+        # Build the OpenTelemetry Resources, TracerProvider and MeterProvider
+        try:
+            otel_builder: OpenTelemetryPluginBuilder = OpenTelemetryPluginBuilder(
+                application=self._application
+            ).build_all()
+        except OpenTelemetryPluginBaseException as exception:
+            _logger.error(f"OpenTelemetry plugin failed to start. {exception}")
+            raise
+        # Configuration is never None at this point (checked in the builder and raises an exception)
+        self._otel_config = cast(OpenTelemetryConfig, otel_builder.config)
+        self._tracer_provider = otel_builder.tracer_provider
+        self._meter_provider = otel_builder.meter_provider
+        return self
+
+    def _instrument(self) -> None:
+        """Instrument the FastAPI application."""
+        assert self._application is not None
+        assert self._tracer_provider is not None
+        assert self._meter_provider is not None
+        assert self._otel_config is not None
+
+        for instrument in INSTRUMENTS:
+            instrument(self._application, self._otel_config, self._meter_provider, self._tracer_provider)
+
+    def on_load(self) -> None:
+        """On load."""
+        assert self._application is not None
+        # Build the OpenTelemetry Resources, TracerProvider and MeterProvider
+        self._build()
+        assert self._tracer_provider is not None
+        assert self._meter_provider is not None
+        assert self._otel_config is not None
+        self._add_to_state(key="tracer_provider", value=self._tracer_provider)
+        self._add_to_state(key="meter_provider", value=self._meter_provider)
+        self._add_to_state(key="otel_config", value=self._otel_config)
+        # Instrument the FastAPI application and AioHttpClient, ...
+        self._instrument()
+        _logger.debug(f"OpenTelemetry plugin loaded. {self._otel_config.activate=}")
+
+    async def on_startup(self) -> None:
+        """On startup."""
+        pass
+
+    async def close_tracer_provider(self) -> None:
+        """Close the tracer provider."""
+        assert self._tracer_provider is not None
+        assert self._otel_config is not None
+        self._tracer_provider.force_flush(
+            timeout_millis=self._otel_config.closing_timeout * self.SECONDS_TO_MS_MULTIPLIER
+        )
+        # No Delay for the shutdown of the tracer provider
+        try:
+            self._tracer_provider.shutdown()
+        except Exception as exception:  # pylint: disable=broad-exception-caught
+            _logger.error("OpenTelemetry plugin failed to close the tracer provider.", error=exception)
+
+    async def close_meter_provider(self) -> None:
+        """Close the meter provider."""
+        assert self._meter_provider is not None
+        assert self._otel_config is not None
+        self._meter_provider.force_flush(
+            timeout_millis=self._otel_config.closing_timeout * self.SECONDS_TO_MS_MULTIPLIER
+        )
+        try:
+            self._meter_provider.shutdown(
+                timeout_millis=self._otel_config.closing_timeout * self.SECONDS_TO_MS_MULTIPLIER
+            )
+        except Exception as exception:  # pylint: disable=broad-exception-caught
+            _logger.error("OpenTelemetry plugin failed to close the meter provider.", error=exception)
+
+    async def on_shutdown(self) -> None:
+        """On shutdown."""
+        _logger.debug("OpenTelemetry plugin stop requested. Flushing and closing...")
+
+        await asyncio.gather(
+            self.close_tracer_provider(),
+            self.close_meter_provider(),
+        )
+
+        _logger.debug("OpenTelemetry plugin closed.")
+
+
+def depends_tracer_provider(request: Request) -> TracerProvider:
+    """Get the tracer provider."""
+    return request.app.state.tracer_provider
+
+
+def depends_meter_provider(request: Request) -> MeterProvider:
+    """Get the meter provider."""
+    return request.app.state.meter_provider
+
+
+def depends_otel_config(request: Request) -> OpenTelemetryConfig:
+    """Get the OpenTelemetry config."""
+    return request.app.state.otel_config

fastapi_factory_utilities/core/protocols.py

@@ -1,17 +1,15 @@
 """Protocols for the base application."""
 
 from abc import abstractmethod
-from typing import TYPE_CHECKING, ClassVar, Protocol, runtime_checkable
+from typing import TYPE_CHECKING, ClassVar, Protocol
 
 from beanie import Document
 from fastapi import FastAPI
 
-from fastapi_factory_utilities.core.plugins import PluginsEnum
 from fastapi_factory_utilities.core.services.status.services import StatusService
 
 if TYPE_CHECKING:
     from fastapi_factory_utilities.core.app.config import RootConfig
-    from fastapi_factory_utilities.core.plugins import PluginState
 
 
 class ApplicationAbstractProtocol(Protocol):
@@ -21,8 +19,6 @@ class ApplicationAbstractProtocol(Protocol):
 
     ODM_DOCUMENT_MODELS: ClassVar[list[type[Document]]]
 
-    DEFAULT_PLUGINS_ACTIVATED: ClassVar[list[PluginsEnum]]
-
     @abstractmethod
     def get_config(self) -> "RootConfig":
         """Get the application configuration."""
@@ -34,52 +30,3 @@ class ApplicationAbstractProtocol(Protocol):
     @abstractmethod
     def get_status_service(self) -> StatusService:
         """Get the status service."""
-
-
-@runtime_checkable
-class PluginProtocol(Protocol):
-    """Defines the protocol for the plugins."""
-
-    @abstractmethod
-    def pre_conditions_check(self, application: ApplicationAbstractProtocol) -> bool:
-        """Check the pre-conditions for the plugin.
-
-        Args:
-            application (BaseApplicationProtocol): The application.
-
-        Returns:
-            bool: True if the pre-conditions are met, False otherwise.
-        """
-
-    @abstractmethod
-    def on_load(self, application: ApplicationAbstractProtocol) -> list["PluginState"] | None:
-        """The actions to perform on load for the plugin.
-
-        Args:
-            application (BaseApplicationProtocol): The application.
-
-        Returns:
-            None
-        """
-
-    @abstractmethod
-    async def on_startup(self, application: ApplicationAbstractProtocol) -> list["PluginState"] | None:
-        """The actions to perform on startup for the plugin.
-
-        Args:
-            application (BaseApplicationProtocol): The application.
-
-        Returns:
-            None
-        """
-
-    @abstractmethod
-    async def on_shutdown(self, application: ApplicationAbstractProtocol) -> None:
-        """The actions to perform on shutdown for the plugin.
-
-        Args:
-            application (BaseApplicationProtocol): The application.
-
-        Returns:
-            None
-        """

fastapi_factory_utilities/core/security/jwt.py

@@ -140,11 +140,11 @@ class JWTBearerAuthentication:
         # by the request or by the jwt parameter
         if self.jwt_raw is None and request is None:
             raise HTTPException(status_code=HTTPStatus.UNAUTHORIZED, detail="Missing Credentials")
-
+        jwt_raw: str
         if self.jwt_raw is None:
-            jwt_raw: str = self._extract_raw_token(request=request)  # type: ignore[arg-type]
+            jwt_raw = self._extract_raw_token(request=request)  # type: ignore[arg-type]
         else:
-            jwt_raw: str = self.jwt_raw
+            jwt_raw = self.jwt_raw
 
         # Execute the io bound and cpu bound tasks in parallel
         async with TaskGroup() as tg:

fastapi_factory_utilities/example/app.py

@@ -7,7 +7,9 @@ from beanie import Document
 from fastapi_factory_utilities.core.app.application import ApplicationAbstract
 from fastapi_factory_utilities.core.app.builder import ApplicationGenericBuilder
 from fastapi_factory_utilities.core.app.config import RootConfig
-from fastapi_factory_utilities.core.plugins import PluginsEnum
+from fastapi_factory_utilities.core.plugins.abstracts import PluginAbstract
+from fastapi_factory_utilities.core.plugins.odm_plugin import ODMPlugin
+from fastapi_factory_utilities.core.plugins.opentelemetry_plugin import OpenTelemetryPlugin
 from fastapi_factory_utilities.example.models.books.document import BookDocument
 
 
@@ -26,8 +28,6 @@ class App(ApplicationAbstract):
 
     ODM_DOCUMENT_MODELS: ClassVar[list[type[Document]]] = [BookDocument]
 
-    DEFAULT_PLUGINS_ACTIVATED: ClassVar[list[PluginsEnum]] = [PluginsEnum.OPENTELEMETRY_PLUGIN, PluginsEnum.ODM_PLUGIN]
-
     def configure(self) -> None:
         """Configure the application."""
         # Prevent circular import
@@ -48,4 +48,13 @@ class App(ApplicationAbstract):
 class AppBuilder(ApplicationGenericBuilder[App]):
     """Application builder for the App application."""
 
-    pass
+    def get_default_plugins(self) -> list[PluginAbstract]:
+        """Get the default plugins."""
+        return [ODMPlugin(), OpenTelemetryPlugin()]
+
+    def __init__(self, plugins: list[PluginAbstract] | None = None) -> None:
+        """Initialize the AppBuilder."""
+        # If no plugins are provided, use the default plugins
+        if plugins is None:
+            plugins = self.get_default_plugins()
+        super().__init__(plugins=plugins)

{fastapi_factory_utilities-0.5.0.dist-info → fastapi_factory_utilities-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi_factory_utilities
-Version: 0.5.0
+Version: 0.6.0
 Summary: Consolidate libraries and utilities to create microservices in Python with FastAPI, Beanie, Httpx, AioPika and OpenTelemetry.
 License: MIT
 License-File: LICENSE
@@ -19,12 +19,14 @@ 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-aiohttp-client (>=0.55b1,<0.56)
+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)

{fastapi_factory_utilities-0.5.0.dist-info → fastapi_factory_utilities-0.6.0.dist-info}/RECORD

@@ -3,37 +3,48 @@ fastapi_factory_utilities/core/__init__.py,sha256=tt5a-MgeFt_oACkc9K5xl2rynIbca9
 fastapi_factory_utilities/core/api/__init__.py,sha256=fAwgRcRry1nIyAL7CsCbpwR87n5tWnBWKEPH6QZCpp8,542
 fastapi_factory_utilities/core/api/tags.py,sha256=3hQcTeW0FS78sPTJ2PB44dMDTSkoW-xKj7rrfKX2Lk0,154
 fastapi_factory_utilities/core/api/v1/sys/__init__.py,sha256=mTXhpn3_KgQ1snt0-0PFmGvFr4n5srQRRADEdRSGFJM,345
-fastapi_factory_utilities/core/api/v1/sys/health.py,sha256=IF51Z1seOFn91m3FC57U8uWfAA7c_EhhBpjbu_ly9WQ,2807
+fastapi_factory_utilities/core/api/v1/sys/health.py,sha256=LILUwfyqeBDlf4GSpkU_3bxMjZPCLanOBkMGDKtQufY,2867
 fastapi_factory_utilities/core/api/v1/sys/readiness.py,sha256=xIY8pQLShU7KWRtlOUK5gTDyZ8aB1KBvLczC6boT-tg,1711
 fastapi_factory_utilities/core/app/__init__.py,sha256=6Ee_zK-KzJWoOElsAnGdBz8giRJlhAPMaEzs0I3gvrA,596
-fastapi_factory_utilities/core/app/application.py,sha256=WrDXh00r_jzQTtZGeFO43lIzvDraplitejTaSJj_uFE,5091
-fastapi_factory_utilities/core/app/builder.py,sha256=XKtJuRxvaqzNdhfNXGkyyxEH4MkZCgAUjkqYnOws8n0,4728
+fastapi_factory_utilities/core/app/application.py,sha256=fJTKgfqBWD1xzE7Y9ToZEBDrd1PxHtnZ7SHLmkS1S1M,4737
+fastapi_factory_utilities/core/app/builder.py,sha256=gkmhGVYFu2zbW5sxWyh6Pn5ysdCIvn1_WqNJMKls54s,3820
 fastapi_factory_utilities/core/app/config.py,sha256=MuV4G_M4QgZWYHoulusJLv_m4Qr2php-Cg9Jum4qkNA,7303
 fastapi_factory_utilities/core/app/enums.py,sha256=X1upnaehYU0eHExXTde5xsH-pI9q7HZDNsOEF5PApdg,226
 fastapi_factory_utilities/core/app/exceptions.py,sha256=tQDf0_4j5xgCbku7TL7JaZGs3_bjsWG2YLBCydQJpPw,664
-fastapi_factory_utilities/core/app/fastapi_builder.py,sha256=KoywPbWu9wY5s1KpBAwxgqH07PYT3Y6Mtlq-PP4__5I,2852
-fastapi_factory_utilities/core/app/plugin_manager/__init__.py,sha256=hHk_fet3d41I-MzohGlvbNjqWQtAbxWaaEfbt41Zweo,319
-fastapi_factory_utilities/core/app/plugin_manager/exceptions.py,sha256=CFrZvROT7mLzNpXWwDra1j08lA_7ZrSrOHN94sEEfnQ,1026
-fastapi_factory_utilities/core/app/plugin_manager/plugin_manager.py,sha256=b6wDStsjAdCKExFFNCFEmeMERNsVCeIp1qseKfn5TO4,6681
+fastapi_factory_utilities/core/app/fastapi_builder.py,sha256=7egWkS98nTiVBe2Bw5dQzDBryQCkz4w7gnY9HA24NFg,2855
 fastapi_factory_utilities/core/exceptions.py,sha256=9s-i_RHPCsOswQPRvK8tyy-smE1118pytxWDJMNEl0M,2670
-fastapi_factory_utilities/core/plugins/__init__.py,sha256=W-BCkqP0xG980980z3mc8T6Vrp1Akv4szA0PRzkUbiU,756
-fastapi_factory_utilities/core/plugins/example/__init__.py,sha256=GF69IygLXxzrCh7VryekEWun663kKBhWtRS3w-1tzBc,1030
-fastapi_factory_utilities/core/plugins/httpx_plugin/__init__.py,sha256=P5FUyv7mQr8RZWQ8ifkoK8GXvqSI71q2b2dm-ag2JhQ,1028
-fastapi_factory_utilities/core/plugins/odm_plugin/__init__.py,sha256=EyjshkhEseri659k7YISJEVH0-cpSlAWaKvhnCPNNbY,5797
-fastapi_factory_utilities/core/plugins/odm_plugin/builder.py,sha256=D6UUDOJYv6IWugilodi6x9fwj_kZkqzPfKT_pL9UW7c,8753
-fastapi_factory_utilities/core/plugins/odm_plugin/configs.py,sha256=zQoJC1wLNyq2pZyFhl0bKeNsTl4y_4_82BHCCaOEjCQ,331
+fastapi_factory_utilities/core/plugins/__init__.py,sha256=7ctIv2Jx2uOUpgm8ITFRuZxHi6OXvlVS0VcbszVzvis,114
+fastapi_factory_utilities/core/plugins/abstracts.py,sha256=p5iXmeOVD737G73I2keKV0Y-jLGQf2vYbTSR1LgrA14,1165
+fastapi_factory_utilities/core/plugins/aiopika/__init__.py,sha256=U_9UEE76kA9WgMZBMT5mbet8kFzvorhcQEPuaW1yYk4,609
+fastapi_factory_utilities/core/plugins/aiopika/abstract.py,sha256=TcvDwdaLV0UqFHQy6Sn3Y5Fp-1463dhL7VNB9LTKL5I,1682
+fastapi_factory_utilities/core/plugins/aiopika/configs.py,sha256=BEPE8Ss7q_yCyuii4nywmIgh67iNLdhKxUm8tC0PdCY,3706
+fastapi_factory_utilities/core/plugins/aiopika/exceptions.py,sha256=AkBKT8HVPpJDAntLNlOLp6lpQpKI-k8gxNzU24FsOF0,985
+fastapi_factory_utilities/core/plugins/aiopika/exchange.py,sha256=tQfrv7-mX4lrHY1OTXB_aTkbg_brYniIuFisfFDSTT8,2509
+fastapi_factory_utilities/core/plugins/aiopika/listener/__init__.py,sha256=LsTyu6kGoUm7c5OvSQTDJL7d8CG9TeARBHHVe_HGsHY,148
+fastapi_factory_utilities/core/plugins/aiopika/listener/abstract.py,sha256=8po9iEWmNTFEc6K_ile5H-BHIeH9dxSaqVKp67xb6hk,2577
+fastapi_factory_utilities/core/plugins/aiopika/message.py,sha256=Tn9pLZlkx238GA6SEav15Npq3TWu_dQ0NtzFWvPcPTM,2861
+fastapi_factory_utilities/core/plugins/aiopika/plugins.py,sha256=0Oj9842Se3pGEUiHpIR4l7YTcKnfwkiH8Xjp7ykRddI,2214
+fastapi_factory_utilities/core/plugins/aiopika/publisher/__init__.py,sha256=MGGdygH72xHZ4QAwvbUZKQt-_mPzLmMxHyAACSNnZ_c,151
+fastapi_factory_utilities/core/plugins/aiopika/publisher/abstract.py,sha256=PmIG5zlx-tFUAneHtbknR0Ik5flz8pMTzxcreY2hZ7s,2494
+fastapi_factory_utilities/core/plugins/aiopika/queue.py,sha256=u7iOOnv8EHO7q2qM6jDlYimajrjlQN8R3ftL61XgQIE,2794
+fastapi_factory_utilities/core/plugins/odm_plugin/__init__.py,sha256=JsVz4GBiZRmm4qpUD1-Wsg2tRXTn-VO5fU-W1whZo4E,683
+fastapi_factory_utilities/core/plugins/odm_plugin/builder.py,sha256=MdO1D0C9LQpoqtNFqgPwSYedLzXR6PArhkoJw6wzykg,8761
+fastapi_factory_utilities/core/plugins/odm_plugin/configs.py,sha256=5bVbtsLwJhuIvt8FCzOvk002G8qFmZumWkN75bPKatc,331
 fastapi_factory_utilities/core/plugins/odm_plugin/depends.py,sha256=OcLsfTLzMBk_xFV6qsMy_-qFkiphEbbEuaHUooagxg8,730
-fastapi_factory_utilities/core/plugins/odm_plugin/documents.py,sha256=BFQYHxHBmTacJRfhZi2OffvT_RAFvAAiDVQAa_d6Y7w,1141
+fastapi_factory_utilities/core/plugins/odm_plugin/documents.py,sha256=4aQNrD26d0S542_LYmxxm07Q8SWzbGe3PCpho6iWY5Q,1102
 fastapi_factory_utilities/core/plugins/odm_plugin/exceptions.py,sha256=acnKJB0lGAzDs-7-LjBap8shjP3iV1a7dw7ouPVF27o,551
 fastapi_factory_utilities/core/plugins/odm_plugin/helpers.py,sha256=s9iEujDZbTmTb9FByJAVUzLkjQpsciQT9dytkeosKuE,463
+fastapi_factory_utilities/core/plugins/odm_plugin/plugins.py,sha256=0jsLtw4NxZB6bDcBLBvWHqB-RELoewsSXTJdAOGunSY,6443
 fastapi_factory_utilities/core/plugins/odm_plugin/repositories.py,sha256=GJ3ovlxzTpiJ2_XlgARtwn6j0SbQxxAray_r8QWvGok,11313
-fastapi_factory_utilities/core/plugins/opentelemetry_plugin/__init__.py,sha256=gXM-apuR1xdjVxfOzurF-db3SauKyeWjK_7SFWkVWxw,4689
+fastapi_factory_utilities/core/plugins/opentelemetry_plugin/__init__.py,sha256=xXHn5dUxhgdDDQMpTHf3voolzS0E3zE2RFbtFHJzb38,641
 fastapi_factory_utilities/core/plugins/opentelemetry_plugin/builder.py,sha256=9npQImifYAbEg0lFG7KwZ8V78SNrPoaINgd8vKitdMw,12509
 fastapi_factory_utilities/core/plugins/opentelemetry_plugin/configs.py,sha256=pMG9leMB7rtdkdGFLIxXflV7bf9epGrrYPt2N97KZcM,3750
 fastapi_factory_utilities/core/plugins/opentelemetry_plugin/exceptions.py,sha256=CpsHayfQpP0zghN8y5PP6TBy-cXhHoNxBR--I86gAdE,327
 fastapi_factory_utilities/core/plugins/opentelemetry_plugin/helpers.py,sha256=qpTIzX67orJz7vy6SBIwRs24omMBoToJkhpurZRjPuk,1533
-fastapi_factory_utilities/core/protocols.py,sha256=TzZKr_KfmTphk2LL-TD2XzxNlLbihbGM2DxWMhc5lEQ,2428
-fastapi_factory_utilities/core/security/jwt.py,sha256=jO3FNOiqVvCCbvShUmCyfii8oLXNbYk_Sfsb_O29dng,5630
+fastapi_factory_utilities/core/plugins/opentelemetry_plugin/instruments/__init__.py,sha256=lMtdd1DSDrFcXggf0qMpB1RJC7aBqWMpOBXxC8-bqPY,3307
+fastapi_factory_utilities/core/plugins/opentelemetry_plugin/plugins.py,sha256=v9W4bqEljcRgeSL8pf-4yZ7SGXOFmxVoljthvcLdy6Q,5356
+fastapi_factory_utilities/core/protocols.py,sha256=w5FQqMAZ_OulG5hQWkoOapNSnxsjBPq4EjvWNXXdI_c,859
+fastapi_factory_utilities/core/security/jwt.py,sha256=BrP9EmtuOxjafHKluYzRtGdZYankv72iQgG49t9TgJw,5640
 fastapi_factory_utilities/core/security/kratos.py,sha256=yP9-TkELeXRPRYE9aQRlOPlwvaUJ7VQpyAea8ucWUfg,3364
 fastapi_factory_utilities/core/services/hydra/__init__.py,sha256=AKBYNc3zW5OsCLLeFSXqmDbWbQefHUJxstLpsXLQEUQ,369
 fastapi_factory_utilities/core/services/hydra/exceptions.py,sha256=ePMrfZturU2IVcxOebR0CbVKKqprce_fK-4UXbPPgNI,450
@@ -63,7 +74,7 @@ fastapi_factory_utilities/example/api/__init__.py,sha256=qI82eeSwVjR6jSkX1pxm8AL
 fastapi_factory_utilities/example/api/books/__init__.py,sha256=zXARBnjywJwg1XsLbcixYWcHH4uC9mF-kbbX4P8cVgA,160
 fastapi_factory_utilities/example/api/books/responses.py,sha256=21WeD6bdg0MCD_0vRHwmsL4W79iDcG9NnDLemXysc84,540
 fastapi_factory_utilities/example/api/books/routes.py,sha256=bwg8Bhvoj9vx2SdwunzFS-Z3cHECtjl_yGdo8MfiGEM,1529
-fastapi_factory_utilities/example/app.py,sha256=SkQwK2Z29I0Kz36wiWyoh2V_CvBexQ5LJ3Ka-npCQUI,1579
+fastapi_factory_utilities/example/app.py,sha256=MInt71wnDEC9yqVJeT3hChj7DRmg7sI3Ta0KkfubdyU,2076
 fastapi_factory_utilities/example/application.yaml,sha256=5xRyFSuMxmgZ5Mikai94UqKYJ7PxJp8omlXobTjv14M,485
 fastapi_factory_utilities/example/entities/books/__init__.py,sha256=cpTMhLpenb359lOT9HHUv6DzKX8fKl4WCzcsB3ddk6Q,185
 fastapi_factory_utilities/example/entities/books/entities.py,sha256=rLE01lE7U6WizrD5ZHMRwkynd8_dWF6DltBFH61f-Do,405
@@ -76,8 +87,8 @@ fastapi_factory_utilities/example/models/books/repository.py,sha256=7K63uAsSEGZ2
 fastapi_factory_utilities/example/services/books/__init__.py,sha256=Z06yNRoA7Zg3TGN-Q9rrvJg6Bbx-qJw661MVwukV6vQ,148
 fastapi_factory_utilities/example/services/books/services.py,sha256=-x7d4hotUWLzWo5uImMjFmtNcSTHwWv2bfttIbYYKbA,5380
 fastapi_factory_utilities/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastapi_factory_utilities-0.5.0.dist-info/METADATA,sha256=8f6MuYLqieqLs4cFDZ8a75dO4zmdcqVUDsYPb3wkP4k,3500
-fastapi_factory_utilities-0.5.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-fastapi_factory_utilities-0.5.0.dist-info/entry_points.txt,sha256=IK0VcBexXo4uXQmTrbfhhnnfq4GmXPRn0GBB8hzlsq4,101
-fastapi_factory_utilities-0.5.0.dist-info/licenses/LICENSE,sha256=iO1nLzMMst6vEiqgSUrfrbetM7b0bvdzXhbed5tqG8o,1074
-fastapi_factory_utilities-0.5.0.dist-info/RECORD,,
+fastapi_factory_utilities-0.6.0.dist-info/METADATA,sha256=T6w0jeZL3srYmEK2geExdfhqrucPUilLBNDCBY-PWrs,3605
+fastapi_factory_utilities-0.6.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+fastapi_factory_utilities-0.6.0.dist-info/entry_points.txt,sha256=IK0VcBexXo4uXQmTrbfhhnnfq4GmXPRn0GBB8hzlsq4,101
+fastapi_factory_utilities-0.6.0.dist-info/licenses/LICENSE,sha256=iO1nLzMMst6vEiqgSUrfrbetM7b0bvdzXhbed5tqG8o,1074
+fastapi_factory_utilities-0.6.0.dist-info/RECORD,,

fastapi_factory_utilities/core/app/plugin_manager/__init__.py

@@ -1,15 +0,0 @@
-"""Provide PluginManager."""
-
-from .exceptions import (
-    InvalidPluginError,
-    PluginManagerError,
-    PluginPreConditionNotMetError,
-)
-from .plugin_manager import PluginManager
-
-__all__: list[str] = [
-    "InvalidPluginError",
-    "PluginManager",
-    "PluginManagerError",
-    "PluginPreConditionNotMetError",
-]

fastapi_factory_utilities/core/app/plugin_manager/exceptions.py

@@ -1,33 +0,0 @@
-"""Provide the exceptions for the plugin manager."""
-
-from fastapi_factory_utilities.core.exceptions import FastAPIFactoryUtilitiesError
-
-
-class PluginManagerError(FastAPIFactoryUtilitiesError):
-    """Generic plugin manager error."""
-
-
-class InvalidPluginError(PluginManagerError):
-    """The plugin is invalid."""
-
-    def __init__(self, plugin_name: str, message: str) -> None:
-        """Instantiate the exception.
-
-        Args:
-            plugin_name (str): The plugin name.
-            message (str): The message
-        """
-        super().__init__(message=f"Invalid plugin: {plugin_name}, {message}")
-
-
-class PluginPreConditionNotMetError(PluginManagerError):
-    """The plugin pre-condition is not met."""
-
-    def __init__(self, plugin_name: str, message: str) -> None:
-        """Instantiate the exception.
-
-        Args:
-            plugin_name (str): The plugin name.
-            message (str): The message
-        """
-        super().__init__(message=f"Plugin pre-condition not met: {plugin_name}, {message}")