# Taplo: TOML Toolkit

`Taplo` is a versatile TOML toolkit, formatter, and linter written in Rust. It enforces strict, clean formatting and schema validation across all TOML configuration files.

## What It Does

`Taplo` parses and formats TOML documents with aligned key-value assignments, consistent 4-space indentation, and alphabetically sorted tables. It verifies TOML syntax and validates configuration files against JSON Schema definitions in milliseconds.

## Why It's in Zenith

Modern Python projects rely heavily on TOML across all tool configurations (`pyproject.toml`, `poe_tasks.toml`, `zensical.toml`, `ruff.toml`, `tach.toml`, `complexipy.toml`, `typos.toml`).

Zenith integrates Taplo to maintain universal formatting harmony across all repository manifests. By enabling `align_entries = true`, key-value assignments align vertically for visual clarity, while automated format inspections prevent unformatted configuration files from entering source control.

## Configuration in Zenith

Configured in `.taplo.toml` at the project root:

```toml
# ==============================================================================
# Taplo Configuration (.taplo.toml)
#
# Tool: Taplo (https://taplo.tamasfe.dev/)
# Purpose: A versatile TOML toolkit, linter, and code formatter.
# Why it's in Zenith: Enforces consistent 4-space indentation, aligned key-value
# entries, and table ordering across all project TOML configuration files.
# ==============================================================================

exclude = [
    ".agents/skills/**/templates/**",
    ".temp/**",
    ".venv/**",
    "build/**",
    "dist/**",
    "site/**",
]

[formatting]
    align_entries   = true
    compact_arrays  = true
    compact_entries = false
    indent_entries  = true
    indent_string   = "    "
    indent_tables   = true
    reorder_keys    = true
```

## Key Invocations

```bash
uv run taplo format --check  # Verify TOML formatting across the project
uv run taplo format          # Auto-format all TOML files
uv run poe format-check-toml # Wired task in Poe quality sequence
uv run poe format-toml       # Wired auto-formatting task in Poe
```

## Upstream Documentation

- [Taplo Documentation](<https://taplo.tamasfe.dev/>)
- [Taplo Configuration Reference](<https://taplo.tamasfe.dev/configuration/>)
- [TOML Specification](<https://toml.io/en/>)