Distribute stdlib types as types-stdlib
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- Python
- Estrellas
- 5.1k
- Forks
- 2.1k
- Merge medio
- 1 d 19 h
- PR fusionados (30 d)
- 82
Descripción
This has been briefly discussed before, but I think it would be a good idea if we started distributing the stdlib types in a separate package types-stdlib, similar to third-party packages:
- Type checkers could optionally depend on (a specific version of) that package, instead of shipping their own copy, reducing coupling and arguably improving maintainability.
- Third-party stubs could require a minimum version of the
types-stdlibpackage, for example if they are relying on_typeshedfeatures or for cases like #5762. Type checkers that opt to distribute a copy of the stdlib, could warn if incompatible stubs are used.
Technical considerations:
- The versioning scheme would be similar to third-party stubs, e.g.
types-stdlib 3.10.X, whereXis incremented automatically. We should probably increment the version number as soon as the first beta is released and we are reasonably sure we have added all new/changed API. - The stubs would be installed into a special directory, for example
stdlib, or even a non-importable name liketypes-stdlib(so we'd have stubsstdlib/sys.pyietc.) so that they are only used by type checkers that support this package and don't interfere.
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Empieza revisando la discusión del issue y el contexto enlazado anteriormente, ya que no se mencionan archivos, pruebas ni puntos de entrada. Define el diseño de los paquetes, el esquema de versionado, el comportamiento de la instalación y las expectativas de compatibilidad antes de la implementación; para darlo por terminado se requiere llegar a un acuerdo sobre el diseño y contar con una ruta de distribución completa para los stdlib stubs.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- python
- Área
- tooling
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Estancado
- Claridad
- Necesita aclaración
- Aptitud para principiantes
- 25/100