troml 🥁

troml provides a list of potential classifiers that could be added to a Python package.

It supports modern Python packages that use the pyproject.toml standard (aka PEP 621 and PEP 639). troml also follows PEP 561 to determine whether a package should be considered typed or not.

Usage

uvx

uv is an extremely fast Python package and project manager, written in Rust. uvx is an alias for uv tool run ....

1. Install uv
2. Go to a directory with source code for a Python package
3. uvx troml

pipx

pipx is a way to run install and run Python applications in isolated environments.

1. Install pipx
2. pipx install troml
3. Go to a directory with source code for a Python package
4. troml

pip --user

Install troml to the Python user install directory. More details in the pip docs.

1. pip install --user troml
2. Go to a directory with source code for a Python package
3. troml

CLI arguments

path

troml optionally accepts a path as the first argument. Defaults to . for the current directory.

uvx troml /path/to/pypyproject.toml

suggest

Provides an output of suggested classifiers. The default if no other command is used.

uvx troml suggest /path/to/pypyproject.toml

--fix

Automatically add classifiers in the pyproject.toml based on the suggestions. Will not remove existing classifiers.

uvx troml suggest --fix /path/to/pypyproject.toml

--no-multiline

Output the classifiers in a single-line. No-op if used without --fix.

uvx troml suggest --fix --multiline /path/to/pypyproject.toml

check

Exits with an error code if there are any suggested classifiers. Useful for pre-commit, CI/CD, etc.

uvx troml check /path/to/pypyproject.toml

Supported classifiers

Python version

troml will read project.python-requires and suggest classifiers based on it.

License (deprecated)

troml will suggest removing the legacy license classifiers.

Dependencies

troml will suggest classifiers based on the dependencies in project.dependencies, project.dependency-groups, and tool.uv.constraint-dependencies.

Typing

troml will suggest the "Typing :: Typed" classifier based on the existence of the py.typed file in the same directory as the pyproject.toml file.

FAQ

Does this add classifiers interactively?

Nope and it's not something I would add in. Take a look at https://codeberg.org/kfdm/add-classifiers or https://github.com/jvllmr/trove-setup if that's what you are looking for.

What's with the name?

• The classifiers for Python are called "Trove classifiers"
• Modern Python packages use TOML for configuration

"trove" 🤝 "TOML"

In a happy coincidence, "trommel" in Dutch means "drum".

Development

1. Install just: https://just.systems/man/en/packages.html
2. just fetch

Run from source

uv run troml [PATH-TO-PYPROJECT-TOML]

Commands

• unit tests (via pytest): just test
• linting (via ruff): just lint
• type checking (via mypy): just type
• unit test coverage (via coverage.py): just coverage
• run 'em all: just dev

Inspiration

• https://indieweb.social/@adamghill/115174743670090084
• another approach from @kfdm: https://codeberg.org/kfdm/add-classifiers
• post about add-classifers: https://paultraylor.net/blog/2025/add-classifiers/
• https://github.com/jvllmr/trove-setup
• https://pypi.org/project/typer/ for creating the CLI