TOML Kit - Style-preserving TOML library for Python

TOML Kit is a 1.0.0rc1-compliant TOML library.

It includes a parser that preserves all comments, indentations, whitespace and internal element ordering, and makes them accessible and editable via an intuitive API.

You can also create new TOML documents from scratch using the provided helpers.

Part of the implementation as been adapted, improved and fixed from Molten.

Usage

Parsing

TOML Kit comes with a fast and style-preserving parser to help you access the content of TOML files and strings.

>>> from tomlkit import dumps
>>> from tomlkit import parse  # you can also use loads

>>> content = """[table]
... foo = "bar"  # String
... """
>>> doc = parse(content)

# doc is a TOMLDocument instance that holds all the information
# about the TOML string.
# It behaves like a standard dictionary.

>>> assert doc["table"]["foo"] == "bar"

# The string generated from the document is exactly the same
# as the original string
>>> assert dumps(doc) == content

Modifying

TOML Kit provides an intuitive API to modify TOML documents.

>>> from tomlkit import dumps
>>> from tomlkit import parse
>>> from tomlkit import table

>>> doc = parse("""[table]
... foo = "bar"  # String
... """)

>>> doc["table"]["baz"] = 13

>>> dumps(doc)
"""[table]
foo = "bar"  # String
baz = 13
"""

# Add a new table
>>> tab = table()
>>> tab.add("array", [1, 2, 3])

>>> doc["table2"] = tab

>>> dumps(doc)
"""[table]
foo = "bar"  # String
baz = 13

[table2]
array = [1, 2, 3]
"""

# Remove the newly added table
>>> doc.remove("table2")
# del doc["table2] is also possible

Writing

You can also write a new TOML document from scratch.

Let's say we want to create this following document:

# This is a TOML document.

title = "TOML Example"

[owner]
name = "Tom Preston-Werner"
organization = "GitHub"
bio = "GitHub Cofounder & CEO\nLikes tater tots and beer."
dob = 1979-05-27T07:32:00Z # First class dates? Why not?

[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true

It can be created with the following code:

>>> from tomlkit import comment
>>> from tomlkit import document
>>> from tomlkit import nl
>>> from tomlkit import table

>>> doc = document()
>>> doc.add(comment("This is a TOML document."))
>>> doc.add(nl())
>>> doc.add("title", "TOML Example")
# Using doc["title"] = "TOML Example" is also possible

>>> owner = table()
>>> owner.add("name", "Tom Preston-Werner")
>>> owner.add("organization", "GitHub")
>>> owner.add("bio", "GitHub Cofounder & CEO\nLikes tater tots and beer.")
>>> owner.add("dob", datetime(1979, 5, 27, 7, 32, tzinfo=utc))
>>> owner["dob"].comment("First class dates? Why not?")

# Adding the table to the document
>>> doc.add("owner", owner)

>>> database = table()
>>> database["server"] = "192.168.1.1"
>>> database["ports"] = [8001, 8001, 8002]
>>> database["connection_max"] = 5000
>>> database["enabled"] = True

>>> doc["database"] = database

Installation

If you are using Poetry, add tomlkit to your pyproject.toml file by using:

poetry add tomlkit

If not, you can use pip:

pip install tomlkit

Download files

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

Source Distribution

tomlkit-0.7.2.tar.gz (159.6 kB view details)

Uploaded May 20, 2021 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

tomlkit-0.7.2-py2.py3-none-any.whl (32.6 kB view details)

Uploaded May 20, 2021 Python 2Python 3

File details

Details for the file tomlkit-0.7.2.tar.gz.

File metadata

Download URL: tomlkit-0.7.2.tar.gz
Upload date: May 20, 2021
Size: 159.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.1.6 CPython/3.9.5 Linux/5.4.0-1047-azure

File hashes

Hashes for tomlkit-0.7.2.tar.gz
Algorithm	Hash digest
SHA256	`d7a454f319a7e9bd2e249f239168729327e4dd2d27b17dc68be264ad1ce36754`
MD5	`f754c55df5edfbb7395903061825e09e`
BLAKE2b-256	`65ed7b7216101bc48627b630693b03392f33827901b81d4e1360a76515e3abc4`

See more details on using hashes here.

File details

Details for the file tomlkit-0.7.2-py2.py3-none-any.whl.

File metadata

Download URL: tomlkit-0.7.2-py2.py3-none-any.whl
Upload date: May 20, 2021
Size: 32.6 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.1.6 CPython/3.9.5 Linux/5.4.0-1047-azure

File hashes

Hashes for tomlkit-0.7.2-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`173ad840fa5d2aac140528ca1933c29791b79a374a0861a80347f42ec9328117`
MD5	`686218bda9d607449135d365c144e48d`
BLAKE2b-256	`ebef5bd27c1a8040874cc863c263bf38857b5607017b656943c6c93b29bc8f42`