python / python/cpython

Support `<LITERAL ELLIPSIS>` in `doctest` module

Offen
#142,942 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

stdlib type-feature
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
35.9k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

Feature or enhancement

Proposal:

Currently, with # doctest: +ELLIPSIS, a ... can match anything. Sometimes, we want to test that a test matches a literal ellipsis.

I propose something similar to <LITERAL ELLIPSIS>. Possibly guarded behind another doctest flag.

'''
>>> '123...456' # doctest: +ELLIPSIS
'123<LITERAL ELLIPSIS>456'
'''

Motivation: SageMath doctest. See https://github.com/sagemath/sage/pull/41276, https://github.com/sagemath/sage/pull/41182.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

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

Lies zunächst das doctest-Modul und seine bestehende ELLIPSIS-Behandlung. Ermittle, wie eine wörtliche Ellipsenmarkierung angegeben werden sollte und ob ein separates doctest-Flag erforderlich ist, und füge anschließend eine Regressionstestabdeckung hinzu, die zeigt, dass die vorgeschlagene Markierung mit wörtlichen Ellipsen übereinstimmt, während die gewöhnliche Ellipsenübereinstimmung weiterhin funktioniert.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
testing-qa
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Veraltet
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

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