Adding platform information to stdlib/VERSIONS
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 5.1k
- Forks
- 2.1k
- Ø Merge
- 1 T. 19 Std.
- Gemergte PRs (30 T.)
- 82
Beschreibung
It might be a good idea to add platform availability information to stdlib/VERSIONS, instead of using the sys.platform hack we're currently using in the source files. This has the same rationale for introducing VERSIONS in the first place:
- Remove platform checks and the required indentation from stub files.
- Enables clearer type checker messages (e.g. "Module does not exist on this platform", instead of "Item X doesn't exist in module Y")
- Generally an unambiguous way of indicating that a module doesn't exist.
- Edit: Collect all information about module availability in one place.
One way to do this is an HTTP/E-Mail header-like key/value syntax:
abc: 3.0-; platforms=linux,darwin
def: 3.7-3.10; platforms=!windows,!linux
ghi: 3.9-
This would allow future extension when type checkers are equipped to ignore unknown keys:
abc: 3.0-; header1=foo; header2=bar
Do we need a way do indicate that a certain platform only supports a certain module starting from a certain Linux version?
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
Beginne mit stdlib/VERSIONS und den Quelldateien, die derzeit sys.platform-Prüfungen verwenden. Überprüfe, wie die Verfügbarkeit von Modulen dort dargestellt wird und wie Typechecker diese Informationen verarbeiten. Lege das Format für Plattformschlüssel und -werte fest, einschließlich plattformspezifischer Unterstützung für bestimmte Versionen und des Umgangs mit unbekannten Schlüsseln; abgeschlossen ist die Aufgabe, wenn der Vorschlag ausreichend präzise für die Implementierung spezifiziert ist.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- tooling
- Issue-Typ
- Feature
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 25/100