python / python/cpython

Incorrect information about exception raised if source contains null bytes for ast.parse() and compile()

Offen
#122,461 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

3.12 3.13 3.14 docs
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
35.9k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

Documentation

Docs for compile() and ast.parse() say they raise ValueError for source contains null bytes. However, since 3.12 (https://github.com/python/cpython/pull/97594), SyntaxError is raised instead:

>>> compile("\x00", "lambda.tt", "exec")
Traceback (most recent call last):
  File "<python-input-0>", line 1, in <module>
    compile("\x00", "lambda.tt", "exec")
    ~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
SyntaxError: source code string cannot contain null bytes

https://github.com/python/cpython/blob/d1a1bca1f0550a4715f1bf32b1586caa7bc4487b/Doc/library/functions.rst?plain=1#L337-L338
And
https://github.com/python/cpython/blob/d1a1bca1f0550a4715f1bf32b1586caa7bc4487b/Doc/library/ast.rst?plain=1#L2158

Linked PRs
  • gh-122462

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 den referenzierten Einträgen in Doc/library/functions.rst und Doc/library/ast.rst und überprüfen Sie anschließend den verknüpften PR gh-122462 auf den aktuellen Stand der Arbeiten. Aktualisieren Sie die dokumentierte Ausnahme so, dass sie dem Verhalten von Python 3.12 entspricht, und verifizieren Sie, dass beide betroffenen Dokumentationsabschnitte konsistent sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

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

Neue Issues direkt in Ihr Postfach

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