types-setuptools
Typing stubs for setuptools
Decision gist · record as of 2026-08-14
Yes, if you use a type checker (mypy, pyright, etc.) on code that imports setuptools. It requires Python 3.10+ and adds no runtime cost. Install it as a dev dependency to gain type safety on build and packaging code. If you do not use type checking or only target older Python versions, it is unnecessary.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Type checking is a development-time tool; this package does not affect runtime behavior.
- Very low friction—a pure stub package with no runtime dependencies, distributed as a wheel.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 is permissive; you can use this package freely in commercial and open-source projects without significant legal constraints.
last release 2026-08-12 (2 days) · last repo commit 2026-08-13 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 34,170,583 downloads/mo, #762 on PyPI
Alternatives
Verify before relying
pip install types-setuptools
# In your code, type checkers will now understand setuptools imports:
import setuptools
setuptools.setup(name='example')- Whether this stub version remains accurate as setuptools 84.0.* evolves beyond the commit it was generated from.
- Coverage completeness for all setuptools 84.0.* public API surface relative to the tested type checkers.
What it is and what it does
types-setuptools is a type stub package that bridges the gap between setuptools and static type checkers. It provides type annotations for setuptools so that tools like mypy, pyright, and others can validate code that imports or calls setuptools functions without runtime errors. Since setuptools itself is not fully typed, this stub package—maintained as part of the typeshed project—offers the annotations type checkers need to understand setuptools' API.
The package is a pure stub distribution with no runtime dependencies; it exists only to inform type checkers during development. It targets setuptools version 84.0.* and has been tested against mypy 2.3.0, pyright 1.1.411, and other checkers. Installation is straightforward and adds no overhead to your application.
Use it for
- Enable mypy or pyright to type-check build scripts that call setuptools.setup() or other setuptools functions.
- Catch type errors in custom setup.py or pyproject.toml configuration code before runtime.
- Support IDE autocompletion and inline documentation for setuptools APIs in editors that use type stubs.
- Validate plugin or extension code that programmatically interacts with setuptools entry points or configuration.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use a type checker (mypy, pyright, etc.) on code that imports setuptools.
It requires Python 3.10+ and adds no runtime cost. Install it as a dev dependency to gain type safety on build and packaging code. If you do not use type checking or only target older Python versions, it is unnecessary.
Install
types-setuptools on PyPI
Before you install
Very low friction—a pure stub package with no runtime dependencies, distributed as a wheel. Maintained actively as part of typeshed, released frequently to track setuptools versions.
Requires Python 3.10 or later. Type checking is a development-time tool; this package does not affect runtime behavior.
License in practice
Apache-2.0 is permissive; you can use this package freely in commercial and open-source projects without significant legal constraints.
Quickstart
pip install types-setuptools
# In your code, type checkers will now understand setuptools imports:
import setuptools
setuptools.setup(name='example')Verify before relying
- Whether this stub version remains accurate as setuptools 84.0.* evolves beyond the commit it was generated from.
- Coverage completeness for all setuptools 84.0.* public API surface relative to the tested type checkers.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 34,170,583 / month, #762 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Typing :: Stubs Only |
Evidence: types_setuptools-84.0.0.20260812-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “type stubs setuptools”
- types-setuptoolsProvides type annotations for the setuptools package, enabling type…
- setuptools-protobufA setuptools plugin that automates compilation of protobuf files…
- wheywhey is a PEP 517 build backend that creates Python wheels from…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Provides type stubs for pyinstaller, enabling type checkers like mypy and pyright to validate code that uses pyinstaller.
Provides type annotations for the geopandas library, enabling static type checkers like mypy and pyright to validate code that uses geopandas.
Provides type stubs for the dateparser package, enabling static type checkers like mypy, pyright, and others to validate code that uses dateparser for date parsing.
Provides type annotations for the python-dateutil library, enabling type checkers like mypy and pyright to validate code that uses date and time utilities.
Provides complete external type annotations for lxml, enabling static type checking and IDE support for code using lxml's XML and HTML processing functionality.
Install it if you use lxml and rely on type checking or IDE support.
Provides type hints for the docker package, enabling static type checkers like mypy and pyright to validate code that uses the Docker Python client.
See also types-tqdm · types-regex · types-networkx · types-mypy-extensions