Bump version to 0.1.21
1 file changed
tree: a4cc636d0733acac3fcce8c12b050acfb1cf6edf
  1. pytoml/
  2. test/
  3. .gitignore
  4. .gitmodules
  5. .travis.yml
  6. dev-requirements.txt
  8. MANIFEST.in
  9. README.md
  10. setup.cfg
  11. setup.py
  12. tox.ini

PyPI Build Status


The pytoml project is no longer being actively maintained. Consider using the toml package instead.


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.7+ and 3.5+.


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/test.py