2025-03-14 21:59:59 -06:00
|
|
|
# tmt
|
|
|
|
|
|
|
|
|
|
> Test Management Tool for creating, running, and debugging tests.
|
|
|
|
|
> Some subcommands such as `run`, `try`, etc. have their own usage documentation.
|
2025-12-16 10:20:31 -07:00
|
|
|
> More information: <https://tmt.readthedocs.io/en/stable/examples.html>.
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- List available tests, plans, and stories:
|
|
|
|
|
|
|
|
|
|
`tmt`
|
|
|
|
|
|
|
|
|
|
- Initialize tmt files/project structure:
|
|
|
|
|
|
|
|
|
|
`tmt init`
|
|
|
|
|
|
|
|
|
|
- Create a new test with a template and a link:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt test create {{[-t|--template]}} {{beakerlib}} --link {{verifies:issue#1234}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- List available tests, plans, or stories:
|
|
|
|
|
|
|
|
|
|
`tmt {{test|plan|story}} ls {{pattern}}`
|
|
|
|
|
|
|
|
|
|
- Show detailed test metadata in the given context:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt {{[-c|--context]}} {{arch=aarch64}} test show`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Validate tmt files against the specification:
|
|
|
|
|
|
|
|
|
|
`tmt lint`
|
|
|
|
|
|
|
|
|
|
- Use filter:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt tests ls {{[-f|--filter]}} {{tag:foo}} {{[-f|--filter]}} {{tier:0}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Display help:
|
|
|
|
|
|
|
|
|
|
`tmt --help`
|