| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091 |
- from __future__ import annotations
- """页面注册表。"""
- import importlib
- from pathlib import Path
- from typing import TYPE_CHECKING
- if TYPE_CHECKING:
- from tasks.GameUi.page_definition import Page
- class PageRegistry:
- """进程级静态页面注册表。
- 该注册表只保存页面定义,不保存任务运行时状态。
- """
- # 所有静态页面定义,key 为页面唯一标识。
- _pages: dict[str, "Page"] = {}
- # 已加载过的页面模块,避免重复导入。
- _loaded_modules: set[str] = set()
- # 是否完成一次全量页面扫描。
- _page_modules_loaded = False
- @classmethod
- def register(cls, page: "Page") -> "Page":
- """注册一个静态页面定义。
- Args:
- page: 待注册的页面定义。
- Returns:
- 原始页面对象,便于链式使用。
- """
- cls._pages[page.key] = page
- return page
- @classmethod
- def get(cls, key: str) -> "Page | None":
- """按页面 key 获取页面定义。
- Args:
- key: 页面唯一标识。
- Returns:
- 页面定义;不存在时返回 `None`。
- """
- return cls._pages.get(key)
- @classmethod
- def all(cls, categories: set[str] = None) -> list["Page"]:
- """获取所有或指定分类的页面定义。
- Args:
- categories: 允许返回的页面分类集合;为空时返回全部页面。
- Returns:
- 页面定义列表。
- """
- pages = list(cls._pages.values())
- if not categories:
- return pages
- return [page for page in pages if page.category in categories]
- @classmethod
- def load_all_pages(cls) -> None:
- """扫描并导入 `tasks/*/page.py`
- 该方法只会执行一次,用于构建静态页面注册表。
- """
- if cls._page_modules_loaded:
- return
- base_dir = Path(__file__).resolve().parent.parent
- for task_dir in base_dir.iterdir():
- if not task_dir.is_dir():
- continue
- for module_name in ("page",):
- module_file = task_dir / f"{module_name}.py"
- if not module_file.exists():
- continue
- import_name = f"tasks.{task_dir.name}.{module_name}"
- if import_name in cls._loaded_modules:
- continue
- importlib.import_module(import_name)
- cls._loaded_modules.add(import_name)
- cls._page_modules_loaded = True
|