Command-line interface

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.

Synopsis

qst run [options]

Description

The run command executes a Qst .qml file containing a Testcase or a Project component. The file is specified by the -f option.

Options

-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 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, search first in <path>. This option might be given multiple times.

version

Prints the version of Qst to stdout.

Synopsis

qst version

Description

Prints the version of Qst to stdout.

Options

This command takes no options.