python / python/typeshed

Standard library `_operator` module is poorly typed

Open
#15,611 15 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
5.1k
Forks
2.1k
Avg merge
1d 19h
Merged PRs (30d)
82

Description

The annotations for functions in the _operator module are inconsistent - some have annotations but most don't.

At first glance, most of the protocols necessary to type these incomplete signatures can be imported from _typeshed, and there is already a precedent in the stub in question.

I can work on the annotations to bridge the inconsistency, but it would be a big undertaking, so I need to get approval first.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with stdlib/_operator.pyi, especially the existing annotations referenced in the issue, and review the relevant protocols available from _typeshed. Compare the annotated and incomplete signatures, then verify that the module’s functions have consistent typing coverage and that the stub remains compatible with the standard library.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
devtools
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.