TOML Validator & Linter#

Validate TOML syntax, run lint checks, compare files, and inspect structure. Supports pyproject.toml, Cargo.toml, and any TOML config.

Validate#

bash

# Basic syntax check
python3 scripts/toml_lint.py validate config.toml

# With lint checks (empty values, mixed arrays, etc.)
python3 scripts/toml_lint.py validate --lint pyproject.toml Cargo.toml

Diff Two Files#

bash

python3 scripts/toml_lint.py diff config-prod.toml config-staging.toml

Show Contents / Extract Key#

bash

# Pretty-print entire file
python3 scripts/toml_lint.py show pyproject.toml

# Extract specific key
python3 scripts/toml_lint.py show pyproject.toml --key tool.poetry.version

Type Tree#

bash

python3 scripts/toml_lint.py types Cargo.toml

Output Formats#

bash

python3 scripts/toml_lint.py -f json validate config.toml
python3 scripts/toml_lint.py -f markdown diff a.toml b.toml

Lint Checks#

CheckLevelDescriptionEmpty stringsWarningString values that are blankEmpty tablesWarningTables with no keysMixed-type arraysWarningArrays containing different typesEmpty arraysInfoArrays with no elementsSpaced keysInfoKeys containing spaces (valid but unusual)Long stringsInfoString values exceeding 1000 chars

Requirements#

• Python 3.11+ (has tomllib in stdlib)
• Or: pip install tomli for Python 3.10 and below