deps_registry.py 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. # deps_registry.py
  2. """
  3. 依赖注册中心 (Dependency Registry)
  4. 负责解析 config/registry.yaml 配置文件,提供结构化的依赖元数据访问接口。
  5. """
  6. import os
  7. import yaml
  8. from dataclasses import dataclass
  9. from typing import List, Optional
  10. DEFAULT_CONFIG_PATH = os.path.join(os.path.dirname(__file__), "config", "registry.yaml")
  11. @dataclass
  12. class Dependency:
  13. """二进制依赖实体"""
  14. name: str # 依赖名称 (如 chrome, mihomo, cloakbrowser)
  15. version: str # 版本号 (如 146.0.7680.177.5, v1.19.24)
  16. platform: str # 适配平台 (linux, windows, darwin)
  17. url: str # 下载地址
  18. filename: Optional[str] = None # 本地保存文件名 (位于 downloads/ 目录下)
  19. def get_filename(self) -> str:
  20. """获取目标落地文件名,未指定时默认从 URL 提取"""
  21. if self.filename:
  22. return self.filename
  23. return self.url.rstrip("/").split("/")[-1]
  24. class DependencyRegistry:
  25. """依赖注册器"""
  26. def __init__(self):
  27. self._dependencies: List[Dependency] = []
  28. def register(
  29. self,
  30. name: str,
  31. version: str,
  32. platform: str,
  33. url: str,
  34. filename: Optional[str] = None
  35. ) -> "DependencyRegistry":
  36. """注册一个二进制依赖项"""
  37. dep = Dependency(
  38. name=name,
  39. version=str(version),
  40. platform=platform.lower(),
  41. url=url,
  42. filename=filename
  43. )
  44. self._dependencies.append(dep)
  45. return self
  46. def load_from_yaml(self, config_path: str = DEFAULT_CONFIG_PATH) -> "DependencyRegistry":
  47. """从 yaml 配置文件加载所有注册项"""
  48. if not os.path.exists(config_path):
  49. raise FileNotFoundError(f"未找到注册表配置文件: {config_path}")
  50. with open(config_path, "r", encoding="utf-8") as f:
  51. data = yaml.safe_load(f) or {}
  52. dep_list = data.get("dependencies", [])
  53. self._dependencies.clear()
  54. for item in dep_list:
  55. self.register(
  56. name=item["name"],
  57. version=item["version"],
  58. platform=item["platform"],
  59. url=item["url"],
  60. filename=item.get("filename")
  61. )
  62. return self
  63. def get_by_platform(self, target_platform: str) -> List[Dependency]:
  64. """按平台筛选依赖列表,若为 'all' 则返回所有平台依赖"""
  65. target = target_platform.lower()
  66. if target == "all":
  67. return list(self._dependencies)
  68. return [d for d in self._dependencies if d.platform == target]
  69. def get_all(self) -> List[Dependency]:
  70. """获取所有已注册依赖"""
  71. return list(self._dependencies)
  72. # 全局依赖注册中心实例(模块加载时自动从 config/registry.yaml 初始化)
  73. registry = DependencyRegistry()
  74. if os.path.exists(DEFAULT_CONFIG_PATH):
  75. registry.load_from_yaml(DEFAULT_CONFIG_PATH)