The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Xcruciate::XcruciateConfig - OO API for reading xcruciate config files.

SYNOPSIS

my $config=Xcruciate::XcruciateConfig->new('xcruciate.conf');

my $xacd_path=$config->xacd_path;

my @unit_paths=$config->unit_config_files;

DESCRIPTION

Xcruciate::XcruciateConfig is part of the Xcruciate project (http://www.xcruciate.co.uk). It provides an OO interface to an xcruciate configuration file.

The methods all take an optional verbose argument. If this is perlishly true the methods will show their working to STDOUT.

At present the methods look for configuration errors and die noisily if they find any. This is useful behaviour for management scripts - continuing to set up server daemons on the basis of broken configurations is not best practice - but non-fatal error reporting could be provided if/when an application requires it.

AUTHOR

Mark Howe, <melonman@cpan.org>

EXPORT

None

METHODS

new(config_file_path [,verbose])

Creates and returns an Xcruciate::XcruciateConfig object which can then be queried.

xcr_file_format_description()

Returns multi-lined human-friendly description of the xcr config file

restart_sleep()

Returns the time to sleep for between stopping and starting during a restart.

start_test_sleep()

Returns the time to sleep for between starting a process and checking that it started correctly.

stop_test_sleep()

Returns the time to sleep for between killing a process and checking that it died.

xacd_path()

Returns the path to the xacd executable.

xted_path()

Returns the path to the xted executable.

unit_config_files()

Returns a list of paths to Xacerbate configuration files.

BUGS

The best way to report bugs is via the Xcruciate bugzilla site (http://www.xcruciate.co.uk/bugzilla).

PREVIOUS VERSIONS

    0.01: First upload

    0.03: First upload containing module

    0.04: Changed minimum perl version to 5.8.8

    0.05: Warn about unknown entries

    0.07: Attempt to put all Xcruciate modules in one PAUSE tarball

    0.08: Global version upgrade

    0.09: Made most entries optional. Use Carp for errors

    0.10: Prepend path entry to relative paths

    0.12: Improvise Xcruciate config file if provided with Unit config file

    0.14: Global update

    0.16: Global update

    0.17: use warnings

    0.18: Global update

    0.19: Use XML Schema durations

COPYRIGHT AND LICENSE

Copyright (C) 2007 - 2009 by SARL Cyberporte/Menteith Consulting

This library is distributed under BSD licence (http://www.xcruciate.co.uk/licence-code).