auto-build 1.2.0

auto-build is a Perl module that can run automated, unattended software build processes.

SYNOPSIS

# auto-build [OPTION]...
Run build using latest code currently in source control
# auto-build --config /etc/auto-build.d/auto-build.conf
Run build using code committed prior to 12:30 on Dec 12th 2004
# auto-build --timestamp 12:30:00 Dec 12th 2004
--config /etc/auto-build.d/auto-build.conf

SUMMARY

auto-build is the command used to execute the Test-AutoBuild software build automation framework. It is intended to execute a single iteration of the build engine and then quit with its exit status providing an indication of the build success / fail status (see the EXIT STATUS section later in this manual page). To perform a continous automated build this command would be launched on a frequent basis from cron. Locking will ensure that two instances do not execute concurrently, so it can safely be triggered every 5 minutes.

OPTIONS

The following command line options are valid:

--config=FILE

Specify an alternative path to the configuration file for the build process. If ommitted, will default to looking for the file $HOME/auto-build.conf. The configuration data is loaded by the Config::Record module, so refer to that modules manual page for details of permitted syntax. The file will also be pre-processed by the Template module allowing dynamic generation of complex configuration files

--log4perl=FILE

Specify an alternative file containing configuration settings for the Log::Log4perl logging system. If ommitted, log4perl settings will be loaded from the master autobuild configuration file.

--timestamp=DATE

Specify the timestamp to use when checking code out of the source control repositories. For repository modules supporting timestamps it is guarenteed that the code checked out will be the latest version not newer than this timestamp. If ommitted, the timestamp will default to the current timestamp. The argument can be either an plain integer specifying number of seconds since the epoch, or any of the text representations handled by the Date::Manip module

today
1st thursday in June 1992
05/10/93
12:30 Dec 12th 1880
8:00pm december tenth

--verbose

Increase the verbosity of warning messages and errors. This will ensure that if the builder unexpectedly crashes, a complete stack trace will be dumped along will full arguments.It will also cause the post-processed configuration file to be dumped.

--help

Display a summary of the command line help options