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

Run all tests in a container

$ tmt run

Use filter

$ tmt tests ls -f [tag:foo] -f [tier:0]

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 structure

test [create|ls|show]

Manage tests

plan [ls|show]

Manage test plans

story [ls|show]

Manage stories

run

Execute tests

lint

Validate tmt files

try

Try tests interactively

INSTALL

sudo dnf install tmt

brew install tmt

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.

tmt