xes-assets

零依赖下载器 / Zero-dependency downloader for the XES Python course asset files:

• https://livefile.xesimg.com/programme/python_assets/3f51c62b04d3aacc27b0d53f294ecc3b.rar
• https://livefile.xesimg.com/programme/python_assets/a3635617bd88675041ba69f8398df5a0.zip

只用 Python 标准库（urllib、hashlib、zipfile），没有任何第三方依赖。 Uses nothing but the Python standard library — no third-party dependency at all.

安装 / Install

pip install xes-assets

命令行 / CLI

xes-assets --list                        # 查看两个文件的信息
xes-assets zip -d D:\xes                 # 下载 ZIP
xes-assets all -d D:\xes -x              # 下载两个并解压
xes-assets rar --verify-only -d D:\xes   # 只校验已下载文件
python -m xes_assets all -d D:\xes       # 等价写法

Python API

from xes_assets import ASSETS, download, download_all, extract, verify

download("zip", r"D:\xes")            # -> Path，含大小 + SHA-256 校验
download_all(r"D:\xes")               # 两个都下
verify("rar", r"D:\xes")              # -> True/False
extract("zip", r"D:\xes")             # 标准库解压，返回目录
extract("rar", r"D:\xes")             # 需外部 7z / UnRAR（见下）

单个函数的行为：

• download(key, dest=".", *, overwrite=False, verify_checksum=True, progress=None, timeout=60, retries=3) 先写 <文件名>.part，校验大小与 SHA-256 通过后才原子改名为正式文件；断点续传用 HTTP Range （服务器返回 206 时继续，否则从头开始），网络中断自动重试。
• download_all(dest=".", *, keys=None, **kwargs) → List[Path]
• extract(key, dest=None, *, archive=None, overwrite=False) → 解压目录 Path
• verify(key, path=None, dest=".") → bool
• asset_path(key, dest=".") → 预期的本地路径
• ASSETS / ASSET_ORDER 为元数据常量；XesAssetError 为统一异常

文件与校验值 / Files

校验值在主文件被上游替换前一直有效；上游变更时下载会明确报 checksum mismatch （不会静默留下坏文件）。

关于 RAR 解压 / About RAR extraction

下载永远只需要标准库。解压 .rar 时本包会依次查找 7z / 7zz / 7za / unrar / unar / bsdtar（PATH 中或常见安装路径 C:\Program Files\7-Zip\7z.exe、C:\Program Files\WinRAR\UnRAR.exe）， 找不到就抛 XesAssetError 并提示手工解压。ZIP 解压完全由标准库完成。

License

MIT