Qst provides multiple command-line commands. They can be invoked as qst <command name>. The following commands are available:
run
Executes a test case or a test project and outputs the results.
qst run [options]
The run
command executes a Qst .qml file containing a :cppTestcase
or a :cppProject
component. The file is specified by the -f
option.
-d, --working-directory <path>
Use <path> as working directory during test case execution. If the directory does not exist, it is being created. By default, a directory with the name .<project-name>-<profile-name>-<hash> is created in the current path.
-f, --file <file>
Use <file> as project file. If <file> is a directory and contains a single file ending in .qml, that file will be used. If this option is not given at all, the behavior is the same as for --file ./
.
-h, --help
Displays this help.
-I, --import <path>
Add <path> as a directory where the engine searches for installed modules in a URL-based directory structure.
The path may be a local file system directory, a Qt Resource path (:/imports), a Qt Resource url (qrc:/imports) or a URL.
-p, --profile <name>
Load a profile <usage_profiles>
from <name>.json and attach it to the QML root context. Matching profiles are searched in the directories specified by -P
or in the project directory or in the config directory's profile sub-directory (in this order).
-P, --profile-directory <path>
When looking for profiles <usage_profiles>
, search first in <path>. This option might be given multiple times.
Prints the version of Qst to stdout.
qst version
Prints the version of Qst to stdout.
This command takes no options.