deps_registry.py 3.2 KB

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