Open hauntsaninja opened 3 years ago
A new way to easily find some low-hanging fruits, thanks to @AlexWaygood , is through https://alexwaygood.github.io/typeshed-stats/stats-csv/.
One can sort by unannotated_parameters
to find stubs that are considered incomplete in pyright (and are not using the stricter checks).
Or by explicit_Incomplete_*
to sort stubs by how many incomplete definitions there are left.
Or by stubtest_strictness
to find stubs that are still missing definitions with MISSING_STUBS_IGNORED
.
Something I've been doing as well, is looking at https://github.com/microsoft/python-type-stubs for stubs that can be merged / upstreamed to typeshed.
We maintain a list of existing stubtest errors on the standard library and third party stubs, that we're looking to either fix or to add a comment explaining why stubtest should be ignored: Allowlist of errors for the stdlib Example of allowlist for a third party stub
The link of Allowlist of errors for the stdlib
is dead.
The link of
Allowlist of errors for the stdlib
is dead.
We keep them here these days: https://github.com/python/typeshed/tree/main/stdlib/%40tests/stubtest_allowlists.
If you fancy helping out with updating our stubs for py313 in particular, I put together a guide for that specifically in #11990!
Welcome to typeshed! Like most projects, reading our CONTRIBUTING.md and scrolling through our issues is a good way to find things that need improvement. In fact, many of our issues should be fixable by beginners, even if not marked as such.
However, unlike many projects, there are other very easy ways to find improvements to be made, without relying on people running into and filing issues. Here are some things you can do (click on details for the details):
1) Use stubtest to find things missing from or problematic with stubs.
2) Use stricter mypy settings to identify issues with stubs.
3) Contribute stubs for a new library.
4) Literally just grep for the words "incomplete" or "TODO"
5) Update third party stubs
(Other maintainers: feel free to edit the text of this issue as you see fit)