Libraries document

Aberta

#905 aberta em 7/10/2021 0 comentários 0 reações 1 responsável Ver no GitHub

@srittau já está trabalhando nisso.

Desde 7/10/2021.

Avaliação

Esta issue ainda não foi avaliada.

Descrição

topic: documentation

Some thoughts copied from srittau/type-stub-pep#94:

Convert to restructed text to fit with the rest of the typing docs (and Python docs in general).
Update a few recommended practices like using list instead of List.
Add a link to the existing stubs document.

In the long run, I think this would make a good basis for a "How to type annotate a library" document. It makes sense to me to split out some chapters into separate documents, possibly merging them with existing or new texts. For example, the best practices section could be merged with some recommendations from the stubs document to form a new general "best practices" document (see also python/typing#851).

Linguagem predominante: Python
Estrelas: 1.8k
Forks: 302
Merge médio: 23h
PRs com merge (30d): 8

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

Leia a issue inteira e depois o guia de contribuição do projeto.
Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
Faça um fork do repositório e trabalhe em uma branch.
Abra um pull request que referencie o número da issue.

Mais de python/typing

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

topic: typing spec

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100

python/typing#2356 · 2 comentários · 1 reação · Aberta em 2/9/2026
Spec: PEP leftovers in the spec for literals Aberta

topic: typing spec

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100

python/typing#2355 · Aberta em 1/9/2026
Update reference/generics.html with PEP695 type parameter syntax Aberta

topic: documentation

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100

python/typing#2227 · 2 comentários · Aberta em 25/3/2026
Remove PEP references in Typing Python Libraries guide Aberta

topic: documentation

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100

python/typing#2150 · 2 comentários · 2 reações · Aberta em 12/1/2026
Finals and Literals: Spec contradiction Aberta

topic: conformance tests topic: typing spec

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 72/100

python/typing#2351 · 2 comentários · Aberta em 31/8/2026

Todas as issues de python/typing

Issues semelhantes

validate-structure inspecte challenge/work/.terraform et rend faux les labs qui ont un provider en cache Aberta

bug

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100

stephrobert/dsoxlab#238 · Aberta em 24/9/2026
Uniform probability densities use the upper bound as an interval width Aberta

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100

nasa/fmdtools#40 · Aberta em 24/9/2026
_common_folder() treats a single file as the common folder; single-file archives can't be installed (4.2.8) / crash (master) Aberta

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100

sublimehq/package_control#1780 · Aberta em 24/9/2026
Set 'Sample' input in 'autorun.py' to utilize 'Sample' Tab in eLog Aberta

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100

pcdshub/mfx#309 · 2 comentários · Aberta em 24/9/2026
niri config file addition does not respect existing optional include Aberta

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100

nwg-piotr/nwg-displays#145 · Aberta em 24/9/2026

Mais issues de Python