TOML Kit - Style-preserving TOML library for Python
TOML Kit is a 1.1.0-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 has been adapted, improved and fixed from Molten.
Usage
See the documentation for more information.
Limitations
tomlkit preserves the original layout of a document, with one exception: a
sub-table that extends an array of tables out of order — for example a
[fruit.apple.texture] header that appears after [[fruit]] with an unrelated
table in between — is normalized into the array's last element when the document
is re-serialized, rather than kept at its original position. The data is
preserved; only the physical placement of that sub-table changes.
Installation
If you are using uv, you can
add tomlkit to your pyproject.toml file by using:
uv add tomlkit
Or just:
uv pip install tomlkit
If not, you can use pip:
pip install tomlkit
Running tests
Please clone the repo with submodules with the following command:
git clone --recurse-submodules https://github.com/python-poetry/tomlkit.git
The toml-test submodule is required for running the tests.
You can then run the tests with
poetry run pytest -q tests
1 maintainer
Metadata
1 maintainer
Release files for tomlkit 0.15.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tomlkit-0.15.2.tar.gz | 190.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tomlkit-0.15.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 242.7 kB
Release files / tomlkit-0.15.2.tar.gz
| Download URL | tomlkit-0.15.2.tar.gz |
|---|---|
| Size | 190.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
83e32755ba1d20d9340bd069ee97e9f6232ba2346b63ffcba425de01f7e327a6
|
|
BLAKE2b-256 checksum How to use checksums |
0872fc01563df95c189a9f65850096bdc205bc2fe37da6c740cd64afaf18d07e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
Release files / tomlkit-0.15.2-py3-none-any.whl
| Download URL | tomlkit-0.15.2-py3-none-any.whl |
|---|---|
| Size | 52.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
05562412163a3037b94497385fb7f9204c637bc605af7a48199e41cf2272f437
|
|
BLAKE2b-256 checksum How to use checksums |
da467d84138a60a8bd796825b2d38ebe92d0d16501ca57d501b7c5d677401bbc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
