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::Model"s) 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.