tox-toml-fmt
Format your pyproject.toml file
Decision gist · record as of 2026-08-14
Yes, if you manage tox.toml files and want consistent formatting with minimal configuration overhead. The tool is actively maintained, has no known vulnerabilities, and uses a permissive license. Install via pipx or uv to avoid dependency conflicts. Not necessary if you have no tox.toml files or prefer manual formatting.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or higher; recommended installation via pipx or uv to avoid system-wide dependency conflicts.
- Medium install friction due to compiled wheels across multiple platforms and Python versions (3.10+).
- Active maintenance with recent releases; last commit 2026-08-12 and 85 repository stars indicate ongoing support.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive) allows use in most projects without restriction.
last release 2026-05-05 (101 days) · last repo commit 2026-08-12 · 85 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 242,800 downloads/mo, #8,838 on PyPI
Alternatives
Verify before relying
# Install via pipx (recommended)
pipx install tox-toml-fmt
# Or as a Python module
from tox_toml_fmt import run
exit_code = run(["path/to/tox.toml"])- Exact behavior differences between CLI, pre-commit hook, and programmatic Python API usage
- Performance characteristics on large or deeply nested tox.toml files
- Compatibility with non-standard TOML extensions or vendor-specific tox configurations
What it is and what it does
tox-toml-fmt is a command-line tool and Python library that reformats tox.toml files according to a fixed set of opinionated rules, similar to how black formats Python code. It normalizes string quotes, key formatting, array layout, and table structure while preserving comments. The tool supports minimal configuration (column width, indentation, pinned environments) and can be used standalone, integrated as a pre-commit hook, or called programmatically from Python code.
The formatter runs on Python 3.10 and higher and is distributed as compiled wheels for multiple platforms. It depends on toml-fmt-common for shared formatting logic. Recent updates include support for free-threaded Python wheels and fixes for empty table handling.
Use it for
- Enforce consistent formatting across tox.toml files in a monorepo or team project
- Integrate as a pre-commit hook to automatically format tox.toml on every commit
- Programmatically format tox.toml files in build or CI/CD automation scripts
- Standardize tox configuration style without manual configuration of dozens of formatting rules
- Reduce diff noise in code reviews by applying deterministic formatting rules
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you manage tox.toml files and want consistent formatting with minimal configuration overhead.
The tool is actively maintained, has no known vulnerabilities, and uses a permissive license. Install via pipx or uv to avoid dependency conflicts. Not necessary if you have no tox.toml files or prefer manual formatting.
Install
tox-toml-fmt on PyPI
Before you install
Medium install friction due to compiled wheels across multiple platforms and Python versions (3.10+). Active maintenance with recent releases; last commit 2026-08-12 and 85 repository stars indicate ongoing support.
Requires Python 3.10 or higher; recommended installation via pipx or uv to avoid system-wide dependency conflicts.
License in practice
MIT license (permissive) allows use in most projects without restriction.
Quickstart
# Install via pipx (recommended)
pipx install tox-toml-fmt
# Or as a Python module
from tox_toml_fmt import run
exit_code = run(["path/to/tox.toml"])Verify before relying
- Exact behavior differences between CLI, pre-commit hook, and programmatic Python API usage
- Performance characteristics on large or deeply nested tox.toml files
- Compatibility with non-standard TOML extensions or vendor-specific tox configurations
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 1 packagetoml-fmt-common |
| Maintenance | Actively maintained 101 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 242,800 / month, #8,838 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Python :: Free Threading :: 1 - Unstable |
Evidence: tox_toml_fmt-1.9.3-cp310-abi3-macosx_10_12_x86_64.whl; tox_toml_fmt-1.9.3-cp310-abi3-macosx_11_0_arm64.whl; tox_toml_fmt-1.9.3-cp310-abi3-manylinux_2_28_aarch64.whl; tox_toml_fmt-1.9.3-cp310-abi3-manylinux_2_28_x86_64.whl; tox_toml_fmt-1.9.3-cp310-abi3-manylinux_2_31_riscv64.whl; tox_toml_fmt-1.9.3-cp310-abi3-musllinux_1_2_x86_64.whl; tox_toml_fmt-1.9.3-cp310-abi3-win_amd64.whl; tox_toml_fmt-1.9.3-cp313-cp313t-macosx_10_12_x86_64.whl; tox_toml_fmt-1.9.3-cp313-cp313t-macosx_11_0_arm64.whl; tox_toml_fmt-1.9.3-cp313-cp313t-manylinux_2_28_aarch64.whl; tox_toml_fmt-1.9.3-cp313-cp313t-manylinux_2_28_x86_64.whl; tox_toml_fmt-1.9.3-cp313-cp313t-musllinux_1_2_x86_64.whl; tox_toml_fmt-1.9.3-cp313-cp313t-win_amd64.whl; tox_toml_fmt-1.9.3-cp314-cp314t-macosx_10_12_x86_64.whl; tox_toml_fmt-1.9.3-cp314-cp314t-macosx_11_0_arm64.whl; tox_toml_fmt-1.9.3-cp314-cp314t-manylinux_2_28_aarch64.whl; tox_toml_fmt-1.9.3-cp314-cp314t-manylinux_2_28_x86_64.whl; tox_toml_fmt-1.9.3-cp314-cp314t-musllinux_1_2_x86_64.whl; tox_toml_fmt-1.9.3-cp314-cp314t-win_amd64.whl; tox_toml_fmt-1.9.3-cp315-cp315t-macosx_10_12_x86_64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “tox.toml formatter”
- tox-toml-fmtFormats tox.toml files with consistent style and comment…
- gersemigersemi is a command-line formatter for CMake code that automatically…
- mdformatMdformat is a CommonMark-compliant command-line Markdown formatter…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also pyproject-fmt · toml-fmt-common · toml-sort · tomlkit · yamlfix · tomlrt · tombi · tomli-w · perky · mdformat-black