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

Add bound Hashable for types for keys of type Mapping and values of type Set Open

status: deferred

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

python/typeshed#9571 · 7 comments · 2 reactions · Opened Jan 20, 2023
Improving the type signature of `setattr` Open

status: deferred

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

python/typeshed#9410 · 2 comments · Opened Dec 26, 2022
Work on merging annotations from types-pika (a non-typeshed project) into typeshed's pika stubs Open

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

python/typeshed#9246 · 15 comments · Opened Nov 22, 2022
type annotated arguments in zip function lead to wrong return types when using the star operator Open

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

python/typeshed#9143 · 4 comments · 1 reaction · Opened Nov 9, 2022
Track review of `bytes` types Open

python/typeshed#9006 · 10 comments · 1 assignee · Opened Oct 28, 2022
Add unit tests for scripts in `tests/` and `scripts/` Open

project: infrastructure

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

python/typeshed#8841 · 1 reaction · Opened Oct 4, 2022
functools.partial should use PEP612 ParamSpec (depends on #8708) Open

status: deferred

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

python/typeshed#8703 · 8 comments · 7 reactions · Opened Sep 7, 2022
Add overloads for `argparse.ArgumentParser.parse_x_args()` Open

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

python/typeshed#8538 · 7 comments · Opened Aug 12, 2022
Cachetools timer with datetime.now Open

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

python/typeshed#8459 · 2 comments · 1 reaction · Opened Aug 1, 2022
`ChainMap` has wrong or unintuitive type after #6042 Open

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

python/typeshed#8430 · 2 comments · 5 reactions · Opened Jul 28, 2022
How to handle typechecker specific bugs Open

project: policy

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

python/typeshed#8403 · 3 comments · Opened Jul 26, 2022
Change METADATA.toml "dependencies" into internal and external Open

project: infrastructure

python/typeshed#8312 · 8 comments · 5 reactions · 1 assignee · Opened Jul 15, 2022
enum auto must not be derived from IntFlag Open

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

python/typeshed#8286 · 4 comments · 9 reactions · Opened Jul 13, 2022
Is there a good reason why `Mapping.__contains__` expects `object`, but `Mapping.get` expects a strict type? Open

stubs: false negative

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

python/typeshed#8219 · 2 comments · Opened Jun 30, 2022
Opaque type for io.TextIOWrapper seek and tell? Open

topic: io

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

python/typeshed#7921 · 1 comment · 1 reaction · Opened May 22, 2022
zip vararg Open

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

python/typeshed#10651 · 2 comments · 2 reactions · Opened May 20, 2022
`tempfile.NamedTemporaryFile`'s return type (`_TemporaryFileWrapper`) has any attribute Open

topic: io

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

python/typeshed#7840 · 2 comments · 1 reaction · Opened May 16, 2022
concurrent.futures: Bad signature for Executor.submit() under Python <= 3.8 Open

Difficulty 1/5 Under an hour Newbie friendliness 45/100

python/typeshed#7750 · 14 comments · Opened Apr 30, 2022
Add a pyright-primer Open

project: policy

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

python/typeshed#7642 · 6 comments · 4 reactions · Opened Apr 16, 2022
Remove type checker-specific symbols from builtins.pyi and typing.pyi Open

stubs: improvement

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

python/typeshed#7580 · 22 comments · 3 reactions · Opened Apr 3, 2022
Implications of Union in argparse.Action.__call__ parameter types Open

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

python/typeshed#7559 · 1 comment · Opened Mar 27, 2022
mock.patch.object type annotation fails with **kwargs Open

stubs: false positive

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

python/typeshed#7542 · 2 comments · Opened Mar 24, 2022
Pygments `Formatter.__init__` overloads do not work as intended Open

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

python/typeshed#7436 · 9 comments · Opened Mar 4, 2022
Incorrect type declaration for `http.server.BaseHTTPRequestHandler.__init__` Open

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

python/typeshed#7160 · 2 comments · Opened Feb 8, 2022
set[str].discard(str | None) Open

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

python/typeshed#7121 · 3 comments · 2 reactions · Opened Feb 3, 2022
Automatization idea: find duplicated constants Open

project: policy

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

python/typeshed#7067 · 1 reaction · Opened Jan 28, 2022
`functools.lru_cache` wrapped function with TypeVar has wrong return type. Open

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

python/typeshed#6987 · Opened Jan 21, 2022
argparse type=bool Open

stubs: false negative

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

python/typeshed#6821 · 2 comments · Opened Jan 4, 2022
`configparser.RawConfigParser` stub does not account for non-string options Open

stubs: false positive

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

python/typeshed#6820 · 3 comments · Opened Jan 4, 2022
Unify typing for `__path__`? Open

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

python/typeshed#6650 · 1 comment · Opened Dec 21, 2021
mypy@0.920 regression: Argument 1 to "get" of "Mapping" has incompatible type Open

stubs: false positive

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

python/typeshed#6597 · 8 comments · 2 reactions · Opened Dec 16, 2021
Decouple collections.abc types from typing aliases Open

stubs: improvement

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

python/typeshed#6257 · 11 comments · 2 reactions · Opened Nov 8, 2021
Should `object.__hash__` be `Callable[[], int] | None` if `None` is a valid and common usage? Open

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

python/typeshed#6243 · 2 comments · Opened Nov 5, 2021
Literal based overloads for asyncio transport Open

topic: asyncio

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

python/typeshed#6210 · 1 comment · Opened Oct 28, 2021
subprocess stdout read1 Open

stubs: false positive topic: io

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

python/typeshed#6153 · 2 comments · Opened Oct 11, 2021
`bool()` return type on with no arguments Open

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

python/typeshed#6069 · 13 comments · Opened Sep 24, 2021
dict.__init__() and dict.update() don't match Open

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

python/typeshed#6056 · 1 comment · Opened Sep 20, 2021
Distribute stdlib types as types-stdlib Open

project: policy

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

python/typeshed#5835 · 10 comments · 3 reactions · Opened Aug 2, 2021
singledispatch and TypeVar return type Open

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

python/typeshed#5560 · 3 comments · 1 reaction · Opened May 31, 2021
Thoughts about type hints in the standard library Open

project: policy

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

python/typeshed#5444 · 7 comments · Opened May 14, 2021
Awaitable.__await__ expects a Generator where an Iterator will do Open

status: deferred stubs: false positive

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

python/typeshed#5125 · 3 comments · Opened Mar 16, 2021
unittest.mock.patch(): Use `class` for `DEFAULT` Open

python/typeshed#4968 · 1 assignee · Opened Jan 24, 2021
Should stubs contain docstrings? Open

project: policy

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

python/typeshed#4881 · 21 comments · 3 reactions · Opened Dec 31, 2020
Problems using SimpleXMLRPCServer.register_function Open

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

python/typeshed#4837 · 2 comments · Opened Dec 18, 2020
"class property" should be Generic[T] Open

stubs: improvement

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

python/typeshed#4731 · 7 comments · 6 reactions · Opened Oct 30, 2020
Good ways to contribute Open

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

python/typeshed#4641 · 3 comments · 22 reactions · Opened Oct 10, 2020
Improve multiprocessing stubs Open

stubs: improvement

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

python/typeshed#4266 · 16 comments · 3 reactions · Opened Jun 26, 2020
Fix various inheritances Open

help wanted

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

python/typeshed#3968 · 3 comments · Opened May 6, 2020
subprocess.Popen: overloads for set stdin/stdout/stderr attributes? Open

topic: io

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

python/typeshed#3831 · 4 comments · 7 reactions · Opened Mar 7, 2020
dict.update has incorrect variance for one of its overloads Open

stubs: false positive

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

python/typeshed#3551 · 3 comments · Opened Dec 20, 2019

python/typeshed

Get new issues in your inbox