Test::Chimps::Server - Accept smoke report uploads and display smoke reports
This module simplifies the process of running a smoke server. It is meant to be used with Test::Chimps::Client.
use Test::Chimps::Server; my $server = Test::Chimps::Server->new(base_dir => '/var/www/smokes'); $server->handle_request;
Creates a new Server object. ARGS is a hash whose valid keys are:
base_dir
Mandatory. Base directory where report data will be stored.
bucket_file
Name of bucket database file (see Algorithm::TokenBucket). Defaults to 'bucket.dat'.
burst_rate
Burst upload rate allowed (see Algorithm::TokenBucket). Defaults to 5.
database
Name of the database
database_driver
Database driver to use
database_user
User to connect ot the database as
database_password
Password to connect to the database with
list_template
Template filename under base_dir/template_dir to use for listing smoke reports. Defaults to 'list.tmpl'.
lister
An instance of Test::Chimps::Server::Lister to use to list smoke reports. You do not have to use this option unless you are subclassing Lister.
Lister
max_rate
Maximum upload rate allowed (see Algorithm::TokenBucket). Defaults to 1/30.
max_size
Maximum size of HTTP POST that will be accepted. Defaults to 3 MiB.
max_reports_per_subcategory
Maximum number of smokes allowed per category. Defaults to 5.
template_dir
Directory under base_dir where html templates will be stored. Defaults to 'templates'.
variables_validation_spec
A hash reference of the form accepted by Params::Validate. If supplied, this will be used to validate the report variables submitted to the server.
Handles a single request. This function will either accept a series of reports for upload or display report summaries.
Zev Benjamin, <zev at cpan.org>
<zev at cpan.org>
Please report any bugs or feature requests to bug-test-chimps at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Chimps. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-test-chimps at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc Test::Chimps
You can also look for information at:
Mailing list
Chimps has a mailman mailing list at chimps@bestpractical.com. You can subscribe via the web interface at http://lists.bestpractical.com/cgi-bin/mailman/listinfo/chimps.
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Test-Chimps
CPAN Ratings
http://cpanratings.perl.org/d/Test-Chimps
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Chimps
Search CPAN
http://search.cpan.org/dist/Test-Chimps
Some code in this distribution is based on smokeserv-server.pl from the Pugs distribution.
Copyright 2006 Best Practical Solutions. Portions copyright 2005-2006 the Pugs project.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Test::Chimps, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::Chimps
CPAN shell
perl -MCPAN -e shell install Test::Chimps
For more information on module installation, please visit the detailed CPAN module installation guide.