python / python/cpython

`csv.get_dialect()` returns a `_csv.Dialect` object, not `csv.Dialect` as documented.

Offen
#138,352 5 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

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

Beschreibung

The documentation at https://docs.python.org/3/library/csv.html#csv.Dialect indicates that this class is what is returned when calling csv.get_dialect(). But the C implemented class _csv.Dialect() is returned instead.

>>> import csv
>>> csv.get_dialect("excel")
<_csv.Dialect object at 0x0000026C0004DBC0>

This makes writing typesafe code that uses Dialect a challenge. See related typeshed issue at https://github.com/python/typeshed/issues/14667

It's not clear whether this is a documentation or implementation issue.

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

Beginne mit dem Einstiegspunkt csv.get_dialect() und der in der Issue verlinkten Dokumentation zu csv.Dialect und vergleiche anschließend den dokumentierten Rückgabetyp mit der zur Laufzeit erzeugten Klasse _csv.Dialect. Sieh dir die zugehörige typeshed-Issue an, um den Kontext der Typisierung zu verstehen. Als abgeschlossen gilt die Entscheidung, ob sich die Dokumentation oder die Implementierung ändern sollte, sowie die entsprechende Angleichung des öffentlichen Verhaltens und der Typen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
backend
Issue-Typ
Bug
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
42/100

Neue Issues direkt in Ihr Postfach

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