Ravenport: python-tomli

Subpackage Descriptions

single

[Build Status] [![codecov.io]](https://codecov.io/gh/hukkin/tomli) [PyPI version] # Tomli > A lil' TOML parser **Table of Contents** *generated with [mdformat-toc]* - [Intro] - [Installation] - [Usage] - [Parse a TOML string] - [Parse a TOML file] - [Handle invalid TOML] - [Construct `decimal.Decimal`s from TOML floats] - [Building a `tomli`/`tomllib` compatibility layer] - [FAQ] - [Why this parser?] - [Is comment preserving round-trip parsing supported?] - [Is there a `dumps`, `write` or `encode` function?] - [How do TOML types map into Python types?] - [Performance] ## Intro Tomli is a Python library for parsing [TOML]. It is fully compatible with [TOML v1.0.0]. A version of Tomli, the `tomllib` module, was added to the standard library in Python 3.11 via [PEP 680]. Tomli continues to provide a backport on PyPI for Python versions where the standard library module is not available and that have not yet reached their end-of-life. ## Installation `bash pip install tomli ` ## Usage ### Parse a TOML string ```python import tomli toml_str = """ [[players]] name = "Lehtinen" number = 26 [[players]] name = "Numminen" number = 27 """ toml_dict = tomli.loads(toml_str) assert toml_dict == { "players": [{"name": "Lehtinen", "number": 26}, {"name": "Numminen", "number": 27}] } ``` ### Parse a TOML file ```python import tomli with open("path_to_file/conf.toml", "rb") as f: toml_dict = tomli.load(f) ``` The file must be opened in binary mode (with the `"rb"` flag). Binary mode will enforce decoding the file as UTF-8 with universal newlines disabled, both of which are required to correctly parse TOML. ### Handle invalid TOML ```python import tomli try: toml_dict = tomli.loads("]] this is invalid TOML [[") except tomli.TOMLDecodeError: print("Yep, definitely not valid.") ``` Note that error messages are considered informational only. They should not be assumed to stay constant across Tomli versions. ### Construct `decimal.Decimal`s from TOML floats

Port variant	v11
Summary	Lil' TOML parser (3.11)
BROKEN
Package version	2.0.2
Homepage	https://github.com/hukkin/tomli
Keywords	python
Maintainer	Python Automaton
License	Not yet specified
Other variants	v12
Ravenports	Buildsheet \| History
Ravensource	Port Directory \| History
Last modified	12 OCT 2024, 19:09:16 UTC
Port created	19 JUL 2021, 04:13:17 UTC

Build (only)	python-pip:single:v11 autoselect-python:single:std
Build and Runtime	python311:single:std