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

Version 0.04

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;

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.

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

Zev Benjamin, <zev at cpan.org>

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.

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

    perldoc Test::Chimps::Anna

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-Anna

* CPAN Ratings

http://cpanratings.perl.org/d/Test-Chimps-Anna

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Chimps-Anna

* Search CPAN

http://search.cpan.org/dist/Test-Chimps-Anna

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.