NAME

cpansmoke - CPAN Smoke Tester

SYNOPSIS

cpansmoke [ -acdfilpuv ] [ -t timeout ] packages...

DESCRIPTION

This script uses CPANPLUS to test one or more distributions from CPAN. It accepts full or partial distribution names (e.g. CPANPLUS-0.01 and K/KA/KANE/CPANPLUS-0.01.tar.gz), or module names (e.g. CPANPLUS::Backend), in which case the latest distribution containing the module is tested.

OPTIONS

 -a    Automatically send reports without prompting or editing
 -c    Always Cc: to the module author (only on FAIL by default)
 -d    Display each package's existing result before testing it
 -f    Force re-fetching cached packages and checksum data
 -i    Don't cc FAIL reports to author if two or more FAILs were reported
 -l    Use user-configured hosts; www.cpan.org is preferred by default
 -p    Fetch, make and test (but not install) prerequisite modules
 -s    Skip modules that have testing results from the same settings
 -u    Skip modules that have more than one testing results as UNKNOWN
 -v    Print verbose proceeding informations
 -t    Sets timeout for each package's install; defaults to 300

NOTES

If the -a option is set, only failures during make test are reported, to prevent bogus reports caused by insufficient non-perl requisites.

For automatic testing, cpansmoke -aipsu is preferred. Subscriber of the cpan-testers@perl.org list may use this Mail::Audit recipe to enable unattended smoke testing:

    fork || system("cpansmoke -aps $1 >/dev/null 2>&1")
        if $mail->subject =~ /^CPAN Upload: (.*)$/;

Users of procmail should add this line to .procmailrc:

    :0hc
    * ^Subject: CPAN Upload:
    |sh -c "grep Subject|cut -f4 -d' '|xargs cpansmoke -aps >/dev/null 2>&1"

Please consult CPANPLUS::TesterGuide for additional information.

SEE ALSO

CPANPLUS, CPANPLUS::TesterGuide, cpantest

AUTHORS

Autrijus Tang <autrijus@autrijus.org>

COPYRIGHT

Copyright 2001, 2002 by Autrijus Tang <autrijus@autrijus.org>.

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

See http://www.perl.com/perl/misc/Artistic.html