python / python/cpython

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

Offen
#135,447 8 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

3.14 docs type-bug
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
35.9k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

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

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginnen Sie mit der Dokumentation des Python-3.14-Moduls dis und vergleichen Sie dessen Einträge zu Bytecode-Instruktionen mit Include/internal/pycore_magic_number.h. Konzentrieren Sie sich dabei auf Änderungen nach der Magic Number 3609. Überprüfen Sie die verknüpften PRs, bevor Sie Änderungen vornehmen, insbesondere für BUILD_INTERPOLATION, NOT_TAKEN, POP_ITER, CALL_FUNCTION_EX und die Entfernung von BINARY_SUBSCR. Die Aufgabe ist abgeschlossen, wenn der dokumentierte Instruktionssatz und das geänderte Verhalten mit Python 3.14 übereinstimmen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
25/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.