larztoml

TOML read and write. Pure Python (back to 3.8), zero dependencies.

The standard library gained tomllib in 3.11 — but it only reads, and only on new Pythons. larztoml both parses and serializes TOML, on any supported Python, with no dependency.

from larztoml import loads, dumps

cfg = loads("""
title = "myapp"

[server]
host = "localhost"
port = 8080
tags = ["a", "b"]

[[user]]
name = "Ada"
""")

dumps(cfg)      # back to TOML text

Why

• It writes. dumps() is the piece tomllib doesn't have — generate config files, not just read them.
• Works everywhere. Python 3.8+, not just 3.11+.
• Real TOML. [tables], [[arrays of tables]], nested and dotted keys, typed values (strings incl. literal/multiline, ints/floats with _ and hex/oct/bin, inf/nan, bools, dates and datetimes), arrays (including multi-line), inline tables, and comments.
• Zero dependencies. No toml, no tomli/tomli-w.

Install

pip install larztoml

Usage

from larztoml import loads, dumps

data = loads(open("pyproject.toml").read())
text = dumps({"tool": {"app": {"port": 8080, "hosts": ["a", "b"]}}})

Dates parse to datetime/date/time; numbers keep their type. Round-trips: loads(dumps(obj)) == obj for the supported subset.

Tests

python -m unittest discover -s tests -v   # 21 tests incl. dump round-trips

The Larz stack

One of 30+ pure-Python, zero-dependency libraries at github.com/larz-scripter — pairs with larzconf and larzyaml.

License

MIT © larz-scripter