qacli validate project

Create and delete Validate projects on the Validate server.

Usage

validate project  {-C <Validate project/stream>|-D <Validate project/stream>|-b <Validate project/stream>} -U <[protocol://]host:port> [-E <encoding type>] [-f] [-d] [--] [-h]

Extended Description

This command enables you to create and delete Validate projects on the named Validate server. You must have been previously authenticated on the server (see qacli auth) and the user must have the appropriate permissions on the server to create/delete projects.

Options

Name, shorthand Default Description
‑‑create, ‑C  

Create a new, empty Validate project with the specified name.

You can also create a new stream of an existing project. Note that the parent project and any specified parent streams must already exist before creating a child stream

‑‑delete, ‑D  

Delete the specified Validate project and all its builds from the projects list and the Validate database.

The project data is unrecoverable once it's been deleted.
‑‑detail, ‑d   Output additional build information, such as build tags.
‑‑encoding, ‑E   Encoding of the source files used in the project. The default is your system encoding.
‑‑force, ‑f  

Delete project even if it contains streams.
‑‑help, ‑h  

Displays usage information and exits.
‑‑ignore‑rest, ‑‑   Ignores the rest of the labeled arguments following this flag.
‑‑list‑build, ‑b   List the builds of the specified Validate project.
‑‑url, ‑U  

URL of the results server. By default the http protocol is assumed.

Examples include: localhost:80, 127.0.0.1:8080, https://prometheus:8888

Examples

Creating a Validate Project

The following will create a Validate project called "matrix" on the Validate server:

qacli validate project --url https://prometheus:8888 --create matrix

This example uses the default system encoding. To use a specific encoding, you can add the ‑‑encoding option, as such:

qacli validate project -U https://prometheus:8888 -C matrix -E UTF-8

Creating a Validate Stream

The following will create a stream for an existing Validate project:

qacli validate project --url https://prometheus:8888 --create matrix/stream_1

If the project does not exist, then this operation will fail.

Deleting a Validate Stream

This command will delete the stream called "matrix/stream_1": 

qacli validate project --url https://prometheus:8888 --delete matrix/stream_1

Although the stream will be deleted, the parent project, "matrix", will remain.

Exercise extreme caution when using this command, as deleted streams can not be recovered.

Deleting a Validate Project

This command will delete the project called "matrix":

qacli validate project --url https://prometheus:8888 --delete matrix

If you supply the optional ‑‑force parameter, then any associated streams will also be deleted from the Validate server.

Exercise extreme caution when using this command, as deleted projects can not be recovered.

Listing Builds of a Validate Project

This command will list builds of the project called "matrix":

qacli validate project --url https://prometheus:8888 --list-builds matrix

If you supply the optional ‑‑detail parameter, then additional information is shown, such as the build tags (see qacli upload --tags).