Document the various code generation tools used by CPython

Offen

#805 erstellt am 27.1.2022 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 2/5
Geschätzter Aufwand: 1-2 Tage
Anfängerfreundlichkeit: 45/100

Issue-Typ: Dokumentation
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: python
Bereich: build-system, documentation

Rechercherichtung

Überprüfe den bestehenden Abschnitt „Guide to CPython's Parser“ und die aufgeführten Tools: freeze_modules.py, deepfreeze.py und generate_global_objects.py. Ermittle, ob die Dokumentation in den devguide oder in die CPython-Dokumentation gehört, und dokumentiere anschließend Zweck und Aufruf jedes Tools sowie die zugehörigen make targets, mit Links zu Parser-Generatoren, wo dies angebracht ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

topic-dev process type-feature

Describe the enhancement or feature you'd like

There should be some documentation about the various code generation tools used in CPython, for example:

freeze_modules.py
deepfreeze.py
generate_global_objects.py

I don't think there needs to be a massive amount of documentation about these. Just a brief mention of their purposes, how to invoke them, and notes about their related make targets.

Related are the Parser generator etc., which are already documented under Guide to CPython's Parser, but could also be mentioned. I think their existing docs could also be used as something of a template.

Describe alternatives you've considered

Argument clinic is already documented at https://docs.python.org/3/howto/clinic.html so maybe this documentation would be more appropriate in the main Python repo's docs? I'll defer to the devguide maintainers on this.

Additional context

Started from a conversation at https://github.com/python/cpython/pull/30941#issuecomment-1023501086

CC @ericisnowcurrently

Vorherrschende Sprache: Python
Sterne: 2.1k
Forks: 1k
Ø Merge: 2 T. 12 Std.
Gemergte PRs (30 T.): 12

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus python/devguide

Feature: Document SELinux bind-mount note for local devcontainer usage Offen

type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

python/devguide#1879 · 1 Kommentar · Erstellt am 13.8.2026
Feature: Add Homebrew as a way to get build dependencies installed on Linux Offen

type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

python/devguide#1791 · 2 Kommentare · 1 Reaktion · Erstellt am 20.4.2026
Feature: Add instructions about JIT builds Offen

topic-building python type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100

python/devguide#1620 · 1 Kommentar · Erstellt am 02.8.2025
Update test command on dev guide landing page Offen

needs: decision topic-test type-bug

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100

python/devguide#1171 · 10 Kommentare · Erstellt am 29.9.2023
Explain how to revert maintenance branch commits Offen

topic-dev process type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100

python/devguide#319 · 4 Kommentare · 3 Reaktionen · Erstellt am 30.1.2018

Alle Issues in python/devguide