4. qmtest create-tdb

4.1. Summary

Create a new test database.

4.2. Synopsis

qmtest create-tdb [ option ...]

4.3. Description

The qmtest create-tdb command creates a new, empty test database. A test database is a directory in which QMTest stores configuration files, tests, and other data. Certain test database classes may also store data elsewhere, such as in an external relational database.

The test database is created in the directory specified by --tdb (-D) option or by setting the QMTEST_DB_PATH environment variable. If no database path is specified, QMTest assumes that the current directory is the test database.

By default, QMTest creates a new test database that uses the standard XML-based implementation. (See Section 5, “Writing Database Classes” for information about writing a test database class.)

The create-tdb command accepts these options:

-a name=value, --attribute name=value

Set the database attribute name to value. The set of attribute names and valid values is dependent on the database class in use. The default database class accepts no attributes.

-c class, --class class

Use the test database class given by class. The class may have the general form described in Section 2, “qmtest create. Once you create a test database, you cannot change the test database implementation it uses. If you do not use this option, QMTest will use the default test database implementation, which uses an XML file format to store tests.