pathways config files (5)¶
Pathways uses multiple ‘ExtendedInterpolation’ ini-files for almost all configuration; the command-line configuration is an apprehend exception. Typically those files use the .cfg extension (not ‘ini’). When its basename is equal to the (basename of the) ATSfile, it is automatically read and used.
Like other ini-files, pathways cfg-files are sectioned and typical start with a [DEFAULT]
section. Lines
starting with an hash (#
) are comments and are ignored.
Configurations are stored as a key=value
format. Both key and value may contain spaces. However, spaces in keys are not
recommended! Spaces around the ‘=’-sign are ignored. Also other leading and trailing whitespace is skipped.
Although the ‘key’ is case-insensitive, configuration-keys are typically in all-lowercase. Auxiliary keys use mixed- or
upper-case. Auxiliary keys are used build values, by interpolation (or expanding) them with ${AuxValue}
in another
value.
Config files¶
Typically, the configuration is combined from several locations.
When the option
--config <FILE>
is used, only that file is used and all other locations are ignored.
A user/global configuration-file called pathways.cfg.
Typically found in the users HOME directory, or the directory set by the environment
PATHWAYS_CONF_DIR
, or runner-specific configuration.The shared configuration-files called config.cfg. This can be found in several places:
the working directory (where the tests are started), or
the directory where the ATSes are located, typically also called
ATS/
.
Note
currently only 1 file is used: (b) when an ATS is specific, else (a).
Todo
Fix this
The ATS specific file
basename.cfg
, in the same directory as the ATSfile
Well known configuration-keys¶
- log
Threshold for logging. This can be a number between 0 and 50, or one of the standard names. The lower the number, the more is logged.
CRITICAL (=50)
ERROR
WARNING
INFO
DEBUG (=10)
- gate
Todo
Redesign the old 3-part gate and document it.
- put
An URI-style adress of the PUT: which product is to be tested. The exact interpretation of the value depends on the gate
Todo
extent the list