/ 
CPAN-Reporter-Smoker-OpenBSD-0.013
River stage zero No dependents
/ bin/send_reports

send_reports

send_reports - script to send CPAN::Reporter reports stored as files in a directory

SYNOPSIS

send_reports --grade pass

OPTIONS

--help

Print a brief help message and exits.

--host

The hostname to where to send the reports. Optional, defaults to localhost.

--reports

The complete path to the directory where the report files are located. Required.

--port

The port number to metabase-relayd server. Optional, defaults to 8080.

--grade

A grade filter to select which reports to send. See CPAN::Reporter for grades definitions.

Only reports with the given grade will be sent: all others will be ignored.

Any test file that corresponds to the grade passed as parameter will be sent through the metabase-relayd server.

--exclude

Same concept of --grade option, but the inverse result: tests with the given grade will be ignore while all others will be sent through the metabase-relayd server.

One cannot set both --grade and --exclude options: trying to do that will make the program to abort execution.

--quiet

The program will not print anything to STDOUT if this option is used. Only error messages will be sent to STDERR, which in case makes it useful to be used together with crontab.

--version

Prints this program version and exits.

DESCRIPTION

send_reports is a Perl program to send offline CPAN Smoker tests to a metabase-relayd server.

You can setup your CPAN Reporter to save the files to the filesystem instead sending it through HTTP/HTTPS directly. This have some advantages:

  • You can review tests before actually sending them. This is useful for Smokers, for instance, when you're not yet sure if the configuration is correct.

  • You can release the smoker very quickly when submitting a report. This usually is faster than sending through HTTP/HTTPS.

  • You can selective report your tests. For instance, you might be unsure about sending tests with "unknown" grade, so you can just skip them with --exclude or --grade command line options.

This program requires that somewhere near your machine you have a metabase-relayd server running. This script will use Test::Reporter::Transport::Socket to send the reports. Reports are sent pretty quickly (depending on how busy is the metabase-relayd).

AUTHOR

Alceu Rodrigues de Freitas Junior, <arfreitas@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 of Alceu Rodrigues de Freitas Junior, arfreitas@cpan.org

This file is part of CPAN OpenBSD Smoker.

CPAN OpenBSD Smoker is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

CPAN OpenBSD Smoker is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with CPAN OpenBSD Smoker. If not, see <http://www.gnu.org/licenses/>.