rtoml

What it is and what it does

rtoml is a TOML parser and serializer for Python, implemented in Rust for performance. It provides four main functions: load() and loads() to parse TOML from files or strings into Python dictionaries, and dump() and dumps() to serialize Python objects back to TOML format. The library includes flexible None-value handling—you can control which TOML values map to Python None and how None values are serialized back to TOML.

The package is built on the stable toml-rs Rust library and passes all standard TOML compliance tests. It offers no runtime dependencies and is available as prebuilt wheels for Python 3.10+ on Linux, macOS, and Windows across multiple architectures. Installation is straightforward on supported platforms; unsupported platforms require a Rust compiler.

Use it for:

• Parse configuration files in TOML format into Python dicts for application settings.
• Serialize Python data structures to TOML and write them to disk for configuration storage.
• Handle TOML with None values by mapping a custom sentinel string (e.g., '@None') to represent nulls.
• Build tools or utilities that need fast, standards-compliant TOML parsing without external dependencies.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

rtoml parses and serializes TOML files and strings to and from Python dictionaries, with support for flexible None-value handling and optional pretty-printing.

Yes, if you need TOML parsing on Python 3.10+ and have a supported platform with prebuilt wheels. The library is stable, has no runtime dependencies, passes all TOML compliance tests, and offers strong performance. However, note that maintenance is aging (last release 299 days ago), so verify that the package still meets your needs and check whether prebuilt wheels exist for your architecture before committing to it.

Install

rtoml on PyPI

pip install rtoml

uv add rtoml

poetry add rtoml

Installing rtoml

Before you install

Medium install friction due to compiled wheels; prebuilt binaries are available for common platforms (Linux, macOS, Windows across multiple architectures), but installation from source requires Rust stable if no binary matches your system. Last release was 299 days ago; maintenance status is aging.

License in practice

MIT license is permissive, allowing commercial and private use with minimal restrictions—standard for open-source libraries.

Quickstart

pip install rtoml

import rtoml

# Parse TOML string
data = rtoml.loads('title = "Example"')

# Serialize to TOML
toml_str = rtoml.dumps({'title': 'Example'})

Requires Python 3.10 or later. If no prebuilt wheel is available for your platform, Rust stable must be installed to build from source.

Verify before relying

• Current maintenance status and likelihood of future updates beyond the 299-day gap since last release.
• Whether prebuilt wheels cover all platforms you need (check PyPI files for your architecture).

Package facts

Evidence: rtoml-0.13.0-cp310-cp310-macosx_10_12_x86_64.whl; rtoml-0.13.0-cp310-cp310-macosx_11_0_arm64.whl; rtoml-0.13.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; rtoml-0.13.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; rtoml-0.13.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; rtoml-0.13.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl; rtoml-0.13.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; rtoml-0.13.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl; rtoml-0.13.0-cp310-cp310-musllinux_1_1_aarch64.whl; rtoml-0.13.0-cp310-cp310-musllinux_1_1_x86_64.whl; rtoml-0.13.0-cp310-cp310-win32.whl; rtoml-0.13.0-cp310-cp310-win_amd64.whl; rtoml-0.13.0-cp311-cp311-macosx_10_12_x86_64.whl; rtoml-0.13.0-cp311-cp311-macosx_11_0_arm64.whl; rtoml-0.13.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; rtoml-0.13.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; rtoml-0.13.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; rtoml-0.13.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl; rtoml-0.13.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; rtoml-0.13.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl

Tags

More Python Modules packages