NAME
brewbuild.conf - Optional configuration file for the Test::BrewBuild
build system.
DESCRIPTION
By default, an example brewbuild.conf-dist
configuration file is copied into ~/brewbuild
directory upon installation.
To use a configuration file, copy the brewbuild.conf-dist
file to brewbuild.conf
within the same directory, and edit it accordingly.
Command line arguments will override whatever configuration you have in the config file.
SECTIONS
[brewbuild]
Configuration for the core brewbuild script.
timeout
This is the timeout to use for the instance_install()
method. It defaults to 600 seconds. If an install takes longer than the time set in timeout
, it'll roll out the changes and log an error, then proceed.
remove
Set to 1 to remove all instances of perl on every run. Defaults to 0.
plugin
Overrides the default plugin Test::BrewBuild::Plugin::DefaultExec that is the actual command set that performs the testing routines.
save
Default off, set to 1 to enable saving of all PASS logs along with the FAIL ones.
debug
Default is 0. Range is 0-7.
legacy
Default off. Perls 5.8.x and lower will be installed if you set this to 1.
nocache
Default is off (0). Send in a true value to disable the caching of Perl/Berrybrew available/list information.
revdep
Default is off (0). Send in a true value to run reverse dependency tests on the current distribution being tested.
[dispatch]
Configuration for the dispatcher, bbdispatch.
testers
A comma delimited list of test servers to dispatch to. Example:
testers = 127.0.0.1, 10.5.5.5:9999
repo
The repo to default to. If not specified here or at the command-line, we'll default to looking for a repository in your current working directory. Example:
repo = https://github.com/stevieb9/p5-test-brewbuild
cmd
The brewbuild
command string you want to use as default. Example:
cmd = brewbuild -r -R -d 7
forks
Default is 4. Send in a positive integer to run that many parallel dispatch processes.
auto_sleep
When using an auto dispatch run (eg: bbdispatch --auto
), the integer value of this directive specifies how many seconds to sleep in between each build run sent to the testers.
rpi
Default is off (0). Set to a true value to enable RPi-specific testing. (ie. You're running on a Pi and have an LCD connected for test statistics).
rpi_lcd_rows
Defaults to 4. Only other valid number of rows is 2.
rpi_lcd_cols
Defaults to 20. Only other valid number of columns is 16.
debug
Defaults to off (0). Set to any number 0-7 to enable that level of debugging output.
[tester]
Configuration for the tester bbtester test runner daemon.
ip
Specify the IP address you want your tester to listen on. Example:
ip = 127.0.0.1
port
Which port should your tester listen on? Example:
port = 9999
logfile
Defaults to undefined. Send in the name of a writable file location and we'll output our debug data to this file.
auto
Defaults to undefined. Send in a true value to have the Tester run in automated Continuous Integration mode.
csum
Defaults to undefined. This is used in conjunction with auto
.
If set to a true value, we'll run in CI mode even if no new commits have been made to the repository.
debug
Defaults to off (0). Set to 0-7 to enable that level of debug output.