A lil' TOML parser
Project description
Tomli
A lil' TOML parser
Tomli is a Python library for parsing TOML. Tomli is fully compatible with TOML v1.0.0.
Installation
pip install tomli
Usage
Parse a TOML string
import tomli
toml_str = """
gretzky = 99
[kurri]
jari = 17
"""
toml_dict = tomli.loads(toml_str)
assert toml_dict == {"gretzky": 99, "kurri": {"jari": 17}}
Handle invalid TOML
import tomli
try:
toml_dict = tomli.loads("]] this is invalid TOML [[")
except tomli.TOMLDecodeError:
print("Yep, definitely not valid.")
FAQ
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
Release history Release notifications | RSS feed
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)
Built Distribution
tomli-0.2.0-py3-none-any.whl
(8.6 kB
view hashes)