LinuxCommandLibrary

tmt

Test management and execution framework

TLDR

List tests, plans, and stories

$ tmt
copy
Initialize project structure
$ tmt init
copy
Create test with template
$ tmt test create -t [beakerlib] --link [verifies:issue#1234]
copy
List tests/plans/stories
$ tmt [test|plan|story] ls [pattern]
copy
Show test metadata with context
$ tmt -c [arch=aarch64] test show
copy
Validate tmt files
$ tmt lint
copy
Use filter
$ tmt tests ls -f [tag:foo] -f [tier:0]
copy

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 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

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.

SEE ALSO

beakerlib(1), podman(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community