tmt
Test management and execution framework
TLDR
List tests, plans, and stories
$ tmt
Initialize project structure$ tmt init
Create test with template$ tmt test create -t [beakerlib] --link [verifies:issue#1234]
List tests/plans/stories$ tmt [test|plan|story] ls [pattern]
Show test metadata with context$ tmt -c [arch=aarch64] test show
Validate tmt files$ tmt lint
Use filter$ tmt tests ls -f [tag:foo] -f [tier:0]
SYNOPSIS
tmt [OPTIONS] COMMAND [ARGS]
DESCRIPTION
tmt (Test Management Tool) is a framework for creating, organizing, and executing tests. It uses metadata in YAML format to define tests, plans, and stories, enabling reproducible test execution across different environments.
PARAMETERS
-c, --context KEY=VALUE
Set context for operations-f, --filter EXPRESSION
Filter items-t, --template NAME
Use template for creation
COMMANDS
init
Initialize tmt project structuretest [create|ls|show]
Manage testsplan [ls|show]
Manage test plansstory [ls|show]
Manage storiesrun
Execute testslint
Validate tmt filestry
Try tests interactively
CAVEATS
Requires proper tmt file structure. Tests run in containers by default. Complex plans may require additional provisioning setup.
HISTORY
tmt was developed by Red Hat for managing tests across Fedora and RHEL, providing a unified test metadata format and execution framework.
