---
id: toml
version: "0.10.2"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# toml — Python Library for Tom's Obvious, Minimal Language

License: permissive · Maintenance: dormant · Popularity: top 1,000 on PyPI

## Install

pip install toml
uv add toml
poetry add toml

## Description

****
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>`_.

See also:

* `The TOML Standard <https://github.com/toml-lang/toml>`_
* `The currently supported TOML specification <https://github.com/toml-lang/toml/blob/v0.5.0/README.md>`_

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....

## AI interpretation — verify before relying

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

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.

[View on SkillFed](https://skillfed.io/packages/toml) · [View on PyPI](https://pypi.org/project/toml/)