Rhiza Tools Documentation

Extra utilities and tools for the Rhiza ecosystem.

What is Rhiza Tools?

rhiza-tools provides CLI commands for the Rhiza ecosystem, including version bumping, release management, benchmark analysis, and documentation helpers. It can be used as a plugin for rhiza-cli or as a standalone tool.

Installation

As a Rhiza Plugin (Recommended)

uvx "rhiza[tools]" tools --help

Standalone

pip install rhiza-tools

Commands

Command	Description
bump	Bump the project version using semantic versioning
release	Push a release tag to trigger the release workflow
rollback	Rollback a release and/or version bump
update-readme	Update README.md with make help output
generate-coverage-badge	Generate a coverage badge JSON file
version-matrix	Emit supported Python versions as JSON
analyze-benchmarks	Analyze and visualise benchmark results

Quick Start

# Install the project
make install

# Run tests
make test

# Bump version interactively
rhiza-tools bump

# Release
rhiza-tools release --with-bump --push

Further Reading

• Configuration — .rhiza/.cfg.toml reference and customization
• Releasing — bump and release workflow with flowcharts
• API Reference — module and function documentation
• Rhiza Framework Docs — architecture, customization, glossary, and more