python / python/typing

Spec: PEP leftovers in the spec for literals

Aperta Adatta ai principianti
#2,355 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

topic: typing spec
Lingua principale
Python
Stelle
1.8k
Fork
302
Merge medio
23h
PR unite (30g)
8

Descrizione

There are some sections in the spec for literals that made sense as a rationale or look into the future in the PEP, but should be removed in the spec for conciseness, clarity, and consistency:

  • An (incomplete) list of illegal parameters for Literal. Since this immediately succeeds a positive, exclusive list of what parameters are allowed, this is just fluff and I believe the whole section should just be removed.
  • The next section is titled "Parameters at runtime" and details implementation details for Literal. These seem unnecessary for the typing spec and are in danger of getting desynched with the actual implementation.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Apri la specifica dei letterali e individua le sezioni sui parametri illegali e sui parametri in fase di esecuzione menzionate nell’issue. Rimuovi le sezioni relative alla motivazione e ai dettagli di implementazione, mantenendo concisa la descrizione normativa, quindi esamina la specifica renderizzata per confermare che il contenuto circostante rimanga chiaro.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Attiva
Chiarezza
Abbastanza chiara
Idoneità per principianti
75/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.