Command Line Interface
CLI
Last updated
CLI
Last updated
Basic syntax is:
where:
A parameter between[
and ]
means that it is optional.
[dir]
is the directory that contains your .feature
files. Whether it is not informed, the tool searches all the subdirectories from the current path.
[options]
changes how the tool behaves.
You can run concordia --help
to see all the command line interface (CLI) options.
You need to use npx
before the commands if you opted for a .
Indicates a
Alias: -c
By default the configuration file is loaded from the current directory.
This command asks about your preferences. By hitting Enter
without giving an answer, it will select the suggested (default) value. You can use Up
and Down
to navigate the answers and hit Enter
to select it. For multiple selection (when available), hitSpace
.
Add CLI parameters to the configuration file
The following example will consider the given directory
and add it to the configuration file:
Indicates the directory that has
.feature
and.testcase
files.
Alias: -d
When not given, it will search the current directory and all subdirectories recursively.
Example:
This is equivalent to:
Specifies
.feature
files to consider
Aliases: -f
, --files
Files must be separated by comma.
The example above will search for ./feature/f1.feature
and ./feature/f1.feature
.
Specify
.feature
files to ignore when a directory is informed
Alias: -i
Files must be separated by comma.
Disables recursive search when a directory is informed
Specifies the directory for test reports and screenshots.
Alias: -O
Specifies the directory for test script files.
Alias: -o
Sets the default language to consider.
Alias: -l
Lists the available language codes.
Lists the available locales.
Just generates test scripts
Just verifies specification files
Just generates test cases
Just execute test script files
Avoids generating test scripts
Avoids processing specification files
Avoids generating test cases
Avoids reading test scripts' results
Avoids running test scripts
Uses a verbose output
Number of parallel instances to execute.
Alias: -I
Alias: -H
Sets one or more test script files to execute
Aliases: -F
, --script-files
Files must be separated by comma.
Sets a text or regular expression to filter the files to execute
Alias: -G
Sets target browsers or platforms to execute
Alias: -T
Browser or platforms must be separated by comma.
Uses the given plug-in (if installed)
Alias: -p
Shows information about an installed plug-in
Alias: --plugin-info
Installs a plug-in
Lists installed plug-ins
Starts a testing server for a plug-in
Alias: -S
The testing server will keep running. Thus, it's a good idea to open a separate terminal/console for it. To stop it later, type Ctrl
+ C
.
Uninstalls a plug-in
Installs a database driver
Lists installed databases
Uninstalls a database driver
Maximum random string size to generate, when free values are allowed.
The default value is 500
.
Minimum random string size to generate, when free values are allowed.
The default value is 0
.
Random tries to generate invalid values.
When there is a set of valid values and any value different from those in the set is considered an invalid, random generation is used to produce an invalid value. This parameter defines how many tries to take. Usually it gets on the first try.
The default value is 5
.
Concordia Compiler can use random selection in its algorithms. By default, it generates the seed using the current date and time. Using the same seed makes the algorithms produce the same output (e.g., same values and paths). While that's interesting for reproducing a past behavior, we don't recommend it for finding new defects. Using new seeds, Concordia Compiler will select different test data, test oracles, and test paths over time.
--comb-data
--comb-invalid
--comb-state
--comb-variant
Sets the character(s) used for breaking lines.
Since by default the line breaker is detected automatically, this command may not be useful for you in most cases.
Note on line breakers:
Linux uses "\n"
MacOS uses "\r"
Windows uses "\r\n"
Sets the expected file encoding
Alias: -e
The default is utf8
. Possible values are:
ascii
latin1
ucs2
or ucs-2
utf16le
or utf-16le
utf8
or utf-8
Shows information about the compiler.
Shows the available commands
Verify if there is a newer version.
Shows the current version.
Creates a and optionally installs plug-ins and databases.
By using a (e.g. .concordiarc
) you avoid informing the configured parameters in the console/terminal. For instance, whether plugin
is defined in the configuration file, you don't need to inform --plugin
anymore.
CLI options take precedence over values from .
We strongly recommend to use it or set it in the .
You can use it with to disable recursive search.
Whether the command also informs a directory (e.g. ), it searches the files inside the directory. Example:
The directories will be used by a plug-in. We strongly recommend that you specify them in a .
The language code must have only 2 characters and needs to be one of the .
These parameters require a plugin () and some plug-ins may not support them.
Executes browsers in .
See for the list of available databases.
Sets a