Stubgen support for positional only parameters as per PEP 570
Nessuno ha ancora preso questa issue.
- Lingua principale
- Python
- Stelle
- 20.6k
- Fork
- 3.3k
- Metriche di merge delle PR
- Metriche PR in attesa
Descrizione
Feature
Stubgen should recognize a signature in the shape of func(param1: T1, param2: T2, /) -> T3 if given in the docstring.
Pitch
As https://peps.python.org/pep-0570/ describes, this is common with C extensions. There is currently no way to express these signatures in a way that stubgen can understand and regenerate correctly in the stub.
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia dalla gestione da parte di stubgen delle firme trovate nei docstring dei moduli di estensione e confronta la sintassi richiesta con PEP 570. Verifica che lo stub generato conservi i parametri posizionali-only usando il marker / e aggiungi o aggiorna la coverage per una firma come quella nell’issue.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- python
- Ambito
- cli, tooling
- Tipo di issue
- Funzionalità
- Difficoltà
- 3/5
- Tempo stimato
- 1-2 giorni
- Stato di attività
- Ferma
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 48/100