Skip to main content

A lil' TOML parser

Project description

Build Status PyPI version


A lil' TOML parser

Tomli is a Python library for parsing TOML. Tomli is fully compatible with TOML v1.0.0.


pip install tomli


Parse a TOML string

import tomli

toml_str = """
gretzky = 99

jari = 17

toml_dict = tomli.loads(toml_str)
assert toml_dict == {"gretzky": 99, "kurri": {"jari": 17}}

Handle invalid TOML

import tomli

    toml_dict = tomli.loads("]] this is invalid TOML [[")
except tomli.TOMLDecodeError:
    print("Yep, definitely not valid.")


Why this parser?

  • it's lil'
  • fairly fast (but pure Python so can't do any miracles there)
  • 100% spec compliance: passes all tests in a test set soon to be merged to the official compliance tests for TOML repository

Is comment preserving round-trip parsing supported?

No. The tomli.loads function returns a plain dict that is populated with builtin types and types from the standard library only (list, int, str, datetime.datetime etc.). Preserving comments requires a custom type to be returned so will not be supported, at least not by the tomli.loads function.

Is there a dumps, write or encode function?

Not yet, and it's possible there never will be.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tomli-0.2.0.tar.gz (10.1 kB view hashes)

Uploaded Source

Built Distribution

tomli-0.2.0-py3-none-any.whl (8.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page