python / python/cpython

Bytecode changes in 3.14 are not documented in `dis` module docs

未关闭
#135,447 8 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

3.14 docs type-bug
主要语言
Python
星标
77.2k
派生
35.9k
PR 合并指标
PR 指标待抓取

描述

Documentation

The module documentation for dis normally contains documentation for all non-specialized bytecode instructions.

However, many of the new bytecode instructions added in 3.14 (BUILD_INTERPOLATION, NOT_TAKEN, etc) are missing from the 3.14 module docs. Some changes to existing instructions like CALL_FUNCTION_EX are also undocumented.

  • BUILD_TEMPLATE
  • BUILD_INTERPOLATION
  • NOT_TAKEN
  • POP_ITER
  • CALL_FUNCTION_EX (changed)
  • Remove BINARY_SUBSCR

Based on pycore_magic_number.h, it appears all changes after Python 3.14a2 with magic number 3609 are undocumented. Changes before this, like the addition of LOAD_SMALL_INT are correctly documented.

Linked PRs
  • gh-135478
  • gh-135803
  • gh-139399

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

从 Python 3.14 的 dis 模块文档开始,将其中的字节码指令条目与 Include/internal/pycore_magic_number.h 进行比较,重点关注 magic number 3609 之后的变化。在进行修改之前,先查看已链接的 PR,尤其是关于 BUILD_INTERPOLATIONNOT_TAKENPOP_ITERCALL_FUNCTION_EX 以及移除 BINARY_SUBSCR 的 PR。文档中记录的指令集和变更后的行为与 Python 3.14 一致,即表示完成。

由索引模型根据 Issue 内容生成。

评估

技术栈
python
领域
documentation
Issue 类型
文档
难度
2/5
预计耗时
1-2 天
活跃度
停滞
描述清晰度
描述清楚
新手友好度
25/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。