WinPython 3.8.3.0dot 版本解析:从 3.8.2.0dot 的包升级到 dot flavor 极简构建体系
WinPython 3.8.3.0dot 版本解析:从 3.8.2.0dot 的包升级到 dot flavor 极简构建体系
WinPython 是面向 Windows 平台的免费便携式 Python 发行版(可在 README.rst 中确认其定位),而 dot(即 3.8.3.0dot 中的 "dot")是 WinPython 家族中一个以"极简"著称的 flavor——它只打包解释器与最基础的包管理工具,体积只有完整版的几十分之一。本文以仓库中的 changelogs/WinPythondot-64bit-3.8.3.0_History.md 变更记录为骨架,完整解析 3.8.3.0dot 相比 3.8.2.0dot 的每一项升级,并结合 winpython_builds.toml、dot_requirements.txt 等构建配置文件,讲清 dot flavor 从"配置定义"到"产物生成"的完整机制,以及如何使用哈希校验与 WPPM 验证、管理这个发行版。读完本文,你将能看懂 WinPython 变更记录的结构化含义,并理解 dot 与完整版发行版在内容与构建上的本质差异。
一、认识 WinPython 的 "dot" 发行版
1.1 什么是 flavor
在 WinPython 的构建体系中,一个发行版由 (python, flavor) 二元组唯一确定:python 决定解释器版本,flavor 决定打包哪些包、附带哪些工具。这在 winpython_builds.toml 的文件头注释中写得很清楚:
A build is a (python, flavor) pair. Everything else is derived: basedir、requirements、source_dirs、wheelhousereq、toolsdirs 均由该二元组推导而来。
dot 正是其中之一,且 dot 与 dotf、slim、slimf 等 flavor 并列出现在 [flavors.*] 段落中,共同构成 WinPython 的多形态产品线。
1.2 dot 与完整版的核心差异
对比仓库中同一版本的两份清单可以直观看出差异:
| 维度 | dot 版(WinPythondot-64bit-3.8.3.0.md) | 完整版(WinPython-64bit-3.8.3.0.md) |
|---|---|---|
| Tools 部分 | 为空(不附带任何额外工具) | Nodejs v12.16.3、npmjs 6.14.4 |
| Python 包数量 | 仅 6 个基础包 | 数百个科学计算/数据分析包 |
| 安装包体积(参考 changelogs/md5_sha1.txt 记录) | dotrc 候选版约 24 MB | 完整版约 728 MB |
也就是说,dot 版刻意剔除了 Node.js/npm 等 Web 工具以及 NumPy、SciPy、Jupyter、PyQt5 等科学计算栈,只保留"能跑 Python、能装包"的最小闭环。对于需要干净基线、自定义环境或快速分发的场景,dot 版是最合适的起点。
二、3.8.3.0dot 变更总览
根据 changelogs/WinPythondot-64bit-3.8.3.0_History.md,本次发布自版本 3.8.2.0dot 以来的全部变更为 4 个包的升级,无新增、无移除:
| 包 | 升级前 → 升级后 | 官方描述(转写) |
|---|---|---|
| pip | 20.0.2 → 20.1 | PyPA 推荐的 Python 包安装工具 |
| Python | 3.8.2 → 3.8.3 | 带标准库的 Python 编程语言 |
| setuptools | 46.0.0 → 46.4.0 | 便捷地下载、构建、安装、升级、卸载 Python 包 |
| winpython | 2.3.20200319 → 2.4.20200425 | WinPython 发行工具集,含 WPPM |
与同期完整版 changelogs/WinPython-64bit-3.8.3.0_History.md 那数十项升级/新增/移除相比,dot 版的变更面极小,这正是极简发行版的典型特征:只跟随解释器与包管理工具链的维护节奏。
三、逐包解析:本次升级的技术含义
3.1 Python 3.8.2 → 3.8.3
- 升级跨度:
3.8.2 → 3.8.3 - 类型:CPython 3.8 系列的一个 bugfix(维护)版本,随官方发布节奏同步跟进;
- 对发行版的意义:dot 版的核心就是解释器本体,因此 Python 的升级是所有升级中影响面最大的——它直接决定标准库行为与所有后续包的可运行基线。
3.2 pip 20.0.2 → 20.1
- 升级跨度:
20.0.2 → 20.1(次版本号提升,属于功能更新级别); - pip 是 WinPython 官方推荐的增删包方式。这一点在 README.rst 中有明确表述:WPPM 是浏览/安装/注册的辅助工具,"pip is the recommanded way to add or remove packages otherwise"(pip 是其余情况下增删包的首选方式)。因此 pip 的升级直接关系到用户日常装包体验。
3.3 setuptools 46.0.0 → 46.4.0
- 升级跨度:
46.0.0 → 46.4.0; - setuptools 承担包的构建与安装元数据处理。在 WinPython 的构建配置中,它是"必需包"清单的一员——见下文 mandatory_requirements.txt 分析。
3.4 winpython 2.3.20200319 → 2.4.20200425
- 升级跨度:
2.3.20200319 → 2.4.20200425; - 注意其版本号自带日期戳(20200319 = 2020-03-19 构建,20200425 = 2020-04-25 构建);
- 该包是"WinPython distribution tools, including WPPM",即随发行版分发的工具集,其核心组件 WPPM(WinPython Package Manager) 的源码就在本仓库的 wppm/ 目录下(入口为 wppm/wppm.py,其中定义了
Package、Distribution两个核心类与main()命令行入口)。升级此包意味着 WPPM 工具自身获得了功能更新。
四、dot 版 3.8.3.0 完整包清单
除上述 4 个升级包外,dot 版还包含两个"原地不动"的基础包。将 changelogs/WinPythondot-64bit-3.8.3.0.md 的完整清单转写如下:
Tools
(空)——本发行版不附带任何额外工具。
Python packages
| 名称 | 版本 | 描述 |
|---|---|---|
| Python | 3.8.3 | Python 编程语言及标准库 |
| pip | 20.1 | PyPA 推荐的 Python 包安装工具 |
| setuptools | 46.4.0 | 便捷地下载、构建、安装、升级、卸载 Python 包 |
| sqlite_bro | 0.9.1 | 单文件实现的图形化 SQLite 客户端 |
| wheel | 0.34.2 | Python 的 wheel 内置包格式 |
| winpython | 2.4.20200425 | WinPython 发行工具集,含 WPPM |
可以看到,dot 版除了四个升级包,还固定携带 sqlite_bro(SQLite 图形客户端)与 wheel(构建产物格式支持)。这与仓库中 dot_requirements.txt 的内容高度一致——该文件正是 dot flavor 的包需求清单:
# the essential
sqlite_bro
setuptools
wheel
build
##msvc_runtime
# end of requirements.txt
五、源码级佐证:dot flavor 的构建机制
5.1 winpython_builds.toml 中的 flavor 定义
当前仓库的构建配置中,dot flavor 的定义为:
[flavors.dot]
requirements = "dot_requirements.txt"
source_dirs = "packages.win-amd64"
toolsdirs = "bdTools\\Tools.dot"
三个键的含义:
requirements:指向该 flavor 的包需求清单,即 dot_requirements.txt;source_dirs:从哪个 wheel 源目录挑选预编译包(64 位平台为packages.win-amd64);toolsdirs:附带工具目录指向bdTools\Tools.dot——注意这与 slim 版指向的bdTools\tools64_pandoc_alone不同,从结构上印证了 dot 版工具链是独立维护的最小集合。
配套的 mandatory_requirements.txt 定义了所有 flavor 都必须携带的"底线包":
# the mandatory
pip
setuptools
#not Wheel
wppm
这解释了清单中 pip、setuptools、winpython(wppm)为何是"硬性标配",而 dot_requirements.txt 再补充 sqlite_bro、wheel、build,两者叠加即得到上一节的完整清单。
5.2 构建命令入口
仓库根目录的 generate_a_winpython_distropy_meta.bat 是经典构建入口,它调用 build_winpython_meta.py,并把参数原样透传。以 winpython_builds.toml 头部注释中的用法为参考:
generate_a_winpython_distropy_meta.bat winpython_builds.toml 315:slim
generate_a_winpython_distropy_meta.bat winpython_builds.toml 315
generate_a_winpython_distropy_meta.bat winpython_builds.toml
... --dry-run :: 只打印构建命令而不真正执行
其中 315:slim 这种写法即"Python 版本号 + 冒号 + flavor 名"的二元组,等价于 315:dot 时就会走 [flavors.dot] 的配置路径。历史版本 3.8.3.0dot 的构建原理与此一致(当前 [pythons.*] 段落仅保留 3.13–3.15,3.8 已不在活跃构建列表,但 flavor 定义机制是共用的)。
5.3 版本约束机制
仓库根目录的 constraints.txt 记录了各包的版本下限约束,其文件头注释展示了团队维护它的工作流:先对"上次可用的安装"执行 python -m pip freeze > constraints_new.txt,再整理为 >= 约束,之后用 pip install -c constraints.txt --find-links=... 复现环境。这种"冻结-约束-复现"的循环,正是 WinPython 各发行版版本可追溯、可重放的原因——3.8.3.0dot 中每个包的确切版本也因此能在 changelogs/ 的清单与历史文件里精确落档。
六、安装、校验与管理实践
6.1 获取发行版与哈希校验
WinPython 发行版以自解压 exe(-dot、-dotrc 等命名后缀)或 zip 形式分发。仓库的 changelogs/md5_sha1.txt 保存了各版本的 MD5 / SHA1 / SHA256 三重哈希,例如其中记录的 Winpython64-3.8.3.0dotrc.exe(约 24 MB,rc 候选版)与 Winpython64-3.8.3.0.exe(完整版)等条目,每行格式为:
MD5 | SHA1 | SHA256 | 文件名 | 大小
下载后可用仓库中的 hash_launch.bat 复现校验流程(该脚本调用 winpython.hash 模块的 print_hashes 打印所给文件的哈希并写入日期命名的计数文件)。比对官方记录与本地计算的哈希,即可确认文件完整性。
6.2 用 pip 与 WPPM 管理环境
安装完成后:
- 日常装包:使用
pip增删包(WinPython 官方推荐方式,见 README.rst); - 浏览与注册:使用 WPPM——它可以浏览随发行版提供的 Wheelhouse 包、安装其中的包,或将 WinPython 注册到系统。WPPM 的命令行入口即 wppm/wppm.py 中的
main(),核心数据结构为Package(单个包)与Distribution(整个发行版)两个类; - 环境复现:参考 constraints.txt 头部注释的流程,用
pip freeze导出当前环境,再配合-c constraints与--find-links在干净的 WinPython 上重建同样的包集合。
七、结语
从 3.8.2.0dot 到 3.8.3.0dot,一次只升级 4 个包,这是 dot 发行版刻意保持的克制:解释器(Python 3.8.3)+ 安装链(pip 20.1、setuptools 46.4.0)+ 发行工具(winpython 2.4.20200425),外加固定的 sqlite_bro 与 wheel 底座。结合 winpython_builds.toml 的 [flavors.dot] 定义、dot_requirements.txt 的需求清单与 mandatory_requirements.txt 的底线包,可以清晰还原这一极简发行版的构建逻辑;而 changelogs/md5_sha1.txt 与 wppm/ 则提供了从"校验"到"管理"的完整落地工具链。如果你需要一个干净、可完全自定义的 Windows Python 基线,dot 版正是从这份变更记录中能看到的最小而完整的起点。