RuoYi-Vue3-FastAPI/ruoyi-fastapi-backend/cli/runtime/app/service.py

from typing import Any

from cli.runtime.base import RUNTIME_ENVIRONMENT, RuntimeEnvironmentService

from .gateway import AppInfrastructureGateway
from .support import AppSnapshotSupport


class AppRuntimeService:
    """
    应用运行时服务。

    该服务作为应用运行时 facade，对外统一暴露应用实例构建、
    应用配置快照与环境信息快照入口。

    :param runtime_environment: 运行时环境服务
    :param infrastructure_gateway: 应用基础设施网关
    :param snapshot_support: 应用快照支持对象
    """

    def __init__(
        self,
        *,
        runtime_environment: RuntimeEnvironmentService | None = None,
        infrastructure_gateway: AppInfrastructureGateway | None = None,
        snapshot_support: AppSnapshotSupport | None = None,
    ) -> None:
        """
        初始化应用运行时服务。

        :param runtime_environment: 运行时环境服务
        :param infrastructure_gateway: 应用基础设施网关
        :param snapshot_support: 应用快照支持对象
        :return: None
        """
        self.runtime_environment = runtime_environment or RUNTIME_ENVIRONMENT
        self.infrastructure_gateway = infrastructure_gateway or AppInfrastructureGateway()
        self.snapshot_support = snapshot_support or AppSnapshotSupport(
            self.infrastructure_gateway,
            self.runtime_environment,
        )

    def build_app_instance(self) -> Any:
        """
        构建当前环境下的 FastAPI 应用实例。

        :return: FastAPI 应用实例
        """
        server_module = self.infrastructure_gateway.get_server_module()
        return server_module.create_app()

    def get_app_config_snapshot(self) -> dict[str, Any]:
        """
        读取当前运行环境的应用配置快照。

        :return: 应用配置快照
        """
        return self.snapshot_support.build_app_config_snapshot()

    def get_app_env_snapshot(self) -> dict[str, Any]:
        """
        读取当前 CLI 进程的环境解析结果快照。

        :return: 环境解析结果快照
        """
        return self.snapshot_support.build_app_env_snapshot()


APP_RUNTIME = AppRuntimeService()