WinPython-64bit 3.8.12.3PyPy 变更日志全解析:包清单、升级明细与 changelog 生成机制

原创2026-10-15 09:45:061,422 阅读
文章标签:包管理器开发工具CLI构建工具

WinPython-64bit 3.8.12.3PyPy 变更日志全解析:包清单、升级明细与 changelog 生成机制

本篇文章以仓库 changelogs/WinPythonPyPy-64bit-3.8.12.3_History.md 为核心,逐条解读 WinPython-64bit PyPy flavor 从 3.8.12.2PyPy 到 3.8.12.3PyPy 的全部变更:包括工具链升级、7 个新引入的 Python 包、136 个升级包与 4 个移除包,并结合仓库中 wppm/diff.py、winpython/build_winpython.py 等源码,讲清楚这份 _History.md 究竟是怎样被自动生成出来的,以及读者如何用 wppm -diff 自行重放与验证版本对比。

一、这份文档是什么:WinPython 发行版的“版本差异报告”

WinPython 是一个面向 Windows 平台的自由 Python 发行版(项目仓库 README.rst 将本仓库定位为 wppm 包与构建工具链仓库)。在 changelogs/ 目录下,每个发行版本都有两类 Markdown 文件:

  • 包索引(如 changelogs/WinPythonPyPy-64bit-3.8.12.3.md):列出该版本当前完整包含的 Tools 与 Python 包及其版本;
  • 历史变更(如本文对应的 WinPythonPyPy-64bit-3.8.12.3_History.md):以“自上一版本以来发生了什么变化”为视角,仅列出 New / Upgraded / Removed 三个类别的差异。

3.8.12.3PyPy 表明这是一个 64 位、面向 PyPy 运行时的 flavor,其包索引中声明的 Python 解释器版本为 3.8.12(见 changelogs/WinPythonPyPy-64bit-3.8.12.3.md)。整个 PyPy 系列在 changelogs/ 中还有 3.7.10.0、3.7.12.0、3.8.12.2 等多个历史版本,3.8.12.3 是该系列的后续维护版本。

本版变更的对比基准是上一版 3.8.12.2PyPy,其对应的历史文件为 changelogs/WinPythonPyPy-64bit-3.8.12.2_History.md。对比结果按原文档结构分为两大块:### Tools(独立工具链)与 ### Python packages(Python 包的新增 / 升级 / 移除)。

二、工具链(Tools)变更:Node.js 与 npm 的例行升级

本版本对随发行版附带的独立工具仅做了两项升级,属于典型的“跟随上游小版本”式更新:

工具 版本变化 说明
Nodejs v16.14.2 → v16.16.0 基于 Chrome V8 引擎的 JavaScript 运行时
npmjs 8.5.0 → 8.11.0 JavaScript 包管理器

这两项变更均未涉及大版本跳跃,主要收益是安全修复与稳定性提升。对于在 WinPython 中同时使用 Jupyter 生态、前端工具链或 Node 驱动的扩展(如 jupyterlab 前端构建)的用户,升级后的 npm 8.11.0 与 Node v16.16.0 配合更佳。

三、新增包(New packages):7 个新成员与其真实用途

本版一次性引入 7 个新包,它们并非彼此孤立,而是分别服务于几条清晰的技术主线:

包名 版本 官方描述
argon2_cffi_bindings 21.2.0 面向 Argon2 的低层 CFFI 绑定
asttokens 2.0.5 为 AST 树标注源码位置
executing 0.8.3 获取当前正在执行的 AST 节点等信息
pure_eval 0.2.2 无副作用地安全求值 AST 节点
pytoolconfig 1.2.1 (配置工具,供 rope 使用)
stack_data 0.3.0 从 Python 栈帧与 traceback 中提取数据用于信息展示
xyzservices 2022.6.0 XYZ 瓦片服务提供商源数据

从功能描述上可以梳理出三条主线:

  1. IPython 8 的 traceback 增强栈:asttokens、executing、pure_eval、stack_data 这四个包是 IPython 8 系列“超信息 traceback(ultratb)”的底层依赖——stack_data 负责从栈帧与回溯中提取结构化数据,executing 定位当前执行节点,pure_eval 与 asttokens 则用于安全地还原表达式求值结果。它们的引入与本版将 ipython 从 7.32.0 升级到 8.4.0 直接配套。

  2. Argon2 密码哈希的完整依赖链:argon2_cffi_bindings 21.2.0 与升级后的 argon2_cffi 21.1.0 → 21.3.0 一一对应——前者是后者的低层 CFFI 绑定,即 Jupyter Notebook 登录鉴权所依赖的密码哈希组件。

  3. 编辑与配置工具:pytoolconfig 1.2.1 是重构库 rope 升级到 1.2.0 后所需的配置解析层;xyzservices 2022.6.0 则为 folium/rasterio 等 GIS 可视化生态提供瓦片服务商清单(本版同步升级了 ipyleaflet 0.14.0 → 0.17.0、cartopy 0.20.2、gdal 3.4.3 等地理空间组件)。

四、升级包全景(Upgraded packages):136 个包的完整清单

原文档按字母序列出了全部升级项。为保证信息完整可检索,以下按字母段拆分为三张表,版本列均采用原文档的“旧版 → 新版”格式:

4.1 A–H 段(43 个)

包名 版本变化 说明
alembic 1.7.7 → 1.8.0 SQLAlchemy 数据库迁移工具
anyio 3.5.0 → 3.6.1 多异步事件循环兼容层
argon2_cffi 21.1.0 → 21.3.0 Argon2 安全密码哈希算法
asgiref 3.5.0 → 3.5.2 ASGI 规范与适配器
asteval 0.9.26 → 0.9.27 基于 ast 的安全极简表达式求值器
astroid 2.11.3 → 2.11.5 带推断支持的 Python 抽象语法树
babel 2.10.1 → 2.10.3 国际化工具
black 22.3.0 → 22.6.0 不妥协的代码格式化器
blis 0.7.7 → 0.9.0 自包含 C 扩展的 Blis BLAS 线性代数库
bokeh 2.4.2 → 2.4.3 浏览器端交互式绘图
cachetools 5.0.0 → 5.2.0 可扩展缓存集合与装饰器
certifi 2021.10.8 → 2022.5.18.1 Mozilla CA 证书包
cloudpickle 2.0.0 → 2.1.0 Python 对象扩展序列化支持
cookiecutter 1.7.3 → 2.1.1 从项目模板创建项目的 CLI 工具
coverage 6.3.2 → 6.4.1 Python 代码覆盖率测量
cython 0.29.28 → 0.29.30 Cython 编译器
dash 2.3.0 → 2.4.1 Plotly 开发的响应式 Web 应用框架
dask 2022.4.2 → 2022.7.0 带任务调度的并行 PyData
datasette_graphql 2.0.1 → 2.0.2 为 SQLite 数据库自动生成 GraphQL API 的插件
debugpy 1.6.0 → 1.6.2 Debug Adapter Protocol 的 Python 实现
dill 0.3.3 → 0.3.5 序列化整个 Python 对象
distributed 2022.4.2 → 2022.7.0 Dask 分布式调度器
emcee 3.1.1 → 3.1.2 MCMC 集成采样工具包
fast_histogram 0.10 → 0.11 快速一维/二维直方图
fastapi 0.75.2 → 0.78.0 高性能易上手的生产级 Web 框架
fastcore 1.3.27 → 1.4.5 为 fastai 开发增强的 Python
fastdownload 0.0.5 → 0.0.7 通用数据下载库
fastprogress 1.0.0 → 1.0.2 带绘图选项的嵌套进度条
filelock 3.6.0 → 3.7.1 跨平台文件锁
fonttools 4.31.2 → 4.34.4 字体文件操作工具
fsspec 2022.3.0 → 2022.5.0 文件系统规范抽象
gdal 3.4.2 → 3.4.3 GDAL 地理空间数据抽象库
graphene 3.0 → 3.1 Python GraphQL 框架
graphql_core 3.1.7 → 3.2.1 GraphQL.js 的 Python 移植实现
graphql_relay 3.1.5 → 3.2.0 graphql-core 的 Relay 库
guidata 2.1.1 → 2.2.1 自动生成 GUI 以编辑/显示数据集
h5py 3.6.0 → 3.7.0 读写 HDF5 文件
holoviews 1.14.8 → 1.15.0 数据标注驱动的自动化可视化
httpcore 0.14.7 → 0.15.0 极简低层 HTTP 客户端
httpie 3.1.0 → 3.2.1 面向人类的 cURL 类 CLI
httpx 0.22.0 → 0.23.0 下一代 HTTP 客户端
hvplot 0.7.3 → 0.8.0 基于 HoloViews 的高层绘图 API
hypothesis 6.45.1 → 6.46.9 基于属性的测试库

4.2 I–P 段(60 个)

包名 版本变化 说明
imageio 2.17.0 → 2.19.3 图像/视频/科学数据格式读写库
imagesize 1.3.0 → 1.4.1 获取 png/jpeg/jpeg2000/gif 图片尺寸
imbalanced_learn 0.9.0 → 0.9.1 不平衡数据集机器学习工具箱
importlib_metadata 4.11.3 → 4.11.4 读取已安装包的元数据
importlib_resources 5.7.1 → 5.8.0 读取包资源文件
ipycanvas 0.11.0 → 0.12.0 暴露浏览器 Canvas API 的交互组件库
ipykernel 6.13.0 → 6.15.1 Jupyter 的 IPython 内核
ipyleaflet 0.14.0 → 0.17.0 动态 Leaflet 地图 Jupyter 组件
ipython 7.32.0 → 8.4.0 IPython:高效交互式计算
ipywidgets 7.7.0 → 7.7.1 Jupyter HTML 组件
json5 0.9.6 → 0.9.8 JSON5 数据格式的 Python 实现
jsonschema 4.4.0 → 4.6.2 JSON Schema 校验实现
jupyter_client 7.3.0 → 7.3.4 Jupyter 协议实现与客户端库
jupyter_console 6.4.3 → 6.4.4 Jupyter 终端控制台
jupyter_core 4.10.0 → 4.11.1 Jupyter 核心基础包
jupyter_packaging 0.12.0 → 0.12.2 Jupyter 打包工具
jupyter_server 1.17.0 → 1.18.1 Jupyter Server
jupyter_sphinx 0.3.2 → 0.4.0 Jupyter Sphinx 扩展
jupyterlab 3.3.4 → 3.4.3 JupyterLab 笔记本服务器扩展
jupyterlab_server 2.13.0 → 2.14.0 JupyterLab Server
kiwisolver 1.4.2 → 1.4.3 Cassowary 约束求解器的高效实现
lxml 4.8.0 → 4.9.0 基于 libxml2/libxslt 的 XML 处理
lz4 4.0.0 → 4.0.1 LZ4 压缩绑定
markdown 3.3.6 → 3.3.7 Python Markdown 实现
matplotlib 3.5.1 → 3.5.2 Python 绘图包
maturin 0.12.14 → 0.13.0 用 pyo3/cffi 构建发布 Rust 扩展
mpld3 0.5.7 → 0.5.8 Matplotlib 的 D3 查看器
msgpack 1.0.3 → 1.0.4 MessagePack 序列化/反序列化
nbclassic 0.3.7 → 0.4.2 作为 Jupyter Server 扩展的 Notebook
nbclient 0.6.0 → 0.6.6 执行笔记本的客户端库
nbformat 5.3.0 → 5.4.0 Jupyter Notebook 格式
netcdf4 1.5.8 → 1.6.0 netCDF4 库的面向对象 Python 接口
networkx 2.8 → 2.8.3 图与网络创建操作包
notebook 6.4.11 → 6.4.12 基于 Web 的交互式笔记本环境
numcodecs 0.9.1 → 0.10.0 数据存储/通信用缓冲压缩编解码器
numexpr 2.8.1 → 2.8.3 面向 NumPy 的快速数值表达式求值器
numpy 1.22.3+mkl → 1.22.4+mkl 数组计算基础包(含 MKL 加速)
numpydoc 1.2.1 → 1.3 支持 Numpy 风格 docstring 的 Sphinx 扩展
openpyxl 3.0.9 → 3.0.10 读写 Excel xlsx/xlsm 文件
pandas 1.4.2 → 1.4.3 数据分析、时间序列与统计
panel 0.13.0 → 0.13.1 高层应用与仪表盘方案
param 1.12.1 → 1.12.2 声明式 Python 参数编程
pathy 0.6.1 → 0.6.2 本地与云存储的 pathlib.Path 子类
pillow 9.1.0 → 9.1.1 Python 图像处理库(PIL 分支)
pims 0.5 → 0.6.1 Python 图像序列
pip 22.0.4 → 22.1.2 PyPA 推荐的 Python 包安装工具
pkginfo 1.8.2 → 1.8.3 查询 sdist/bdist 与已装包元数据
plotly 5.7.0 → 5.8.0 开源交互式绘图库
plotnine 0.8.1.dev0 → 0.9.0 Python 的图形语法(ggplot2 风格)
prettytable 3.2.0 → 3.3.0 ASCII 表格展示工具
proglog 0.1.9 → 0.1.10 控制台/笔记本/Web 日志与进度条
pydantic 1.9.0 → 1.9.1 基于类型注解的数据校验与设置管理
pyhdf 0.10.3 → 0.10.5 NCSA HDF4 库的 Python 接口
pylint 2.13.7 → 2.14.0 Python 静态检查器
pyshp 2.2.0 → 2.3.0 ESRI Shapefile 纯 Python 读写
pyside6 6.3.0 → 6.3.1 Qt 跨平台应用/UI 框架的 Python 绑定
pyside6_addons 6.3.0 → 6.3.1 Qt 绑定(Addons 附加组件)
pyside6_essentials 6.3.0 → 6.3.1 Qt 绑定(Essentials 核心组件)
pythonnet 3.0.0a2 → 3.0.0rc1 .NET 与 Mono 集成
pyzmq 22.3.0 → 23.2.0 0MQ 的 Python 绑定

4.3 Q–Z 段(33 个)

包名 版本变化 说明
qdarkstyle 3.0.3 → 3.1 最完整的 Qt 深色样式表
qtconsole 5.3.0 → 5.3.1 Jupyter Qt 控制台
qtpy 2.1.0 → 2.2.0.dev0 多 Qt 绑定抽象层
redis 4.2.2 → 4.3.1 Redis 键值存储的 Python 客户端
regex 2022.3.15 → 2022.6.2 替代 re 的增强正则模块
reportlab 3.6.9 → 3.6.10 ReportLab 文档生成工具包
rich 12.3.0 → 12.4.4 终端富文本/表格/进度条渲染
rope 1.0.0 → 1.2.0 Python 重构库
scikit_image 0.19.2 → 0.19.3 面向 SciPy 的图像处理例程
scikit_learn 1.0.1 → 1.1.1 机器学习与数据挖掘模块
scipy 1.8.0 → 1.8.1 SciPy 科学计算库
setuptools 62.1.0 → 63.1.0 包安装/构建/升级工具链
shapely 1.8.1.post1 → 1.8.2 几何对象、谓词与操作
shiboken6 6.3.0 → 6.3.1 Python/C++ 绑定辅助模块
sphinx 4.5.0 → 5.0.2 基于 reStructuredText 的文档生成工具
sqlalchemy 1.4.35 → 1.4.39 数据库抽象库
starlette 0.17.1 → 0.19.1 轻量 ASGI 库
terminado 0.13.3 → 0.15.0 基于 Tornado websocket 的终端服务
tifffile 2022.4.22 → 2022.5.4 TIFF 文件读写
tomlkit 0.10.2 → 0.11.1 保留风格的 TOML 库
traitlets 5.1.1 → 5.3.0 Traitlets Python 配置系统
trio 0.20.0 → 0.21.0 友好的异步并发与 I/O 库
twine 4.0.0 → 4.0.1 在 PyPI 发布包的实用工具集
typer 0.4.1 → 0.4.2 基于类型提示构建 CLI
typing_extensions 4.2.0 → 4.3.0 Python 3.5+ 类型提示实验性扩展
ujson 5.2.0 → 5.3.0 超快 JSON 编解码器
urllib3 1.26.9 → 1.26.10 带线程安全连接池的 HTTP 库
uvicorn 0.17.6 → 0.18.2 极速 ASGI 服务器
watchdog 2.1.7 → 2.1.8 文件系统事件监控
websocket_client 1.3.2 → 1.3.3 WebSocket 客户端(hybi13)
widgetsnbextension 3.6.0 → 3.6.1 Jupyter HTML 组件扩展
winpython 4.6.20220501 → 4.7.20220709 WinPython 发行工具(含 WPPM)
wrapt 1.14.0 → 1.14.1 装饰器、包装与 monkey patching 模块

4.4 值得重点关注的升级

  • WinPython 自身工具:winpython 4.6.20220501 → 4.7.20220709(“WinPython distribution tools, including WPPM”)。作为本仓库的核心产物之一,WPPM 工具链同步升级,版本号中的日期后缀(20220709)暗示构建于 2022 年 7 月。
  • Jupyter 全家桶:jupyterlab 3.3.4 → 3.4.3、ipykernel 6.13.0 → 6.15.1、jupyter_server 1.17.0 → 1.18.1、ipython 7.32.0 → 8.4.0,配合新增的 stack_data 等包,交互式编程体验整体前移一个大版本。
  • 科学计算三件套:numpy 1.22.3+mkl → 1.22.4+mkl、scipy 1.8.0 → 1.8.1、pandas 1.4.2 → 1.4.3,均为维护性小升级;scikit_learn 1.0.1 → 1.1.1 则是 1.0 系列内的功能增强版。
  • 并行与分布式:dask 2022.4.2 → 2022.7.0 与 distributed 2022.4.2 → 2022.7.0 同步推进,fsspec 2022.3.0 → 2022.5.0 等外围文件抽象也随之更新。
  • Web 服务栈:fastapi 0.75.2 → 0.78.0、starlette 0.17.1 → 0.19.1、uvicorn 0.17.6 → 0.18.2、httpx 0.22.0 → 0.23.0 整体升级,直接相关的是本节后面将要讨论的 httptools、watchgod 移除。
  • 打包/发布工具:pip 22.0.4 → 22.1.2、setuptools 62.1.0 → 63.1.0、twine 4.0.0 → 4.0.1、maturin 0.12.14 → 0.13.0。
  • 大版本跨越:cookiecutter 1.7.3 → 2.1.1(从 1.x 直接跳到 2.1.1)、ipython 7 → 8、pythonnet 3.0.0a2 → 3.0.0rc1(alpha 到 RC)。

五、移除包(Removed packages):4 个退出名单的包

包名 版本 说明
httptools 0.4.0 框架无关的 HTTP 协议工具集
poyo 0.5.0 轻量 YAML 解析器
watchgod 0.8.2 简单现代的文件监听与代码热重载
websockets 10.3 WebSocket 协议(RFC 6455 & 7692)实现

这四个移除项与升级项之间存在明显的连带关系,可以从依赖链角度作出合理推断:

  • poyo:它是 cookiecutter 1.x 时代的配置解析依赖;本版 cookiecutter 大幅升级到 2.1.1(2.x 重写了配置加载机制),随之不再需要 poyo,故被移除。
  • httptools / watchgod:二者曾是 uvicorn 的优化/重载附属依赖;本版 uvicorn 0.17.6 → 0.18.2 重构了相关实现后,发行版不再打包这两个包。
  • websockets:该实现此前服务于 WebSocket 场景(如 uvicorn/starlette 的可选依赖或 terminado 相关链路),在相关组件升级后不再被发行版所需。

需要说明的是:以上依赖关系属于基于版本演进的推断,仓库的 diff 机制本身只做“新旧索引对比”,并不记录移除原因——这一点在下文源码分析中可以看到。

六、溯源:_History.md 是如何自动生成的

这份看似“人工维护”的变更日志,实际上完全由构建工具链自动产出。整条链路在 winpython/build_winpython.py 的 Step 7(generate changelog) 中完成:

  1. 用 wppm.Distribution().generate_package_index_markdown() 生成当前版本的完整包索引 WinPythonPyPy-64bit-3.8.12.3.md(该方法定义见 wppm/wppm.py);
  2. 调用 wppm.diff.compare_package_indexes(changelog_version, searchdir=changelog_dir, flavor=..., architecture=...) 对比“上一版本索引”与“本版本索引”,把差异写成 _History.md;
  3. 历史文件的文件名由 WinPython{flavor}-{arch}bit-{changelog_version}_History.md 拼出(如本文 WinPythonPyPy-64bit-3.8.12.3_History.md)。

核心的对比逻辑位于 wppm/diff.py:

  • PackageIndex 类按 ### Tools、### Python packages、### WheelHouse packages 三个区块解析索引文件(对应 PackageIndex.HEADERS);
  • compare_packages(old, new) 将包名归一化(- → _、转小写)后求集合差:只出现在新版的为 New,两边都有但版本号不同的为 Upgraded,只出现在旧版的为 Removed;
  • 输出格式 New packages / Upgraded packages / Removed packages 正是原文档三个小节的结构,升级行统一书写为 旧版 → 新版。

“上一版本”的选取由 find_previous_version() 完成(wppm/diff.py):它扫描 changelogs/ 目录,用正则 WinPython{flavor}-{arch}bit-(.+)\.(?:txt|md)$ 匹配文件名、以 PEP 440 规则解析版本号,取“小于当前版本的最大版本”。这正是 3.8.12.3 的对比基准落在 3.8.12.2 上的原因。文件名因此成为“承重结构”——tests/test_diff_versions.py 专门验证了:

  • 版本带 release level(如 3.14.7.1b1)时仍能正确排序、不会被跳过;
  • _History.md 这类伴生文件永远不会被当作“上一版本”;
  • 目录中无关文件会被忽略。

七、实战:用 wppm -diff 重放与验证版本对比

读者无需重新构建整个发行版,即可在本地重放任意两次发布之间的差异。wppm 的 diff 子命令支持两种输入形态(用法见 wppm/diff.py):

形态一:直接对比两个包索引文件

wppm -diff WinPythonPyPy-64bit-3.8.12.2.md WinPythonPyPy-64bit-3.8.12.3.md

该命令输出两个索引在 Tools / Python packages / WheelHouse packages 各区块的 New、Upgraded、Removed 列表,方向由文件先后决定(升级行恒为“旧 → 新”)。

形态二:按版本号对比 changelogs 目录中的历史索引

wppm -diff 3.8.12.3 3.8.12.2 changelogs PyPy 64
# 或
python -m wppm.diff 3.8.12.3 3.8.12.2 changelogs PyPy 64

各位置参数依次为:目标版本、基准版本、changelogs 目录、flavor(此处为 PyPy)、架构位数(64)。

形态三:重新写出历史文件

python -m wppm.diff --write-changelog 3.8.12.3 3.8.12.2 changelogs PyPy 64

--write-changelog 会把对比结果写回 changelogs/WinPythonPyPy-64bit-3.8.12.3_History.md(可选 basedir 参数可同时复制到其他目录)。

此外,wppm/diff.py 还提供 --section(只比较指定区块)与 --pairs(多区块配对比较)两种细粒度模式,例如 --pairs python wheelhouse 可只比较 Python 包与 WheelHouse 包的差异。注意 Windows 控制台默认编码可能是 cp1252,而升级行包含 → 箭头字符,因此脚本入口会对 stdout 重配置为 UTF-8(见 wppm/diff.py),在自行调用时也应留意编码问题。

八、小结

WinPython-64bit 3.8.12.3PyPy 是一次典型的维护性发布:工具链例行升级、7 个新包补齐 IPython 8 与 Argon2 依赖链、136 个包整体前移、4 个包随依赖重构退出。更重要的是,它的 _History.md 是仓库构建工具链(winpython/build_winpython.py + wppm/diff.py + wppm/wppm.py)自动生成的产物,理解这一机制后,读者既能准确解读每一行“升级/移除”背后的语义,也能用 wppm -diff 对任意两个版本自行做差异审计。

登录后查看全文
winpython