feat: Add lifespan support to FastAPI app creation

Add optional lifespan parameter to create_fastapi_app function to support setup and teardown operations in the FastAPI application lifecycle. This enables proper resource management and initialization when creating FastAPI applications.

Author: Mohammadreza-kh94

archipy/helpers/utils/app_utils.py

@@ -3,7 +3,7 @@
 import logging
 from collections.abc import Awaitable, Callable
 from http import HTTPStatus
-from typing import Any, cast
+from typing import Any, cast, AsyncContextManager
 
 from fastapi import FastAPI, Request, Response
 from fastapi.exceptions import RequestValidationError
@@ -229,12 +229,14 @@ def create_fastapi_app(
         config: BaseConfig | None = None,
         *,
         configure_exception_handlers: bool = True,
+        lifespan: Callable[..., AsyncContextManager] | None = None,
     ) -> FastAPI:
         """Creates and configures a FastAPI application.
 
         Args:
             config (BaseConfig | None): Optional custom configuration. If not provided, uses global config.
             configure_exception_handlers (bool): Whether to configure exception handlers.
+            lifespan (Callable[..., AsyncContextManager] | None): Optional lifespan context manager for the app.
 
         Returns:
             FastAPI: The configured FastAPI application instance.
@@ -253,6 +255,7 @@ def create_fastapi_app(
             docs_url=config.FASTAPI.DOCS_URL,
             redocs_url=config.FASTAPI.RE_DOCS_URL,
             responses=cast(dict[int | str, Any], common_responses),
+            lifespan=lifespan,
         )
 
         FastAPIUtils.setup_sentry(config)