pytest switches installed by QA plugin
The QA plugin installs several pytest command-line switches. When you run pytest --help
,
they are listed in Firebird QA
section:
Firebird QA:
--server=SERVER Server configuration name
--bin-dir=PATH Path to directory with Firebird utilities
--protocol={xnet,inet,inet4,wnet}
Network protocol used for database attachments
--runslow Run slow tests
--save-output Save test std[out|err] output to files
--skip-deselected={platform,version,any}
SKIP tests instead deselection
--extend-xml Extend XML JUnit report with additional information
--install-terminal Use our own terminal reporter
server
REQUIRED option. Section name in firebird-driver.conf
with connection parameters for
tested server.
bin-dir
Normally, the QA plugin detects and properly sets the directory where Firebird tools are
installed. However, you can set this directory explicitly using the --bin-dir
switch.
protocol
Override for network protocol specified in firebird-driver.conf
file (or default).
runslow
Tests that run for longer than 10 minutes on equipment used for regular Firebird QA are
marked as slow
. They are not executed, unless this switch is specified.
Note
Currently, there are no slow tests in Firebird test suite.
save-output
Experimental switch
When this switch is specified, stdout/stderr output of external Firebird tool executed by
test is stored in /out
subdirectory. Intended for test debugging.
skip-deselected
Tests that are not applicable to tested server (because they are for specific platform or
Firebird versions) are deselected during pytest collection phase. It means that they are
not shown in test session report. This switch changes the routine, so tests are marked to
skip (with message explaining why) instead deselection, so they show up is session report.
extend-xml
When this switch is used together with --junitxml
switch, the produced JUnitXML file
will contain additional metadata for testsuite
and testcase
elements recorded as
property
sub-elements.
Important
Please note that using this feature will break schema verifications for the latest
JUnitXML schema. This might be a problem when used with some CI servers.
install-terminal
This option changes default pytest terminal reporter that displays pytest NODE IDs, to custom
reporter that displays Firebord QA test IDs.
pytest node IDs are of the form module.py::class::method
or module.py::function
.
Firebord QA test IDs are defined in our test metadata.
Important
Right now, the custom terminal is opt-in
feature. This will be changed in some future
release to opt-out
using new switch.