types-toml
Typing stubs for toml
Decision gist · record as of 2026-08-14
Yes, if you use toml and run static type checking. Install it as a development dependency alongside toml to get full type coverage. It has no runtime cost, is actively maintained, and solves the common problem of type checkers not understanding untyped libraries.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Low install friction with no runtime dependencies.
- Actively maintained as part of typeshed; last commit 2026-08-13 and release 88 days ago.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in most projects without restriction.
last release 2026-05-18 (88 days) · last repo commit 2026-08-13 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 68,669,896 downloads/mo, #478 on PyPI
Alternatives
Verify before relying
pip install types-toml
# In your code, import toml normally; type checkers will use the stubs
import toml
config = toml.load('config.toml')- Whether the stubs cover all toml 0.10.* versions or only specific patch releases.
- Whether this package is automatically installed as a dependency of toml or must be installed separately.
What it is and what it does
types-toml is a type stub package that bridges the gap between the untyped toml library and Python's static type checkers. It provides type annotations for the toml package so that tools like mypy and pyright can understand and validate code that uses toml's functions and classes. The stubs are maintained as part of the typeshed project, the canonical repository of type information for the Python standard library and popular third-party packages.
When installed alongside toml, this package allows your type checker to catch errors like passing the wrong argument types to toml functions or accessing non-existent attributes on parsed TOML objects. It has no runtime dependencies and adds no overhead to your application—it is purely a development-time aid for static analysis.
Use it for
- Enable mypy or pyright to type-check code that calls toml.load() or toml.loads().
- Catch type errors in configuration parsing before runtime in a CI/CD pipeline.
- Provide IDE autocomplete and type hints when working with toml objects in an editor.
- Enforce consistent TOML handling patterns across a team using strict type checking.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use toml and run static type checking.
Install it as a development dependency alongside toml to get full type coverage. It has no runtime cost, is actively maintained, and solves the common problem of type checkers not understanding untyped libraries.
Install
types-toml on PyPI
Before you install
Low install friction with no runtime dependencies. Actively maintained as part of typeshed; last commit 2026-08-13 and release 88 days ago.
Requires Python 3.10 or later.
License in practice
Apache-2.0 permissive license allows use in most projects without restriction.
Quickstart
pip install types-toml
# In your code, import toml normally; type checkers will use the stubs
import toml
config = toml.load('config.toml')Verify before relying
- Whether the stubs cover all toml 0.10.* versions or only specific patch releases.
- Whether this package is automatically installed as a dependency of toml or must be installed separately.
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 88 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 68,669,896 / month, #478 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_toml-0.10.8.20260518-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 › “toml type stubs”
- types-tomlProvides type hints for the toml package, enabling static type…
- msgspecmsgspec encodes and decodes JSON, MessagePack, YAML, and TOML with…
- msgspec-mmsgspec-m is a fast serialization and validation library supporting…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Provides type hints for the html5lib HTML parser, enabling static type checkers like mypy and pyright to validate code that uses html5lib.
Provides type hints for the jsonschema package, enabling static type checkers like mypy and pyright to validate code that uses jsonschema.
Provides type annotations for the psutil library, enabling type checkers like mypy and pyright to validate code that uses psutil for system and process monitoring.
Provides type hints for the pysftp package, enabling static type checkers like mypy and pyright to validate code that uses pysftp for SFTP operations.
Provides type hints for the tabulate package, enabling static type checkers like mypy and pyright to validate code that formats data into tables.
Provides type annotations for the xmltodict package, enabling static type checkers like mypy and pyright to validate code that parses XML into Python dictionaries.
See also types-aiofiles · types-PySocks · types-uWSGI · types-xlrd