diff --git a/pages/linux/tmt-run.md b/pages/linux/tmt-run.md new file mode 100644 index 000000000..33f94fe69 --- /dev/null +++ b/pages/linux/tmt-run.md @@ -0,0 +1,36 @@ +# tmt run + +> Execute tmt test steps. By default, all steps are run. +> More information: . + +- Run all test steps for each plan: + +`tmt run` + +- Run only the discover step to show what tests would be run: + +`tmt run discover -v` + +- Run all steps and adjust the provision step options: + +`tmt run --all provision --how {{container}} --image {{fedora:rawhide}}` + +- Run only selected plans and tests: + +`tmt run plan --name {{/plan/name}} test --name {{/test/name}}` + +- Show results from the last run in a web browser: + +`tmt run --last report --how {{html}} --open` + +- Run tests with the provided context: + +`tmt run --context {{key=value}} -c {{distro=fedora}}` + +- Run tests interactively (debug test code in the middle of a test): + +`tmt run --all execute --how {{tmt}} --interactive` + +- Use dry mode to see what actions would happen and use the highest verbosity: + +`tmt run --dry -vvv` diff --git a/pages/linux/tmt-try.md b/pages/linux/tmt-try.md new file mode 100644 index 000000000..cf0b4b9cb --- /dev/null +++ b/pages/linux/tmt-try.md @@ -0,0 +1,36 @@ +# tmt try + +> Quickly experiment with tests and environments. +> More information: . + +- Quickly experiment with the default provision method (no tests in the CWD): + +`tmt try` + +- Run a test in the current working directory: + +`cd {{path/to/test}} && tmt try` + +- Use a specific operating system: + +`tmt try {{fedora-41}}` + +- Select both custom image and provision method: + +`tmt try {{fedora@container}}` + +- Select tests with custom filter: + +`tmt try --test {{feature}}` + +- Provision guest and wait for instructions: + +`tmt try --ask` + +- Directly log into the guest without asking: + +`tmt try --login` + +- Display help: + +`tmt try --help` diff --git a/pages/linux/tmt.md b/pages/linux/tmt.md new file mode 100644 index 000000000..b8a15e786 --- /dev/null +++ b/pages/linux/tmt.md @@ -0,0 +1,37 @@ +# tmt + +> Test Management Tool for creating, running, and debugging tests. +> Some subcommands such as `run`, `try`, etc. have their own usage documentation. +> More information: . + +- List available tests, plans, and stories: + +`tmt` + +- Initialize tmt files/project structure: + +`tmt init` + +- Create a new test with a template and a link: + +`tmt test create --template {{beakerlib}} --link {{verifies:issue#1234}}` + +- List available tests, plans, or stories: + +`tmt {{test|plan|story}} ls {{pattern}}` + +- Show detailed test metadata in the given context: + +`tmt --context {{arch=aarch64}} test show` + +- Validate tmt files against the specification: + +`tmt lint` + +- Use filter: + +`tmt tests ls --filter {{tag:foo}} --filter {{tier:0}}` + +- Display help: + +`tmt --help`