toml

Python Library for Tom's Obvious, Minimal Language

toml Permissive license MIT DORMANT ★ 1,136 v0.10.2 released 2020-11-01

Install

toml on PyPI

pip

pip install toml

uv

uv add toml

poetry

poetry add toml

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,111 days since the last release
Last repo commit	2024-06-26
First released	2013-02-24
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: toml-0.10.2-py2.py3-none-any.whl

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

About toml

from the package's own PyPI description — quoted content, verbatim

TOML

.. image:: https://img.shields.io/pypi/v/toml :target: https://pypi.org/project/toml/

.. image:: https://travis-ci.org/uiri/toml.svg?branch=master :target: https://travis-ci.org/uiri/toml

.. image:: https://img.shields.io/pypi/pyversions/toml.svg :target: https://pypi.org/project/toml/

A Python library for parsing and creating TOML <https://en.wikipedia.org/wiki/TOML>_.

The module passes the TOML test suite <https://github.com/BurntSushi/toml-test>_.

Installation

To install the latest release on PyPI <https://pypi.org/project/toml/>_, simply run:

pip install toml

Or to install the latest development version, run:

git clone https://github.com/uiri/toml.git cd toml python setup.py install

Quick Tutorial

toml.loads takes in a string containing standard TOML-formatted data and returns a dictionary containing the parsed data.

.. code:: pycon

>>> import toml >>> toml_string = """ ... # This is a TOML document....

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Parse and generate TOML configuration files, converting between TOML-formatted strings/files and Python dictionaries.

Installs cleanly with no runtime dependencies. Maintenance is dormant—last release was 2020-11-01 and the repository has not been updated since 2024-06-26—but the package is marked Production/Stable and passes the official TOML test suite.

Released under the MIT License (permissive), which allows free use, modification, and distribution with minimal restrictions.

Usage

pip install toml

import toml

toml_string = 'title = "Example"'
parsed = toml.loads(toml_string)
output = toml.dumps(parsed)

Verdict: A stable, zero-dependency TOML parser suitable for reading and writing configuration files. No known vulnerabilities and broad Python version support (2.6+, 3.3+). Dormant maintenance is a minor concern for long-term support, but the implementation is mature and passes the official test suite.

Needs verification

Whether dormant status affects real-world compatibility with TOML spec updates or Python 3.10+ features
Performance characteristics relative to alternative TOML libraries for large configuration files

toml parser pythonparse toml filestoml configuration readertoml to dict convertergenerate toml outputtoml serialization