初始提交

2026-07-24 09:43:10 +08:00
commit b5b4721456
793 changed files with 116305 additions and 0 deletions
@@ -0,0 +1,183 @@
+from cli.core import (
+    DEFAULT_CORE_SERVICES,
+    CliContextFactory,
+    CliExecutionService,
+)
+from cli.runtime.cache import CACHE_RUNTIME, CacheRuntimeService
+
+from .presenter import CacheCommandPresenter
+
+
+class CacheCommandController:
+    """
+    缓存命令控制器。
+
+    该控制器负责组织 `cache` 命令组的上下文准备、runtime 调用、
+    payload 注入，以及基于输出格式选择 presenter 或直接返回 JSON。
+
+    :param context_factory: CLI 上下文工厂
+    :param execution_service: CLI 执行服务
+    :param presenter: 缓存命令文本渲染器
+    """
+
+    def __init__(
+        self,
+        *,
+        context_factory: CliContextFactory | None = None,
+        execution_service: CliExecutionService | None = None,
+        presenter: CacheCommandPresenter | None = None,
+        runtime_service: CacheRuntimeService | None = None,
+    ) -> None:
+        """
+        初始化缓存命令控制器。
+
+        :param context_factory: CLI 上下文工厂
+        :param execution_service: CLI 执行服务
+        :param presenter: 缓存命令文本渲染器
+        :param runtime_service: 缓存运行时服务
+        :return: None
+        """
+        self.context_factory = context_factory or DEFAULT_CORE_SERVICES.context_factory
+        self.execution_service = execution_service or DEFAULT_CORE_SERVICES.execution_service
+        self.presenter = presenter or CacheCommandPresenter()
+        self.runtime_service = runtime_service or CACHE_RUNTIME
+
+    def stats(self, env: str, output: str) -> None:
+        """
+        查看缓存统计信息。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        payload = self.execution_service.run_async(self.runtime_service.get_cache_stats())
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_cache_stats_text,
+            text_condition=lambda result_data: bool(result_data.get('ok', False)),
+        )
+
+    def keys(self, cache_name: str, env: str, output: str) -> None:
+        """
+        查看指定缓存名称下的键名列表。
+
+        :param cache_name: 缓存名称
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        payload = self.execution_service.run_async(self.runtime_service.list_cache_keys(cache_name))
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_cache_keys_text,
+            text_condition=lambda result_data: bool(result_data.get('ok', False)),
+        )
+
+    def get(self, cache_name: str, cache_key: str, env: str, output: str) -> None:
+        """
+        查看指定缓存内容。
+
+        :param cache_name: 缓存名称
+        :param cache_key: 缓存键名
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        payload = self.execution_service.run_async(self.runtime_service.get_cache_value(cache_name, cache_key))
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_cache_value_text,
+            text_condition=lambda result_data: bool(result_data.get('ok', False)),
+        )
+
+    def clear(
+        self,
+        env: str,
+        output: str,
+        allow_prod: bool,
+        yes: bool,
+        dry_run: bool,
+        *,
+        cache_name: str,
+        cache_key: str,
+        clear_all: bool,
+    ) -> None:
+        """
+        清理缓存。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :param allow_prod: 是否允许生产环境危险命令
+        :param yes: 是否跳过确认
+        :param dry_run: 是否演练执行
+        :param cache_name: 缓存名称前缀
+        :param cache_key: 缓存键名
+        :param clear_all: 是否清理全部缓存
+        :return: None
+        """
+        ctx = self.context_factory.build_dangerous(
+            env,
+            output,
+            allow_prod,
+            yes,
+            dry_run,
+            command_name='cache clear',
+        )
+        self.execution_service.complete_payload(
+            ctx,
+            self.execution_service.run_async(
+                self.runtime_service.clear_cache(
+                    cache_name=cache_name,
+                    cache_key=cache_key,
+                    clear_all=clear_all,
+                    dry_run=dry_run,
+                )
+            ),
+        )
+
+    def ttl(self, cache_name: str, cache_key: str, env: str, output: str) -> None:
+        """
+        查看指定缓存键的剩余过期时间。
+
+        :param cache_name: 缓存名称
+        :param cache_key: 缓存键名
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        payload = self.execution_service.run_async(self.runtime_service.get_cache_ttl(cache_name, cache_key))
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_cache_ttl_text,
+            text_condition=lambda result_data: 'error' not in result_data,
+        )
+
+    def warmup(self, env: str, output: str, allow_prod: bool, yes: bool) -> None:
+        """
+        执行系统缓存预热。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :param allow_prod: 是否允许生产环境危险命令
+        :param yes: 是否跳过确认
+        :return: None
+        """
+        ctx = self.context_factory.build_dangerous(
+            env,
+            output,
+            allow_prod,
+            yes,
+            False,
+            command_name='cache warmup',
+        )
+        self.execution_service.complete_payload(
+            ctx, self.execution_service.run_async(self.runtime_service.warmup_cache())
+        )