/ 
Test-Chimps-Anna-0.04
River stage zero No dependents
/ Test::Chimps::Anna

NAME

Test::Chimps::Anna - An IRQ bot that announces test failures (and unexpected passes)

VERSION

Version 0.04

SYNOPSIS

Anna is a bot. Specifically, she is an implementation of Bot::BasicBot. She will query your smoke report database and print smoke report summaries when tests fail or unexpectedly succeed.

use Test::Chimps::Anna;

my $anna = Test::Chimps::Anna->new(
  server   => "irc.perl.org",
  port     => "6667",
  channels => ["#example"],

  nick      => "anna",
  username  => "nice_girl",
  name      => "Anna",
  database_file => '/path/to/chimps/chimpsdb/database',
  config_file => '/path/to/chimps/anna-config.yml',
  server_script => 'http://example.com/cgi-bin/chimps-server.pl'
  );

$anna->run;

METHODS

new ARGS

ARGS is a hash who's keys are mostly passed through to Bot::BasicBot. Keys which are recognized beyond the ones from Bot::BasicBot are as follows:

  • database_file

    Mandatory. The SQLite database Anna should connect to get smoke report data.

  • server_script

    Mandatory. The URL of the server script. This is used to display URLs to the full smoke report.

  • config_file

    If your server accepts report variables, you must specify a config file. The config file is a YAML dump of an array containing the names of those variables. Yes, this is a hack.

tick

Overrided method. Checks for new smoke reports every 2 minutes and prints summaries if there were failed tests or if tests unexpectedly succeeded.

AUTHOR

Zev Benjamin, <zev at cpan.org>

BUGS

Please report any bugs or feature requests to bug-test-chimps-anna at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Chimps-Anna. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Test::Chimps::Anna

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2006 Best Practical Solutions.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.