| Command-line Options |
  |
The usual way to invoke getest is as follows:
getest filename
where filename is the configuration file used to run the
test. If getest is invoked with no filename but the file
getest.cfg exists, then:
getest
is equivalent to:
getest getest.cfg
Alternatively the configuration filename can be specified by
the environment variable $GETEST_CONFIG:
setenv GETEST_CONFIG filename
getest
(setenv is the way to
set environment variables with C-shell, please use the command
provided by your favorite shell or operating system.) There are
also some shorthands such as:
getest --ge
getest --ise
which are equivalent to:
getest getest.ge
getest getest.ise
provided that the corresponding files exist.
Following is the order used by getest to determine
which configuration file to use:
- If a filename has been specified on the command-line,
then use it.
- If either --ge
or --ise has been
specified on the command-line and the corresponding file getest.ge or getest.ise exists, then
use this file.
- If the file getest.cfg
exists, then use it.
- If the environment variable $GETEST_CONFIG
has been defined, then use its value as configuration
filename.
Here is the list of options that can be used with getest:
- -h
-?
--help
- Print a summary of the command-line options of getest
and exit.
- -V
--version
- Print the version number of getest and exit.
- -v
--verbose
- Run getest in verbose mode. In verbose mode, getest
prints the number of test cases that have been generated.
- --ge
- Run getest with the configuration file getest.ge if it exists.
This configuration file is supposed to contain
instructions to run the test with the Gobo Eiffel
compiler. Also the default value for the compile field
of the configuration file is set to "geant
compile_ge".
- --ise
- Run getest with the configuration file getest.ise if it exists.
This configuration file is supposed to contain
instructions to run the test with the ISE Eiffel
compiler. Also the default value for the compile field
of the configuration file is set to "geant
compile_ise".
- -a
- Do not catch exceptions, but let Eiffel run-time generate
a stack dump.
- --compile=<command>
- Override the compile field
of the configuration file.
- --class=<regexp>
- Override the class field
of the configuration file.
- --feature=<regexp>
- Override the feature field
of the configuration file.
- --default_test
- Specify whether the feature default_test
should be included in the generated test cases.
- -D <name>[=<value>]
- --define=<name>[=<value>]
- Define variable name
and set it to value
if specified. This option may appear several times on the
command-line to define different variables. By default
these variables are passed to the command running the test cases.
- -g
- Testcase generation only. Do not compile nor run the
generated test.
- -c
- Testcase compilation only. Do not generate nor run the
test.
- -e
- Testcase execution only. Do not generate nor compile the
test.
