Spec: `Final` section could use better definition for `Final` vs. `Final[X]`

Aperta Adatta ai principianti
#2,356 2 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

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

Direzione di ricerca

Inizia dalla sezione della specifica relativa alla sintassi di Final e cerca nella specifica e nella documentazione correlata le descrizioni esistenti di Final e Final[X]. Il lavoro è completato quando le due forme hanno definizioni chiare e denominate in modo coerente, che utilizzano termini come «nudo» e «tipizzato esplicitamente», senza lasciare formulazioni in conflitto altrove.

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

Descrizione

topic: typing spec

Came up in #2353: Currently, the syntax section for Final uses the following definitions:

Final may be used in one of several forms:

  • With an explicit type, using the syntax Final[<type>] [...]
  • With no type annotation. [...]

As @carljm points out, these definitions are not great. I suggest to give them better names and use those consistently in the spec (and elsewhere). Carl used "bare" for the latter case, which I like. Maybe "explicitly typed" for the former? "When using a bare Final ..." or "When using an explicitly typed Final ..."

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

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.

Altre issue di python/typing

Tutte le issue di python/typing

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.