tenzir-test is the reusable test harness that powers the
Tenzir project. It discovers test scenarios
and Python fixtures, prepares the execution environment, and produces artifacts
you can diff against established baselines.
- 🔍 Auto-discovers tests, inputs, and configuration across both project and package layouts, including linked satellite projects.
- 🧩 Supports configurable runners and reusable fixtures so you can tailor how scenarios execute and share setup logic.
- 🛠️ Provides a
tenzir-testCLI for orchestrating suites, updating baselines, and inspecting artifacts.
Install the latest release from PyPI with uvx—tenzir-test requires Python
3.12 or newer:
uvx tenzir-test --helpuvx downloads the newest compatible release, runs it in an isolated
environment, and caches subsequent invocations for fast reuse.
Consult our user guide for an end-to-end walkthrough of writing tests.
We also provide a dense reference that explains concepts, configuration, multi-project execution, and CLI details.
Contributor workflows, quality gates, and release procedures live in
DEVELOPMENT.md. Follow that guide when you work on the
project locally.
New versions are published to PyPI through trusted publishing when a GitHub release is created. Review the latest release notes on GitHub for details about what's new.
tenzir-test is available under the Apache License, Version 2.0. See
LICENSE for details.