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 & import-to-download

pip install xes-assets

import xes_assets          # 导入即自动下载两个文件到当前工作目录
print(xes_assets.AUTODOWNLOADED)   # [Path(...rar), Path(...zip)]

import xes_assets 会立刻把两个文件下载到当前工作目录（含断点续传、大小 + SHA-256 校验）； 已存在且校验通过的文件直接跳过。

# 指定目录导入
import os; os.environ["XES_ASSETS_DEST"] = r"D:\xes"
import xes_assets

导入失败（断网等）会抛 XesAssetError 并提示设置 XES_ASSETS_AUTODOWNLOAD=0。

命令行 / CLI

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, download_on_import, extract, verify

download("zip", r"D:\xes")            # -> Path，含大小 + SHA-256 校验
download_all(r"D:\xes")               # 两个都下
download_on_import(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=".") → 预期的本地路径
• AUTODOWNLOADED 为本次导入已下载/已确认的路径列表
• 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 解压完全由标准库完成。

Changelog

• 1.1.0 — import xes_assets 直接下载（XES_ASSETS_DEST / XES_ASSETS_AUTODOWNLOAD / XES_ASSETS_QUIET），新增 download_on_import() 与 AUTODOWNLOADED；CLI 不再触发导入下载。
• 1.0.0 — 首个版本：手动下载 API + CLI，断点续传、大小/SHA-256 校验。

License

MIT