cpantest - Report test results of a package retrieved from CPAN


cpantest uniformly posts package test results in support of the cpan-testers project. See for details.


    cpantest -g grade [ -nc ] [ -auto ] [ -p package ]
             [ -t text | -f file ] [ email-addresses ]
             [ -x transport ]


-g grade

grade indicates the success or failure of the package's builtin tests, and is one of:

    grade     meaning
    -----     -------
    pass      all tests included with the package passed
    fail      some tests failed
    na        the package does not work on this platform
    unknown   the package did not include tests
-p package

package is the name of the package you are testing. If you don't supply a value on the command line, you will be prompted for one.

For example: Test-Reporter-1.27


No comment; you will not be prompted to supply a comment about the package.

-t text

A short comment text line.

-f file

A file containing comments; '-' will make it read from STDIN. Note that an editor will still appear after reading this file.


Autosubmission (non-interactive); you won't be prompted to supply any information that you didn't provide on the command line. Implies -nc.


A list of additional email addresses that should be cc:'d in this report (typically, the package's author).

perl-version perl

An alternate version of perl on which the distribution was tested. This option allows reporting on versions of perl for which Test::Reporter is not installed.

-x transport

Specify a transport: Net::SMTP or Mail::Send. This is optional. One will be chosen for you automatically if not specified. See Test::Reporter docs for further information.


This version of the 'cpantest' script was adapted by Adam J. Foxson <> for Test::Reporter, and is based on Audrey Tang's <> adaptations for CPANPLUS, which is in turn based upon the original script by Kurt Starsinic <> with various patches from the CPAN Testers <>.


 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008 Adam J. Foxson.
 Copyright (C) 2004, 2005 Richard Soderberg.
 Copyright (C) 2002 Audrey Tang.
 Copyright (C) 1999 Kurt Starsinic.
 All rights reserved.

 This program is free software; you may redistribute it
 and/or modify it under the same terms as Perl itself.