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:

• 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 & 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.