| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 |
- # deps_registry.py
- """
- 依赖注册中心 (Dependency Registry)
- 负责解析 config/registry.yaml 配置文件,提供结构化的依赖元数据访问接口。
- """
- import os
- import yaml
- from dataclasses import dataclass
- from typing import List, Optional
- DEFAULT_CONFIG_PATH = os.path.join(os.path.dirname(__file__), "config", "registry.yaml")
- @dataclass
- class Dependency:
- """二进制依赖实体"""
- name: str # 依赖名称 (如 chrome, mihomo, cloakbrowser)
- version: str # 版本号 (如 146.0.7680.177.5, v1.19.24)
- platform: str # 适配平台 (linux, windows, darwin)
- url: str # 下载地址
- filename: Optional[str] = None # 本地保存文件名 (位于 downloads/ 目录下)
- def get_filename(self) -> str:
- """获取目标落地文件名,未指定时默认从 URL 提取"""
- if self.filename:
- return self.filename
- return self.url.rstrip("/").split("/")[-1]
- class DependencyRegistry:
- """依赖注册器"""
- def __init__(self):
- self._dependencies: List[Dependency] = []
- def register(
- self,
- name: str,
- version: str,
- platform: str,
- url: str,
- filename: Optional[str] = None
- ) -> "DependencyRegistry":
- """注册一个二进制依赖项"""
- dep = Dependency(
- name=name,
- version=str(version),
- platform=platform.lower(),
- url=url,
- filename=filename
- )
- self._dependencies.append(dep)
- return self
- def load_from_yaml(self, config_path: str = DEFAULT_CONFIG_PATH) -> "DependencyRegistry":
- """从 yaml 配置文件加载所有注册项"""
- if not os.path.exists(config_path):
- raise FileNotFoundError(f"未找到注册表配置文件: {config_path}")
- with open(config_path, "r", encoding="utf-8") as f:
- data = yaml.safe_load(f) or {}
- dep_list = data.get("dependencies", [])
- self._dependencies.clear()
- for item in dep_list:
- self.register(
- name=item["name"],
- version=item["version"],
- platform=item["platform"],
- url=item["url"],
- filename=item.get("filename")
- )
- return self
- def get_by_platform(self, target_platform: str) -> List[Dependency]:
- """按平台筛选依赖列表,若为 'all' 则返回所有平台依赖"""
- target = target_platform.lower()
- if target == "all":
- return list(self._dependencies)
- return [d for d in self._dependencies if d.platform == target]
- def get_all(self) -> List[Dependency]:
- """获取所有已注册依赖"""
- return list(self._dependencies)
- # 全局依赖注册中心实例(模块加载时自动从 config/registry.yaml 初始化)
- registry = DependencyRegistry()
- if os.path.exists(DEFAULT_CONFIG_PATH):
- registry.load_from_yaml(DEFAULT_CONFIG_PATH)
|