toml
Python Library for Tom's Obvious, Minimal Language
Decision gist · record as of 2026-08-14
Yes. toml is a stable, zero-dependency library for TOML parsing and generation that is widely used (top 1000 on PyPI) and has no known vulnerabilities. Its dormant maintenance status is not a concern because TOML parsing is a well-defined, feature-complete task and the package passes the official test suite. Install it if you need to read or write TOML files in Python.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Installs with no dependencies and low friction.
- Maintenance is dormant—last release was 2020-11-01 and last commit 2024-06-26—but the package is marked Production/Stable and passes the TOML test suite, suggesting it is feature-complete rather than abandoned.
License · maintenance · safety
MIT (permissive) — Released under the MIT License, a permissive open-source license with no restrictions on use, modification, or distribution in commercial or proprietary projects.
last release 2020-11-01 (2112 days) · last repo commit 2024-06-26 · 1,136 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 176,194,404 downloads/mo, #238 on PyPI
Alternatives
Verify before relying
pip install toml
import toml
toml_string = 'title = "Example"\n[section]\nkey = "value"'
parsed = toml.loads(toml_string)
output = toml.dumps(parsed)- Whether dormant maintenance status poses a risk for future TOML specification updates or Python version compatibility.
- Whether the package handles all edge cases in the current TOML specification or only the v0.5.0 version it targets.
What it is and what it does
toml is a pure-Python library for parsing TOML (Tom's Obvious, Minimal Language) configuration files and serializing Python dictionaries back to TOML format. It provides four main functions: toml.load() and toml.loads() to read TOML from files or strings into dictionaries, and toml.dump() and toml.dumps() to write dictionaries back to TOML format. The library passes the TOML test suite and supports both Python 2 and Python 3 across multiple versions.
The package has no runtime dependencies, making it lightweight and easy to integrate into any project that needs to read or write TOML configuration files. It includes a TomlNumpyEncoder for handling NumPy data types when serializing. With no external dependencies and a stable API, it is suitable for applications that need straightforward TOML I/O without additional complexity.
Use it for
- Read configuration files in TOML format into Python dictionaries for application startup or settings management.
- Serialize Python configuration objects back to TOML files for saving user preferences or deployment settings.
- Parse pyproject.toml or similar build-tool configuration files in Python-based build systems or package managers.
- Convert between TOML and Python data structures in CLI tools or configuration management utilities.
- Handle NumPy arrays in TOML output by using the TomlNumpyEncoder for scientific computing workflows.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
toml is a stable, zero-dependency library for TOML parsing and generation that is widely used (top 1000 on PyPI) and has no known vulnerabilities. Its dormant maintenance status is not a concern because TOML parsing is a well-defined, feature-complete task and the package passes the official test suite. Install it if you need to read or write TOML files in Python.
Install
toml on PyPI
Before you install
Installs with no dependencies and low friction. Maintenance is dormant—last release was 2020-11-01 and last commit 2024-06-26—but the package is marked Production/Stable and passes the TOML test suite, suggesting it is feature-complete rather than abandoned.
License in practice
Released under the MIT License, a permissive open-source license with no restrictions on use, modification, or distribution in commercial or proprietary projects.
Quickstart
pip install toml
import toml
toml_string = 'title = "Example"\n[section]\nkey = "value"'
parsed = toml.loads(toml_string)
output = toml.dumps(parsed)Verify before relying
- Whether dormant maintenance status poses a risk for future TOML specification updates or Python version compatibility.
- Whether the package handles all edge cases in the current TOML specification or only the v0.5.0 version it targets.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=2.6, !=3.0.*, !=3.1.*, !=3.2.* |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 2,112 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 176,194,404 / month, #238 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.6Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy |
Evidence: toml-0.10.2-py2.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 › “parse toml files”
- tomlParses and generates TOML configuration files, converting between…
- pytomlParses and writes TOML configuration files with a JSON-like…
- tree-sitter-tomlProvides a tree-sitter parser grammar for TOML files, enabling…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Parses and writes TOML configuration files with a JSON-like interface, supporting TOML version 0.4.0.
rtoml parses and serializes TOML files and strings to and from Python dictionaries, with support for flexible None-value handling and optional pretty-printing.
However, note that maintenance is aging (last release 299 days ago), so verify that the package still meets your needs and check whether prebuilt wheels exist for…
Command-line utility and Python library to sort and format TOML files while preserving comments and standardizing whitespace.
A high-performance TOML parser and serializer for Python, written in Rust, with drop-in compatibility for most tomllib use cases and support for TOML v1.0.0 and v1.1.0.
Provides utilities and helpers for working with TOML configuration files, building on top of tomli to simplify parsing and manipulation of TOML data in Python.
Provides type hints for the toml package, enabling static type checkers like mypy and pyright to validate code that parses or manipulates TOML configuration files.