The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.