Clone this repo:
  1. 4245607 Merge pull request #31 from raphlinus/master by Martin Vejnár · 3 months ago master
  2. ed6ae5e Add support for keys being literal strings by Raph Levien · 4 months ago
  3. 270397b Bump version to 0.1.13. by Martin Vejnár · 4 months ago v0.1.13
  4. 45b1221 Merge pull request #30 from mwilliamson/non-finite-float-errors by Martin Vejnár · 4 months ago
  5. 3cc8cc1 Raise error when dump is called with non-finite floats by Michael Williamson · 5 months ago

Build Status


This project aims at being a specs-conforming and strict parser and writer for TOML files. The library currently supports version 0.4.0 of the specs and runs with Python 2.6+ and 3.3+.


pip install pytoml

The interface is the same as for the standard json package.

>>> import pytoml as toml
>>> toml.loads('a = 1')
{'a': 1}
>>> with open('file.toml', 'rb') as fin:
...     obj = toml.load(fin)
>>> obj
{'a': 1}

The loads function accepts either a bytes object (that gets decoded as UTF-8 with no BOM allowed), or a unicode object.

Use dump or dumps to serialize a dict into TOML.

>>> print toml.dumps(obj)
a = 1


To run the tests update the toml-test submodule:

$ git submodule update --init --recursive

Then run the tests:

$ python test/