tomlrt¶

A format-preserving TOML reader and writer for Python.

Parse a document, edit it, dump it, and the bytes you didn't touch round-trip exactly — comments, whitespace, string style, and number formatting all intact.

Supports TOML 1.1.

import tomlrt

with open("pyproject.toml", "rb") as f:
    doc = tomlrt.load(f)

doc["project"]["version"] = "0.2.0"
doc["project"]["dependencies"].append("requests>=2")

print(tomlrt.dumps(doc))   # comments and layout are preserved

Where next¶

• Quickstart — parse, edit, dump.
• Reading documents — look up values and convert to plain Python.
• Building documents — construct a Document from scratch or from a dict, and choose table and array forms.
• Editing documents — set, replace, remove, and copy values.
• Comments — read and write comments.
• Layout — sort keys, arrange tables and arrays, and format spacing.
• Errors — exception types.
• API reference — classes, methods, and options.