Class QMTest

Construct a new QMTest.

Parses the argument list but does not execute the command.

'argument_list' -- The arguments to QMTest, not including the initial argv[0].

'path' -- The path to the QMTest executable.

Return true if 'option' was specified as a global command.

'command' -- The long name of the option, but without the preceding "--".

returns -- True if the option is present.

Return the value of command 'option'.

'option' -- The long form of an command-specific option.

'default' -- The default value to be returned if the 'option' was not specified. This option should be the kind of an option that takes an argument.

returns -- The value specified by the option, or 'default' if the option was not specified.

Execute the command.

returns -- 0 if the command was executed successfully. 1 if there was a problem or if any tests run had unexpected outcomes.

Return the test database to use.

returns -- The 'Database' to use for this execution. Raises an exception if no 'Database' is available.

Return the test database to use.

returns -- The 'Database' to use for this execution, or 'None' if no 'Database' is available.

Return the path to the file containing target specifications.

returns -- The path to the file containing target specifications.

Return the 'Target's specified in 'file_name'.

returns -- A list of the 'Target' objects specified in the target specification file 'file_name'.

Return the 'Target' objects specified by the user.

returns -- A sequence of 'Target' objects.

Return the 'Tracer' associated with this instance of QMTest.

returns -- The 'Tracer' associated with this instance of QMTest.

Return the path to the QMTest executable.

returns -- A string giving the path to the QMTest executable. This is the path that should be used to invoke QMTest recursively. Returns 'None' if the path to the QMTest executable is uknown.

Return the 'ResultStream' class used for results files.

returns -- The 'ResultStream' class used for results files.

Return the 'ResultStream' class used for textual feedback.

returns -- the 'ResultStream' class used for textual feedback.

version_option_spec

Value:

None, "version", None, "Display version information."

db_path_option_spec

Value:

"D", "tdb", "PATH", "Path to the test database."

extension_output_option_spec

Value:

"o", "output", "FILE", "Write the extension to FILE.",

extension_id_option_spec

Value:

"i", "id", "NAME", "Write the extension to the database as NAME.",

output_option_spec

Value:

"o", "output", "FILE", "Write test results to FILE (- for stdout)."

no_output_option_spec

Value:

None, "no-output", None, "Don't generate test results."

outcomes_option_spec

Value:

"O", "outcomes", "FILE", "Use expected outcomes in FILE."

expectations_option_spec

Value:

"e", "expectations", "FILE", "Use expectations in FILE."

context_option_spec

Value:

"c", "context", "KEY=VALUE", "Add or override a context property."

context_file_spec

Value:

"C", "load-context", "FILE", "Read context from a file (- for stdin)."

no_browser_option_spec

Value:

None, "no-browser", None, "Do not open a new browser window."

pid_file_option_spec

Value:

None, "pid-file", "PATH", "Process ID file name."

concurrent_option_spec

Value:

"j", "concurrency", "COUNT", "Execute tests in COUNT concurrent thread s."

targets_option_spec

Value:

"T", "targets", "FILE", "Use FILE as the target specification file."

random_option_spec

Value:

None, "random", None, "Run the tests in a random order."

rerun_option_spec

Value:

None, "rerun", "FILE", "Rerun the tests that failed."

seed_option_spec

Value:

None, "seed", "INTEGER", "Seed the random number generator."

format_option_spec

Value:

"f", "format", "FORMAT", "Specify the summary format."

result_stream_spec

Value:

None, "result-stream", "CLASS-NAME", "Specify the results file format. "

annotation_option_spec

Value:

"a", "annotate", "NAME=VALUE", "Set an additional annotation to be wri tten to the result stream(s)."

tdb_class_option_spec

Value:

"c", "class", "CLASS-NAME", "Specify the test database class.",

attribute_option_spec

Value:

"a", "attribute", "NAME", "Get an attribute of the extension class."

set_attribute_option_spec

Value:

"a", "attribute", "KEY=VALUE", "Set an attribute of the extension clas s."

extension_kind_option_spec

Value:

"k", "kind", "EXTENSION-KIND", "Specify the kind of extension class."

report_output_option_spec

Value:

"o", "output", "FILE", "Write test report to FILE (- for stdout)."

report_flat_option_spec

Value:

"f", "flat", None, """Generate a flat listing of test results, instead of reproducing the database directory tree in the report."""

results_option_spec

Value:

"R", "results", "DIRECTORY", "Read in all results (*.qmr) files from D IRECTORY."

list_long_option_spec

Value:

"l", "long", None, "Use a detailed output format."

list_details_option_spec

Value:

"d", "details", None, "Display details for individual items."

list_recursive_option_spec

Value:

"R", "recursive", None, "Recursively list the contents of directories. "

conflicting_option_specs

Value:

output_option_spec, no_output_option_spec, (concurrent_option_spec, ta rgets_option_spec), (extension_output_option_spec, extension_id_option _spec), (expectations_option_spec, outcomes_option_spec),

global_options_spec

Value:

[help_option_spec, version_option_spec, db_path_option_spec,]

commands_spec

Value:

[("create", "Create (or update) an extension.", "EXTENSION-KIND CLASS- NAME(ATTR1 = 'VAL1', ATTR2 = 'VAL2', ...)", """Create (or update) an e xtension. The EXTENSION-KIND indicates what kind of extension to create; it must be one of """+ __extension_kinds_string+ """. The CLASS-NAME indicates the name of the extension class, or ...