channable / channable/opsqueue

Add typing stubs (`.pyi` files) for PyO3-generated Python definitions

Ouverte
#101 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
Rust
Étoiles
96
Forks
2
Merge moyen
1 h 2 min
PR mergées (30 j)
2

Description

Even with https://github.com/channable/opsqueue/issues/8 resolved, type checkers will treat types that are exclusively defined via C bindings as `Any`. Typing stubs would fix this, but PyO3 currently does not generate them (https://github.com/PyO3/pyo3/issues/5137). Manually maintaining them would be annoying because it'd have to be kept in sync with the Rust definitions of the types, but it could still be valuable as a temporary solution.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Piste de recherche

Start by locating the Rust definitions exposed through PyO3 and checking how the generated Python definitions are currently represented. Review PyO3 issue 5137 and the existing type-checking setup, then define which exported types and signatures the stubs must cover. Done means the stubs describe the relevant bindings without leaving those types as Any and are documented as maintainable alongside the Rust definitions.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python, rust
Domaine
developer-experience
Type d'issue
Fonctionnalité
Difficulté
4/5
Temps estimé
3-5 jours
Activité
Calme
Clarté
À clarifier
Accessibilité débutants
38/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.