NAME

Test::Chimps::Client - Send smoke test results to a server

SYNOPSIS

This module simplifies the process of sending smoke test results (in the form of Test::TAP::Models) to a smoke server.

    use File::Temp;
    my $tmpfile = File::Temp->new( SUFFIX => ".tar.gz" );

    use TAP::Harness::Archive;
    chdir "some/module/directory";
    my $harness = TAP::Harness::Archive->new( {
        archive          => $tmpfile,
        extra_properties => {
            project   => 'my project',
            revision  => 'some revision',
            committer => 'me',
            osname    => $Config{osname},
            osvers    => $Config{osvers},
            archname  => $Config{archname},
        },
        ....
    } );
    $harness->runtests(glob('t/*.t'));

    use Test::Chimps::Client;
    my $client = Test::Chimps::Client->new(
        archive => $tmpfile,
        server  => "http://...",
    );

    print "Sending smoke report for $server\n";
    my ($status, $msg) = $client->send;
    die "Error: the server responded: $msg\n"
        unless $status;

INSTALLATION

To install this module, run the following commands:

    perl Makefile.PL
    make
    make test
    make install

DESCRIPTION

Chimps is the Collaborative Heterogeneous Infinite Monkey Perfectionification Service. It is a framework for storing, viewing, generating, and uploading smoke reports.

This distribution provides client-side modules and binaries for Chimps.

METHODS

new ARGS

Creates a new Client object. ARGS is a hash whose valid keys are:

• file

  Mandatory. The value must be a Test::TAP::Model. These are the test results that will be submitted to the server.

• report_variables

  Optional. A hashref of report variables and values to send to the server.

• server

  Mandatory. The URI of the server script to upload the model to.

send

Submit the specified model to the server. This function's return value is a list, the first of which indicates success or failure, and the second of which is an error string.

ACCESSORS

There are read-only accessors for model, report_variables, and server.

AUTHOR

Zev Benjamin, <zev at cpan.org>

BUGS

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-Client. 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::Client

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.

• Repository

  http://github.com/bestpractical/test-chimps-client

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Test-Chimps-Client

• CPAN Ratings

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

• RT: CPAN's request tracker

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

• Search CPAN

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

ACKNOWLEDGEMENTS

Some code in this module is based on smokeserv-client.pl from the Pugs distribution.

COPYRIGHT & LICENSE

Copyright 2006-2009 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.

cpanm Test::Chimps::Client

perl -MCPAN -e shell
install Test::Chimps::Client