WinPython-64bit 3.9.4.0 变更全解析:从 3.9.2.0 到 3.9.4.0 的包演进与变更日志生成机制
WinPython-64bit 3.9.4.0 变更全解析:从 3.9.2.0 到 3.9.4.0 的包演进与变更日志生成机制
WinPython-64bit 3.9.4.0 是 WinPython 面向 Windows 平台的便携式 Python 3.9 发行版中的一次重要增量发布,其官方变更记录位于 changelogs/WinPython-64bit-3.9.4.0_History.md。本文以该 History 文档为主体,逐条解读本次发行相对上一版本 3.9.2.0 的新增、升级与移除包清单,并深入当前仓库中负责生成这份变更日志的源码实现(wppm/diff.py、winpython/build_winpython.py 等),帮助你理解"这类 History 文档从何而来、如何阅读、如何自行复现对比"。读完本文,你将能准确解读任何一份 WinPython 版本变更记录,并掌握用仓库工具自行比较任意两个包索引的方法。
一、版本背景:3.9.4.0 是什么
WinPython 的版本号由三部分拼接而成:Python 小版本(winpyver2)、构建序号与发行口味(flavor)。从 winpython/build_winpython.py 的 Step 7 可以看到,变更日志文件名由 changelog_version = f"{winpyver2}{args.release_level}" 拼出,即 WinPython{flavor}-{arch}bit-{changelog_version}.md 与对应的 _History.md。因此 3.9.4.0 = Python 3.9.4 + 构建序号 0,而 3.9.2.0 是它之前最近一次已发布的 64 位版本。
值得注意的是,从 changelogs 目录的文件清单可以确认,WinPython 并未为 Python 3.9.3 发布对应构建,版本序列直接从 3.9.2.0 跳到 3.9.4.0,因此本份 History 的开头写的是 "The following changes were made ... since version 3.9.2.0"。此外,changelogs/md5_sha1.txt 记录了该版本的下载物校验信息:Winpython64-3.9.4.0.exe(约 765 MB)为主构建,另有 dot、cod 口味以及 32 位 dot 构建,说明同一 Python 版本会按口味(flavor)产出多份发行包。
二、History 与包索引的关系:先读懂两份文档
仓库中与 3.9.4.0 相关的文档共有两份,职责完全不同:
- changelogs/WinPython-64bit-3.9.4.0.md:完整的包索引(package index),列出该发行版当前包含的全部 Tools 与 Python 包(含版本号与简介),由
wppm的Distribution().generate_package_index_markdown()(见 wppm/wppm.py)生成,分为### Tools、### Python packages、### WheelHouse packages三个区块; - changelogs/WinPython-64bit-3.9.4.0_History.md:变更日志(History),只记录相对上一版本的差异,即新增(New)、升级(Upgraded)、移除(Removed)三类。
以 Tools 为例:History 中只记录了 Nodejs v14.16.0 → v14.16.1 与 npmjs 6.14.11 → 6.14.12 两项升级,但完整包索引显示该发行版还包含未发生变化的 Pandoc 2.3。阅读 History 时如需"该版本到底有什么",必须回查配套的包索引文档——这正是 diff 生成逻辑"只输出变化、不重复未变项"的设计结果。
三、Tools 升级:Node.js 与 npm 的维护性更新
本次发行对捆绑的运行时工具做了小幅升级:
| 工具 | 版本变化 | 简介(文档原文) |
|---|---|---|
| Nodejs | v14.16.0 → v14.16.1 | a JavaScript runtime built on Chrome's V8 JavaScript engine |
| npmjs | 6.14.11 → 6.14.12 | a package manager for JavaScript |
两者均为同一小版本内的维护性升级,不涉及架构性变化,属于 WinPython 持续跟随上游安全修复与缺陷修复的常规动作。
四、Python 包新增:25 个新成员入库
本次发行一次性新增 25 个 Python 包,覆盖工程脚手架、Git 协作、Jupyter 生态、凸优化求解、配置序列化等方向:
| 包名 | 版本 | 用途定位(文档简介) |
|---|---|---|
| arrow | 1.0.3 | Better dates & times for Python(日期时间处理) |
| binaryornot | 0.4.4 | 判断文件是二进制还是文本的轻量纯 Python 包 |
| cookiecutter | 1.7.2 | 从项目模板创建项目的命令行工具(脚手架) |
| deprecation | 2.1.0 | 处理自动化弃用标记的库 |
| flit | 3.2.0 | 面向简单包的极简打包工具 |
| flit_core | 3.2.0 | Flit 的构建分发核心组件 |
| gitdb | 4.0.7 | Git 对象数据库 |
| gitpython | 3.1.14 | Python Git 库 |
| inflection | 0.5.1 | Ruby on Rails inflector 的 Python 移植(单复数/驼峰转换) |
| jinja2_time | 0.2.0 | Jinja2 日期时间扩展 |
| jupyter_server_mathjax | 0.2.2 | 以 Jupyter Server 扩展形式提供的 MathJax 资源 |
| jupyterlab_git | 0.30.0 | JupyterLab 的 Git 扩展对应的服务端扩展 |
| nbdime | 3.0.0 | Jupyter Notebook 的差异与合并工具 |
| poyo | 0.5.0 | 轻量 YAML 解析器 |
| python_slugify | 4.0.1 | 支持 Unicode 的 Slugify 应用 |
| qdldl | 0.1.5.post0 | 免费的 LDL 分解例程 QDLDL |
| qpsolvers | 1.6.1 | 统一 API 的二次规划求解器集合 |
| qstylizer | 0.1.10 | 为 PyQt4/5、PySide1/2 生成样式表的工具 |
| quadprog | 0.1.8 | 二次规划求解器 |
| ruamel.yaml.clib | 0.2.2 | ruamel.yaml 基于 libyaml 的 C 语言读写解析实现 |
| smmap | 4.0.0 | 滑动窗口内存映射管理器(纯 Python 实现) |
| text_unidecode | 1.3 | 最基础的 Text::Unidecode 移植 |
| tinycss | 0.4 | 完整而简单的 CSS 解析器 |
| tomlkit | 0.7.0 | 保留样式的 TOML 库 |
| voila_gridstack | 0.2.0 | Voila 的 GridStack 模板 |
这些新增包并非孤立存在,而是围绕三条主线补齐生态:
- 工程化与打包:
cookiecutter+flit/flit_core+poyo+jinja2_time构成了"从模板生成项目 → 解析模板配置 → 用 Flit 打包发布"的完整链路,与仓库自身的构建方式一脉相承——README.rst 中 WPPM 的构建正是通过python -m flit build完成的; - Git 协作与 Notebook 工作流:
gitpython/gitdb/smmap是完整的 Git 操作栈,jupyterlab_git将其接入 JupyterLab,nbdime则解决 Notebook 的 diff/merge 难题; - 凸优化求解:
qpsolvers提供统一 API 统一调度多个求解器,quadprog与qdldl分别是其中一员和底层分解例程,与本次同步升级的cvxpy、osqp、scs呼应,构成完整的最优化工具箱。
五、Python 包升级:121 项全面更新
本次升级了 121 个 Python 包(含解释器本身),覆盖科学计算、深度学习、可视化、Jupyter、Web、地理空间等全部主力技术栈。以下按主题分组完整列出。
5.1 解释器与核心科学计算栈
| 包名 | 版本变化 | 说明 |
|---|---|---|
| Python | 3.9.2 → 3.9.4 | 解释器本身,含标准库 |
| numpy | 1.20.1+mkl → 1.20.2+mkl | 数组计算基础库(MKL 加速版) |
| scipy | 1.6.1 → 1.6.2 | 科学计算库 |
| pandas | 1.2.3 → 1.2.4 | 数据分析与时间序列 |
| matplotlib | 3.3.4 → 3.4.1 | Python 绘图包(跨小版本升级) |
| sympy | 1.7.1 → 1.8 | 计算机代数系统 |
| astropy | 4.2 → 4.2.1 | 社区驱动的天文学工具 |
| numba | 0.53.0rc3 → 0.53.1 | 基于 LLVM 的 Python 编译 |
| llvmlite | 0.36.0rc2 → 0.36.0 | LLVM 基础功能轻量封装(rc 转正式版) |
| networkx | 2.5 → 2.5.1 | 图与网络构建分析 |
| asteval | 0.9.22 → 0.9.23 | 基于 ast 的安全最小化表达式求值器 |
| pint | 0.16.1 → 0.17 | 物理量单位模块 |
| cython | 0.29.22 → 0.29.23 | C 扩展编译器 |
| dask | 2021.3.0 → 2021.4.0 | 并行 PyData 任务调度 |
| distributed | 2021.3.0 → 2021.4.0 | Dask 分布式调度器 |
| partd | 1.1.0 → 1.2.0 | 可追加键值存储 |
| zarr | 2.6.1 → 2.7.1 | 分块压缩 N 维数组 |
5.2 机器学习与深度学习
| 包名 | 版本变化 | 说明 |
|---|---|---|
| torch | 1.8.0+cpu → 1.8.1+cpu | PyTorch(CPU 版,含 GPU 加速能力) |
| torchvision | 0.9.0+cpu → 0.9.1+cpu | 图像数据集与模型 |
| torchaudio | 0.8.0 → 0.8.1 | PyTorch 音频包 |
| botorch | 0.3.2 → 0.4.0 | 基于 PyTorch 的贝叶斯优化 |
| gpytorch | 1.2.1 → 1.4.0 | PyTorch 高斯过程实现 |
| shap | 0.36.0 → 0.39.0 | 机器学习模型解释统一方法 |
| nltk | 3.5 → 3.6.1 | 自然语言工具包 |
5.3 凸优化求解
| 包名 | 版本变化 | 说明 |
|---|---|---|
| cvxpy | 1.1.10 → 1.1.12 | 凸优化建模 DSL |
| osqp | 0.6.1 → 0.6.2.post0 | 算子分裂 QP 求解器 |
| scs | 2.1.2 → 2.1.3 | 分裂锥求解器 |
5.4 数据可视化与 GUI
| 包名 | 版本变化 | 说明 |
|---|---|---|
| bokeh | 2.3.0 → 2.3.1 | 浏览器端交互绘图 |
| bqplot | 0.12.23 → 0.12.25 | Jupyter 交互绘图(d3.js + ipywidgets) |
| datashader | 0.12.0 → 0.12.1 | 基于栅格聚合的可视化工具链 |
| geoviews | 1.8.1 → 1.9.1 | 地理/气象/海洋数据可视化 |
| holoviews | 1.14.2 → 1.14.3 | 标注式数据可视化 |
| mizani | 0.7.2 → 0.7.3 | Scales for Python(刻度系统) |
| plotnine | 0.7.1 → 0.8.0 | 图形语法(grammar of graphics) |
| panel | 0.11.0 → 0.11.3 | 高层应用与仪表盘方案 |
| pydeck | 0.6.1 → 0.6.2 | deck.gl 地图 widget |
| voila | 0.2.7 → 0.2.9 | 以只读活 Notebook 形式提供服务 |
| pyqtgraph | 0.11.1 → 0.12.1 | 科学绘图与 GUI 库(跨小版本升级) |
| pythonqwt | 0.8.3 → 0.9.0 | Python Qt 绘图组件(跨小版本升级) |
| guiqwt | 3.0.5 → 3.0.6 | 曲线与图像绘图工具集 |
| qdarkstyle | 2.8.1 → 3.0.2 | Qt 应用深色样式表(跨小版本升级) |
5.5 地理空间
| 包名 | 版本变化 | 说明 |
|---|---|---|
| fiona | 1.8.18 → 1.8.19 | 空间数据文件读写 |
| gdal | 3.2.1 → 3.2.2 | 地理空间数据抽象库 |
| geopandas | 0.8.2 → 0.9.0 | 地理 pandas 扩展(跨小版本升级) |
| rasterio | 1.2.1 → 1.2.3 | 快速栅格 I/O |
| tifffile | 2021.3.5 → 2021.4.8 | TIFF 文件读写 |
5.6 Jupyter 生态
| 包名 | 版本变化 | 说明 |
|---|---|---|
| ipython | 7.21.0 → 7.22.0 | 交互式计算内核 |
| ipykernel | 5.5.0 → 5.5.3 | Jupyter IPython 内核 |
| ipympl | 0.6.3 → 0.7.0 | Matplotlib Jupyter 扩展 |
| jupyter_client | 6.1.11 → 6.2.0 | Jupyter 协议实现与客户端库 |
| jupyter_console | 6.2.0 → 6.4.0 | Jupyter 终端控制台 |
| jupyter_packaging | 0.7.12 → 0.9.1 | Jupyter 打包工具 |
| jupyter_server | 1.4.1 → 1.6.2 | Jupyter Server |
| jupyter_server_proxy | 1.6.0 → 3.0.2 | 代理 Web 服务的服务器扩展(跨大版本升级) |
| jupyterlab | 3.0.9 → 3.0.14 | JupyterLab 笔记本服务器扩展 |
| jupyterlab_lsp | 3.4.1 → 3.5.0 | JupyterLab 语言服务器协议集成 |
| jupyterlab_server | 2.3.0 → 2.4.0 | JupyterLab Server |
| jupyter_bokeh | 2.0.4 → 3.0.0 | 渲染 Bokeh 内容的 Jupyter 扩展(跨大版本升级) |
| nbclassic | 0.2.6 → 0.2.7 | 作为 Jupyter Server 扩展的经典 Notebook |
| nbformat | 5.1.2 → 5.1.3 | Notebook 格式 |
| notebook | 6.2.0 → 6.3.0 | 基于 Web 的交互计算环境 |
| papermill | 2.3.2 → 2.3.3 | Notebook 参数化与批处理执行 |
| qtconsole | 5.0.2 → 5.0.3 | Jupyter Qt 控制台 |
| terminado | 0.9.2 → 0.9.3 | 基于 Tornado WebSocket 的终端服务 |
5.7 IDE 与代码质量工具
| 包名 | 版本变化 | 说明 |
|---|---|---|
| spyder | 4.2.3 → 5.0.1 | 科学 Python 开发环境(跨大版本升级) |
| spyder_kernels | 1.10.2 → 2.0.1 | Spyder 控制台内核(跨大版本升级) |
| astroid | 2.5 → 2.5.3 | 带推理支持的抽象语法树 |
| pylint | 2.7.1 → 2.7.4 | Python 静态检查器 |
| isort | 5.7.0 → 5.8.0 | import 排序工具 |
| yapf | 0.30.0 → 0.31.0 | Python 格式化器 |
| pydocstyle | 5.1.1 → 6.0.0 | 文档字符串风格检查器(跨大版本升级) |
| pygments | 2.8.0 → 2.8.1 | 语法高亮包 |
| coverage | 5.4 → 5.5 | 代码覆盖率测量 |
| pytest | 6.2.2 → 6.2.3 | 测试框架 |
| hypothesis | 6.1.1 → 6.9.2 | 属性驱动测试库 |
| ptpython | 3.0.16 → 3.0.17 | 基于 prompt_toolkit 的 REPL |
| prompt_toolkit | 3.0.16 → 3.0.18 | 交互式命令行构建库 |
| sphinx | 3.5.1 → 3.5.4 | 文档生成工具(reStructuredText) |
| prettytable | 2.0.0 → 2.1.0 | ASCII 表格显示库 |
| tqdm | 4.58.0 → 4.59.0 | 进度条 |
5.8 Web、异步与网络
| 包名 | 版本变化 | 说明 |
|---|---|---|
| aiohttp | 3.7.3 → 3.7.4.post0 | 异步 HTTP 客户端/服务端框架 |
| asgiref | 3.3.1 → 3.3.4 | ASGI 规范与辅助代码 |
| flask_accepts | 0.17.6 → 0.17.7 | Flask 输入/输出处理 |
| flask_restx | 0.2.0 → 0.3.0 | Flask 快速 API 开发框架 |
| flask_sqlalchemy | 2.4.4 → 2.5.1 | Flask + SQLAlchemy 集成 |
| httpx | 0.16.1 → 0.17.1 | 下一代 HTTP 客户端 |
| urllib3 | 1.26.3 → 1.26.4 | 线程安全连接池 HTTP 库 |
| aniso8601 | 8.1.1 → 9.0.1 | ISO 8601 字符串解析 |
| tenacity | 6.3.1 → 7.0.0 | 重试工具库(跨大版本升级) |
| prometheus_client | 0.9.0 → 0.10.1 | Prometheus 监控客户端 |
| chardet | 3.0.4 → 4.0.0 | 通用编码探测器(跨大版本升级) |
| defusedxml | 0.6.0 → 0.7.1 | 标准库 XML 模块的 XML 炸弹防护 |
| soupsieve | 2.2 → 2.2.1 | Beautiful Soup 的 CSS 选择器实现 |
| jsonpatch | 1.28 → 1.32 | 应用 JSON-Patch(RFC 6902) |
| jsonpointer | 2.0 → 2.1 | 定位 JSON 文档节点(RFC 6901) |
| python_dotenv | 0.15.0 → 0.17.0 | .env 文件支持 |
5.9 数据存取与文件处理
| 包名 | 版本变化 | 说明 |
|---|---|---|
| openpyxl | 3.0.6 → 3.0.7 | Excel 2010 xlsx/xlsm 读写 |
| pillow | 8.1.2 → 8.2.0 | Python 图像处理库 |
| xlsxwriter | 1.3.7 → 1.3.9 | 创建 Excel XLSX 文件 |
| xlwings | 0.22.2 → 0.23.0 | Python 与 Excel 双向交互 |
| reportlab | 3.5.60 → 3.5.67 | ReportLab 工具包 |
| fs | 2.4.12 → 2.4.13 | 文件系统抽象层 |
| importlib_metadata | 3.7.0 → 3.10.1 | 读取 Python 包元数据 |
| zipp | 3.4.0 → 3.4.1 | pathlib 兼容的 zip 文件包装 |
| lxml | 4.6.2 → 4.6.3 | libxml2/libxslt 与 ElementTree API 结合 |
| sqlalchemy | 1.3.23 → 1.4.8 | 数据库抽象库(跨大版本升级) |
| intake | 0.6.1 → 0.6.2 | 数据加载与目录系统 |
| datasette | 0.55 → 0.56 | 数据探索与发布工具 |
| regex | 2020.11.13 → 2021.4.4 | 替代 re 的正则模块 |
| typed_ast | 1.4.2 → 1.4.3 | 带类型注释支持的 ast 分支 |
| lazy_object_proxy | 1.5.2 → 1.6.0 | 快速惰性对象代理 |
5.10 包管理、发布与安全
| 包名 | 版本变化 | 说明 |
|---|---|---|
| pip | 21.0.1 → 21.1.dev0 | PyPA 推荐的安装工具 |
| setuptools | 54.1.0 → 56.0.0 | 下载/构建/安装/升级/卸载包 |
| twine | 3.3.0 → 3.4.1 | PyPI 发布工具集 |
| virtualenv | 20.4.2 → 20.4.3 | 虚拟环境构建器 |
| keyring | 23.0.0 → 23.0.1 | 密码安全存储 |
| cryptography | 3.4.6 → 3.4.7 | 密码学原语与配方 |
| pyinstaller_hooks_contrib | 2020.11 → 2021.1 | PyInstaller 社区维护 hooks |
| winpython | 4.0.20210307 → 4.1.20210417 | WinPython 发行工具(含 WPPM) |
| deprecated | 1.2.11 → 1.2.12 | @deprecated 装饰器 |
5.11 底层序列化依赖
| 包名 | 版本变化 | 说明 |
|---|---|---|
| ruamel.yaml | 0.16.12 → 0.17.4 | 保留注释/风格/键序的 YAML 解析器(跨小版本升级) |
5.12 升级要点解读
在 121 项升级中,以下几处值得特别关注:
- 解释器跃升:Python 3.9.2 → 3.9.4 直接决定整份发行版的运行时基线;
- IDE 大版本换代:Spyder 4.2.3 → 5.0.1 与 spyder_kernels 1.10.2 → 2.0.1 同步跨大版本,意味着 WinPython 随本次发布切换到了 Spyder 5 代内核协议;
- 核心科学栈小步快跑:matplotlib 3.3.4 → 3.4.1 跨入 3.4 系列、sqlalchemy 1.3.23 → 1.4.8 跨入 1.4 系列、torch 系列 1.8.0 → 1.8.1(CPU 构建)、numba/llvmlite 从 rc 版本转为正式版(0.53.0rc3 → 0.53.1、0.36.0rc2 → 0.36.0),说明本次发行有意收编上游候选版本转正后的稳定组合;
- Jupyter 服务端重构推进:jupyterlab 3.0.9 → 3.0.14、jupyter_server 1.4.1 → 1.6.2、notebook 6.2.0 → 6.3.0 同步跟进 Jupyter 向
jupyter_server统一架构迁移的节奏; - MKL 绑定:numpy 保持
+mkl后缀(1.20.1+mkl → 1.20.2+mkl),表明该发行版面向科学计算,数值核心采用 Intel MKL 加速。
六、Python 包移除:2 个包退场
| 包名 | 版本 | 原简介 |
|---|---|---|
| helpdev | 0.7.1 | 快速提取 Python 环境信息 |
| jdcal | 1.4.1 | 儒略日与格里高利历换算 |
helpdev 被移除后,其环境信息提取能力可由 WinPython 自带的 pip list、python -c "import sys; print(sys.version)" 等原生手段覆盖;jdcal 的日期换算功能在 Python 3.9 标准库中已有等价能力。从 wppm/diff.py 的移除判定逻辑(old 中存在而 new 中不存在的包即标记为 Removed)看,这两个包被移出 3.9.4.0 的包索引,即不再随发行版分发。
七、源码级揭秘:这份 History 文档是如何生成的
这类 _History.md 并不是手工维护的,而是 WinPython 构建流水线 Step 7 的自动化产物。整条链路在 winpython/build_winpython.py 中实现:
- 先调用
wppm.Distribution().generate_package_index_markdown()生成当前版本的完整包索引(写入WinPython-64bit-3.9.4.0.md,并复制进changelogs/目录); - 再调用
wppm.diff.compare_package_indexes('3.9.4.0', searchdir=changelogs目录, flavor='', architecture=64)生成_History.md,输出到构建目录。
关键算法位于 wppm/diff.py,值得展开:
- 版本发现(L129-L151):
changelog_versions()用正则WinPython{flavor}-{architecture}bit-(.+)\.(?:txt|md)$扫描changelogs/目录,把文件名中的版本交给 PEP 440 解析器(packaging.version.parse),无法解析为版本的文件(包括_History同伴)被自动丢弃——这也是为何目录里既有WinPython-64bit-3.9.4.0.md又有..._History.md却不会相互干扰; - 上一版本选择(L153-L160):
find_previous_version()取"解析后小于目标版本的最大版本",因此 History 标题中的 "since version 3.9.2.0" 是自动计算出来的; - 行解析(L21-L36):
Package类通过正则\[([\w\-\:\/\.\_]+)\]\(([^)]+)\) \| ([^\|]*) \| ([^\|]*)解析包索引中的name | version | description行,这也是为什么包索引必须保持严格的 Markdown 表格行格式; - 差异分类(L61-L74):
compare_packages()以包名(归一化为-连字符小写形式)为键做集合差:新键 → New、键同版本不同 → Upgraded(输出旧版本 → 新版本)、旧键消失 → Removed,三个区块依次拼装为最终文档,并以* * *收尾。
也就是说,只要 changelogs/ 目录里躺着各版本的完整包索引,任何人都能用仓库自带工具复现任意两版之间的 History。README 的构建说明也印证了这一点:generate_a_winpython_distropy_meta.bat winpython_builds.toml 以 winpython_builds.toml 为配置驱动整条构建(该文件定义了 dot、slim 等 flavor 与各 Python 小版本的构建矩阵)。
八、实战:如何自行对比包索引、判断更新价值
8.1 用 wppm -diff 手动对比任意两版
除构建流程外,wppm/diff.py 还提供独立命令行入口,可直接比较任意两个包索引文件或任意两个版本:
# 比较两个包索引文件(全部区块)
wppm -diff WinPython-64bit-3.9.2.0.md WinPython-64bit-3.9.4.0.md
# 或
python -m wppm.diff WinPython-64bit-3.9.2.0.md WinPython-64bit-3.9.4.0.md
# 只比较某一区块(如 python)
python -m wppm.diff file1.md file2.md --section python python
# 按版本号从 changelogs 目录比较(自动找上一版本)
python -m wppm.diff 3.9.4.0 3.9.2.0
# 把对比结果写回 changelogs 目录
python -m wppm.diff --write-changelog 3.9.4.0 3.9.2.0
注意 wppm/diff.py 对 Windows 控制台默认编码(cp1252)做了处理:因为每个升级行都带 → 箭头,脚本入口会先对 sys.stdout 执行 reconfigure(encoding="utf-8"),避免"升级箭头直接触发 UnicodeEncodeError"。
8.2 用 check_updates.py 判断"哪些更新值得跟进"
如果关心的是"发行版里某个包是否该升级",仓库根目录的 check_updates.py 给出了自动化答案。其 docstring(L1-L33)把候选更新分为五类:
- security:当前版本存在安全公告,无条件提示,且给出"首个自身无公告"的版本(会向前探测最多 24 个发布以跳过仍带公告的版本);
- ready:存在更新、已稳定等待超过
--min-days天、未被 yank、有对应解释器 wheel 且依赖圈不设上限,值得采纳; - blocked:依赖集内的某个包要求排除了该新版本;
- needs:没有依赖禁止它,但 wheelhouse 缺少它需要的依赖,本地构建会静默回溯到旧版;
- too new:存在更新但"资历"不足,附等待天数。
典型用法:
python check_updates.py # 检查最新 3.14 slim lockfile
python check_updates.py --lock <pylock.toml> --target cp314 --min-days 21
该脚本只依赖 PyPI 的公开 JSON API(无需密钥),体现了 WinPython 维护者"以安全公告与版本成熟度双重门槛决定是否收编新包"的更新策略——这与 3.9.4.0 中 numpy/scipy 等只做小版本跟进、Spyder/JupyterLab 随上游大版本切换的做法一脉相承。
九、总结
WinPython-64bit 3.9.4.0 是一次典型的"稳中求进"发行:解释器升至 Python 3.9.4,25 个新包补齐工程脚手架、Git 协作、凸优化与 Jupyter 扩展能力,121 个包完成版本跟进(其中 Spyder 5.0.1、SQLAlchemy 1.4.8 等为跨大版本升级),并移除了 2 个可由标准库替代的包。更重要的是,这份 History 文档本身由仓库中的 wppm.diff 工具自动生成——理解了 wppm/diff.py 的版本发现、上一版本选择与差异分类算法,你就掌握了阅读任何一版 WinPython 变更记录的方法论,也能用 wppm -diff 与 check_updates.py 自行评估后续升级路径。如需查看 3.9.4.0 之后的变化,可继续阅读下一版记录 WinPython-64bit 3.9.5.0 变更日志。