python/typeshed

View on GitHub

Collection of library stubs for Python, with static types

Stars: 5.1k
Forks: 2.1k
Open beginner issues: 4
Indexed issues: 204
Avg merge: 1d 19h
Merged PRs (30d): 82

Dominant language: Python
License: No license data
Last GitHub push: Sep 17, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

204 open issues indexed

(3.14) Templates not typeable without TypeVarTuple transformations Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

python/typeshed#14878 · 2 comments · Opened Oct 15, 2025
Question - how to write a stub file with missing imports? Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#14867 · Opened Oct 13, 2025
Improving the daily stubtest check for third-party stubs Open

project: infrastructure

Difficulty 5/5 Over a week Newbie friendliness 30/100

python/typeshed#14838 · 3 comments · 2 reactions · Opened Oct 6, 2025
Replace mypy-protobuf with protobuf pyi_out Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#14753 · 3 comments · Opened Sep 20, 2025
`ElementTree.parse` type hinted to return unusable generic types Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#14672 · 3 comments · 1 reaction · Opened Sep 3, 2025
`ET.Element.tag` does not allow comparision with `ET.Comment` Open

stubs: false positive

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python/typeshed#14671 · 2 comments · Opened Sep 3, 2025
Upstreaming stubs for `aiofiles` Open

stubs: removal

Difficulty 3/5 1-2 days Newbie friendliness 25/100

python/typeshed#14669 · 1 comment · Opened Sep 2, 2025
2 different `Dialect` types - one in `csv` module and other in `_csv` module Open

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

python/typeshed#14667 · 3 comments · Opened Aug 31, 2025
`collections.abc.Set` does not support `Iterable` s in some dunder methods Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

python/typeshed#14659 · 1 comment · Opened Aug 28, 2025
The types of `builtins.locals` and `types.FrameType.f_locals` aren't correct Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

python/typeshed#14584 · Opened Aug 17, 2025
How important is the `@_dispatchable` decorator in networkx? Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

python/typeshed#14462 · 6 comments · Opened Jul 26, 2025
networkx: type annotation needed for instantiating a graph Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python/typeshed#14389 · 8 comments · Opened Jul 9, 2025
`unittest.mock.patch` and `unittest.mock.patch.object` are wrongly typed when new_callable is provided Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

python/typeshed#14339 · 2 comments · Opened Jun 26, 2025
polymorphic overloads on `list.__add__` and `dict.__or__` lead to divergences in type checkers. Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#14283 · 1 comment · Opened Jun 16, 2025
`tarfile.TarFile` has several missing overloads Open

help wanted stubs: false negative

Difficulty 3/5 1-2 days Newbie friendliness 48/100

python/typeshed#14168 · 2 comments · 1 reaction · Opened May 27, 2025
Auto generate pyright test config Open

project: infrastructure

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#14052 · 1 reaction · Opened May 13, 2025
stub_uploader: verify external stub packages require runtime Open

project: infrastructure

Difficulty 5/5 Over a week Newbie friendliness 25/100

python/typeshed#14045 · 1 comment · Opened May 13, 2025
Finish incomplete modules Open

help wanted stubs: incomplete

Difficulty 4/5 3-5 days Newbie friendliness 48/100

python/typeshed#14031 · 3 comments · Opened May 12, 2025
Merge requirements-tests.txt into pyproject.toml? Open

project: infrastructure

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python/typeshed#13974 · 2 comments · 4 reactions · Opened May 9, 2025
function is lacking a `__signature__` attribute Open

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

python/typeshed#13953 · 1 comment · Opened May 6, 2025
json.dump/dumps shouldn't allow `Any` when `default` is None Open

stubs: false negative

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python/typeshed#13781 · 2 comments · Opened Apr 3, 2025
Type hint asyncio.Process streams (stdin, stdout, stderr) when created with values other than default None Open

stubs: false positive

Difficulty 4/5 3-5 days Newbie friendliness 42/100

python/typeshed#13714 · 3 comments · Opened Mar 24, 2025
Overly broad type inference when using zip(*x) to tranpose 2d iterable Open

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

python/typeshed#13708 · 1 comment · 1 reaction · Opened Mar 22, 2025
cachetools __wrapped__ Open

stubs: false positive

python/typeshed#13644 · 2 comments · 1 assignee · Opened Mar 17, 2025
Do we need --specified-platforms-only in stubtest_third_party? Open

project: infrastructure

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python/typeshed#13641 · 2 comments · Opened Mar 17, 2025
Strict equality not working between string and uuid Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python/typeshed#13632 · 10 comments · Opened Mar 13, 2025
[aiofiles] `aiofiles.tempfile.NamedTemporaryFile.name` should probably be a `str` Open

stubs: false positive

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

python/typeshed#13551 · 4 comments · Opened Feb 27, 2025
`[Async]ContextDecorator.__call__` return type should depend on the underlying context manager's `_ExitT_co` Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

python/typeshed#13512 · 4 comments · Opened Feb 18, 2025
More flexible type support for `math.prod` and `math.sumprod` Open

stubs: improvement

Difficulty 3/5 1-2 days Newbie friendliness 48/100

python/typeshed#13501 · 3 comments · Opened Feb 14, 2025
maximum arity of itertools.product() is hardcoded to 10. document, increase, or print a warning? Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python/typeshed#13490 · 11 comments · Opened Feb 10, 2025
[Typing] `batched` revealed type? Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python/typeshed#13470 · 7 comments · Opened Feb 6, 2025
Archive old packages on PyPI Open

project: infrastructure

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python/typeshed#13457 · 4 reactions · Opened Feb 3, 2025
Improve type hinting for `ContextDecorator` and `AsyncContextDecorator` Open

stubs: false positive

Difficulty 5/5 Over a week Newbie friendliness 25/100

python/typeshed#13403 · 7 comments · 1 reaction · Opened Jan 17, 2025
cachetools memoizing attributes (cache, key, lock) are not available Open

stubs: false positive

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python/typeshed#13395 · 2 comments · 1 reaction · Opened Jan 12, 2025
Should logging.Handler.lock allow None? Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

python/typeshed#13381 · 1 comment · Opened Jan 9, 2025
asyncio updates for Python 3.14 Open

status: deferred topic: asyncio

Difficulty 4/5 3-5 days Newbie friendliness 38/100

python/typeshed#13357 · 3 comments · Opened Jan 2, 2025
Shouldn't the return type of `__reversed__` be an `Iterable[T]` instead of `Iterator[T]`? Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#13218 · 8 comments · Opened Dec 7, 2024
Inconsistent dataclass declaration Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

python/typeshed#13189 · Opened Dec 4, 2024
`ZipFile.open()` return type Open

topic: io

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

python/typeshed#13051 · 1 comment · Opened Nov 20, 2024
BaseExceptionGroup should return ExceptionGroup if initialized with non-base exceptions Open

stubs: false positive

Difficulty 4/5 3-5 days Newbie friendliness 42/100

python/typeshed#12972 · 3 comments · Opened Nov 7, 2024
Stubtest docs: common failure/suppression examples + debugging guidance Open

project: infrastructure

Difficulty 3/5 1-2 days Newbie friendliness 52/100

python/typeshed#12962 · 3 reactions · Opened Nov 6, 2024
`@deprecated` overloads for invalid uses of `contextlib.ContextDecorator`? Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

python/typeshed#12881 · 3 comments · Opened Oct 23, 2024
Consistently mark types with `| MaybeNone` whenever it is applicable Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python/typeshed#12822 · 6 comments · 1 reaction · Opened Oct 16, 2024
Type annotation for itertools.zip_longest() lacks constraint on how many values in each tuple may match the fillvalue. Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

python/typeshed#12733 · 2 comments · Opened Oct 3, 2024
Should `None` be an acceptable `default_section` parameter of `configparser.ConfigParser` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python/typeshed#12700 · 1 comment · Opened Sep 28, 2024
Pin stubs to their corresponding upstream version Open

project: infrastructure

Difficulty 4/5 3-5 days Newbie friendliness 48/100

python/typeshed#12694 · 6 comments · 1 reaction · Opened Sep 26, 2024
`asyncio.Protocol.data_received` should also accept `bytearray` alongside `bytes` Open

topic: asyncio

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python/typeshed#12606 · 2 comments · Opened Aug 30, 2024
Use Docker to ensure local tests and CI pipeline tests agree? Open

project: infrastructure

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#12523 · 4 comments · Opened Aug 13, 2024
What is the correct way to subclass asyncio.StreamReader? Open

topic: asyncio

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python/typeshed#12423 · Opened Jul 24, 2024
Consistency with `Final` usage in Standard Library Stubs Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

python/typeshed#12311 · 3 comments · 2 reactions · Opened Jul 10, 2024

python/typeshed

Get new issues in your inbox