tomllib em Python: como ler arquivos TOML

Sat, 10 Oct 2026 00:00:00 +0000

O módulo tomllib do Python lê arquivos TOML — incluindo o pyproject.toml que virou padrão de projeto — direto da biblioteca padrão, sem instalar nada, a partir do Python 3.11. Ele é a escolha certa para ler configurações, metadados de projetos e arquivos gerados por ferramentas como uv, Poetry e Ruff. A limitação importante: tomllib só faz leitura; para escrever TOML você precisa da biblioteca externa tomli-w.

A regra prática é: tomllib.load(arquivo_binario) para ler um arquivo e tomllib.loads(texto) para ler uma string. O resultado é sempre um dicionário Python comum, com tipos nativos preservados — números continuam int ou float, booleanos continuam bool e datas viram objetos datetime. Este guia mostra o uso completo com exemplos executáveis.

Tomllib on Python Dev BR

tomllib em Python: como ler arquivos TOML