深度解析 WinPython Zero 精简发行版:WinPython-32bit 3.6.8.0Zero 包清单与 Changelog 生成机制
深度解析 WinPython Zero 精简发行版:WinPython-32bit 3.6.8.0Zero 包清单与 Changelog 生成机制
导读
本文以仓库 changelogs/WinPythonZero-32bit-3.6.8.0.md 为主体,系统解读 WinPython 历史“Zero”精简风味(flavor)发行版的完整软件包构成:它打包了哪些 Python 包、与上一版本相比升级了什么,以及这些包清单文档是如何由构建工具链与 WPPM(WinPython Package Manager)自动生成与维护的。读完本文,你将能读懂任意一份 WinPython changelog 索引文件,掌握包清单的生成原理,并能使用 wppm -diff 等命令自行对比任意两个发行版本的差异。
WinPython Zero:一个“最小可用”的发行风味
WinPython 是一款面向 Windows 平台的便携式 Python 发行版(见 README.rst),它会以“风味(flavor)”的形式产出不同定位的发行包:例如现在仓库中的 winpython_builds.toml 定义了 dot、slim、whl 等风味,而历史上的 Zero 风味则代表一种极致精简的发行形态——只包含 Python 解释器、包管理基础设施与少量必要工具,不做任何“加料”。
WinPythonZero-32bit-3.6.8.0 的命名可拆解为:
- WinPython:发行品牌;
- Zero:风味名(flavor),该版本号中 32 位发行包的文件名前缀即
WinPythonZero-32bit; - 32bit:32 位架构(当前构建配置默认
arch = "64",见 winpython_builds.toml 的[defaults]段,Zero 属于历史上同时提供 32/64 位双架构的时代产物); - 3.6.8.0:发行版本号,其中
3.6.8即 CPython 解释器版本; - Zero:跟随在版本号后的风味标识。
从当前仓库的构建配置结构可以推断,Zero 风味与今天 slim 风味的定位一脉相承:从 build_winpython_meta.py 的 expand_builds() 可以看出,一个构建 =(Python 版本, 风味)二元组,风味决定了安装哪些 requirements 文件、从哪些 source_dirs 取材。Zero 发行版只装了 27 个 Python 包且 Tools 列表为空(未捆绑任何外部工具),正是这一“最小化”思路的直接体现。
完整软件包清单:WinPython-32bit 3.6.8.0Zero
以下清单完整继承自 changelogs/WinPythonZero-32bit-3.6.8.0.md,共 27 个 Python 包(无捆绑 Tools):
| 包名 | 版本 | 说明 |
|---|---|---|
| Python | 3.6.8 | Python 编程语言及标准库 |
| brotli | 1.0.7 | Brotli 压缩库的 Python 绑定 |
| cloudpickle | 0.8.0 | 对 Python 对象的扩展 pickle 支持 |
| dask | 1.1.3 | 极简任务调度抽象 |
| docopt | 0.6.2 | Pythonic 命令行参数解析器 |
| idlex | 1.18 | IDLE 编辑器扩展 |
| jedi | 0.13.3 | 面向文本编辑器的 Python 自动补全工具 |
| joblib | 0.13.2 | 轻量级流水线:将 Python 函数用作流水线任务 |
| locket | 0.2.0 | 面向 Linux 与 Windows 的基于文件的锁 |
| parso | 0.3.4 | 一个 Python 解析器 |
| partd | 0.3.9 | 可追加的键值存储 |
| pip | 19.0.3 | Python 包安装与管理工具 |
| prompt_toolkit | 2.0.9 | 构建强大交互式命令行界面的库 |
| ptpython | 2.0.4 | 构建于 prompt_toolkit 之上的 Python REPL |
| pygments | 2.3.1 | 通用语法高亮器 |
| pyodbc | 4.0.26 | ODBC 数据库 API 模块 |
| python_snappy | 0.5.3 | Google snappy 压缩库的 Python 库 |
| pythonnet | 2.4.0.dev0 | Python 与 .Net/Mono 集成 |
| qtpy | 1.6.0 | 在多种 Qt 绑定(PyQt5、PyQt4、PySide)之上的抽象层 |
| setuptools | 40.8.0 | 便捷地下载、构建、安装、升级和卸载 Python 包 |
| six | 1.12.0 | Python 2 与 Python 3 兼容工具 |
| sqlite_bro | 0.8.11 | 单个 Python 文件实现的图形化 SQLite 客户端 |
| toolz | 0.9.0 | 列表处理工具与函数式工具 |
| wcwidth | 0.1.7 | 测量宽字符的终端列宽 |
| wheel | 0.33.1 | Python 内置包格式(wheel)支持 |
| winpython | 1.11.20190223 | WinPython 发行工具,含 WPPM 包管理器 |
清单按功能分组解读
对照 wppm/wppm.py 中 Distribution.render_markdown_for_list() 生成的“Name | Version | Description”三列表格格式,这份清单可以按用途分为几组:
- 包管理基座:
pip、setuptools、wheel是 Python 生态的安装/构建基础设施。值得注意的是,当前仓库的 mandatory_requirements.txt 只强制安装pip、setuptools、wppm三项,而 Zero 时代额外带上了wheel与winpython工具包——winpython包正是 WPPM 的载体,负责后续在发行版内导航、安装、注册等操作。 - 交互与编辑器体验:
prompt_toolkit+ptpython构成增强 REPL,jedi+parso提供补全与解析能力,pygments负责语法高亮,docopt与idlex分别提供参数解析和 IDLE 扩展。这正是 WinPython 面向“开箱即用的开发环境”的最小交互层。 - 轻量数据处理链路:
dask(任务调度)、cloudpickle(对象序列化)、joblib(流水线)、partd(键值存储)、locket(文件锁)、toolz(函数式工具)构成了一套精简版并行/延迟计算栈,但它不包含 numpy/scipy/matplotlib 等科学计算重器——这是 Zero 与完整版 WinPython 的显著区别。 - 数据库与系统互操作:
pyodbc(ODBC 访问)、sqlite_bro(SQLite 图形客户端)、pythonnet(.Net/Mono 集成)、qtpy(Qt 绑定抽象层,但 Zero 未捆绑任何 Qt 库本体)。 - 压缩与终端适配:
brotli、python_snappy两种压缩绑定,wcwidth处理宽字符终端宽度。
版本变更历史:从 3.6.7.0Zero 到 3.6.8.0Zero
changelogs/WinPythonZero-32bit-3.6.8.0_History.md 记录了本次发行相对上一版 3.6.7.0Zero 的全部升级项,共 15 个包升级、0 个新增、0 个移除:
| 包名 | 旧版本 → 新版本 | 说明 |
|---|---|---|
| cloudpickle | 0.6.1 → 0.8.0 | 扩展 pickle 支持 |
| dask | 0.20.0 → 1.1.3 | 极简任务调度抽象 |
| jedi | 0.13.1 → 0.13.3 | 自动补全工具 |
| joblib | 0.12.5 → 0.13.2 | 轻量级流水线 |
| parso | 0.3.1 → 0.3.4 | Python 解析器 |
| pip | 18.1 → 19.0.3 | 包安装与管理 |
| prompt_toolkit | 2.0.7 → 2.0.9 | 交互式命令行库 |
| pygments | 2.2.0 → 2.3.1 | 语法高亮器 |
| pyodbc | 4.0.24 → 4.0.26 | ODBC 数据库 API |
| Python | 3.6.7 → 3.6.8 | Python 解释器 |
| qtpy | 1.5.2 → 1.6.0 | Qt 绑定抽象层 |
| setuptools | 40.5.0 → 40.8.0 | 包构建安装工具 |
| six | 1.11.0 → 1.12.0 | Py2/Py3 兼容工具 |
| wheel | 0.32.2 → 0.33.1 | wheel 包格式支持 |
| winpython | 1.11.20181031 → 1.11.20190223 | WinPython 发行工具(WPPM) |
这份 History 的“只列升级、箭头 → 连接新旧版本”的格式,与 wppm/diff.py 中 compare_packages() 的输出逻辑完全吻合:该函数按包名归一化(- 转 _、统一小写)后,将两个索引比对为 New packages(新增)、Upgraded packages(升级,写作 旧版本 → 新版本)、Removed packages(移除)三类。由版本号可以看出,这是一次以“解释器补丁级升级 + 数据/交互栈例行刷新”为特征的维护型发布:核心亮点是把 CPython 从 3.6.7 提升到 3.6.8(该分支的最后一个安全修复版),并将 pip 从 18.x 大步跨到 19.0.3。
这些 Changelog 文件是如何生成的?
仓库内存在一批以 WinPython...md / WinPython..._History.md 命名的索引文件,它们并非手工维护,而是构建流水线的标准产物。从源码可以还原出完整的生成链路:
1. 包索引由 wppm 渲染
wppm/wppm.py 的 Distribution.generate_package_index_markdown() 负责渲染索引页。它依次调用:
get_package_index_data():读取发行版身份(名称、版本、Python 版本、位数、release level)、已安装工具(utils.get_installed_tools)、已安装包(get_installed_packages()→ 内部走piptree.PipData().pip_list(full=True))、wheelhouse 包;render_markdown_for_list():按“name | version | description”逐行输出 Markdown 表格。
其输出模板(## WinPython {version} + The following packages are included in ...)与 changelogs/WinPythonZero-32bit-3.6.8.0.md 的正文格式逐字对应——后者正是该函数在“32 位、3.6.8.0、Zero 风味”条件下的一次真实运行结果。
2. 构建工具链的第 7 步:写索引与历史
winpython/build_winpython.py 的 Step 7 专门负责 changelog 产出:
- 先通过环境变量
WINPYVER2、WINPYFLAVOR、WINPYVER将发行身份注入,调用wppm.Distribution().generate_package_index_markdown(),把结果写入形如WinPython{flavor}-{arch}bit-{version}.md的文件,并复制到changelogs/目录; - 再调用
wppm.diff.compare_package_indexes()对比该风味的上一次构建,生成_History.md。
同时该文件还生成了配套的 pylock.*.toml 与 requir.*.txt(含 hash 的锁定文件,见 generate_lockfiles() 与 process_wheelhouse_requirements()),让“包清单可复现、可离线安装”。
3. 历史文件与当前工作流的差异
值得注意:当前构建工作流不再写入 _History.md。tests/test_changelog_files.py 的模块注释明确说明:历史文件把某版本与“紧邻前一个版本”对比,而风味在不同周期之间会增减、读者通常每年才升级一次,因此该对比链条意义有限;现在推荐读者用 wppm -diff a.md b.md 自行选择任意两个索引对比(test_no_history_is_written_against_the_previous_release 专门固化了这一约定)。仓库中现存的大量 _History.md(含本文涉及的 3.6.8.0 历史文件)是旧构建流程的存档产物,正好为我们保留了“当年每个周期自动生成变更历史”的证据。
实战:如何使用这份包清单
用 wppm 对比任意两个发行索引
当前版本的 wppm 支持直接对两份索引做差分:
wppm -diff WinPythonslim-64bit-3.13.5.0.md WinPythonslim-64bit-3.14.7.0.md
wppm/wppm.py 中该命令不依赖任何发行版环境,直接以 UTF-8 读取两个 Markdown 索引,交由 wppm/diff.py 的 compare_files() 输出“新增 / 升级(旧→新)/ 移除”三组结果。你可以把 WinPythonZero-32bit-3.6.8.0.md 与同一风味的相邻版本(如 changelogs/WinPythonZero-32bit-3.7.4.1.md)或任意其他风味索引放在一起对比,自行复现 3.6.8.0_History.md 中的升级结论。
用 wppm -md 为当前发行重新生成索引
如果你手头有一份(任意 Windows 上的)Python 发行目录,wppm 还可以现场生成同样的包清单页:
wppm -md -t 目标Python目录
wppm/wppm.py 会打印与 changelog 同格式的 Markdown;若加上 -ws 指定 wheelhouse 目录,还能对比“已安装”与“wheelhouse 内置”两套清单的差异(compare_markdown_sections)。这正是构建工具链在 Step 7 中复用的同一套能力,适合在本地核对某个发行版的真实内容。
与今天风味的对应关系
从当前 winpython_builds.toml 的 <a href="https://link.gitcode.com/i/7474e61bc9a826eb318287dbc7142256" target="_blank">flavors.*] 段可以看到,构建体系已演进为 dot / dotf / slim / slimf / whl 等风味,Zero 不再在列表中;以“仅含最小依赖、不捆绑科学计算重器”为定位的继承者是 slim 风味(其 requirements 指向 [requirements_slim.txt)。因此,若想追溯 Zero 的思想在当代的映射,可对照 slim 的索引文件(如 changelogs/WinPythonslim-64bit-3.12.10.0.md)与本文的 27 包清单做横向比较。
小结
- WinPython-32bit 3.6.8.0Zero 是一个 27 包的极简发行:CPython 3.6.8 + 包管理基座(pip/setuptools/wheel)+ 交互栈(ptpython/jedi/parso/pygments)+ 轻量数据处理栈(dask/joblib/cloudpickle/partd/locket/toolz)+ 数据库与互操作(pyodbc/sqlite_bro/pythonnet/qtpy),无捆绑工具、无科学计算重器。
- 相对 3.6.7.0Zero 共升级 15 个包,核心是 Python 3.6.7 → 3.6.8 与 pip 18.1 → 19.0.3。
- 这类清单由构建流水线自动生成:
build_winpython.pyStep 7 调用wppm的generate_package_index_markdown()与diff.compare_package_indexes();现代工作流不再产出_History.md,改用wppm -diff让读者自行对比任意两个索引。