Undocumented Cmd method print_topics
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 77.2k
- Forks
- 35.9k
- PR-Merge-Kennzahlen
- PR-Kennzahlen ausstehend
Beschreibung
Documentation
When exploring the Cmd Python library, I realized that there is no documentation for print_topics method.
I only realized the missing documentation because I noticed that print_topics method has an unused parameter called cmdlen, and I couldn't figure out if it is actually useful for something.
I could also notice that on typeshed it is typed as Any, even though it seems to be only used as an int.
Extra doubts:
Maybe print_topics should be renamed to _print_topics or we should document how to use it properly?
Also, is that cmdlen parameter really needed?
I am willing to contribute with that, but I don't know which type of issue I should open to report an unused param.
Links:
- Cmd documentation: https://docs.python.org/3.13/library/cmd.html
- Cdm.print_topics definition: https://github.com/python/cpython/blob/main/Lib/cmd.py#L346
- typeshed: https://github.com/python/typeshed/blob/main/stdlib/cmd.pyi#L45
Linked PRs
- gh-134539
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginnen Sie mit der Definition von print_topics in Lib/cmd.py#L346, der Cmd-Dokumentation und seiner typeshed-Deklaration. Prüfen Sie den verknüpften PR gh-134539 sowie die ungeklärten Fragen zu cmdlen, Benennung und Typisierung, bevor Sie das vorgesehene öffentliche Verhalten festlegen. Erledigt bedeutet, dass das vereinbarte Verhalten und die Verwendung der Parameter dokumentiert sind und die typeshed-Annotation bei Bedarf berücksichtigt wurde.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 35/100