跳ね込むの日記 - hanekomu's Perl blog

NAME

sync_cpantesters - Sync CPAN testers failure reports to local dir

SYNOPSIS

sync_cpantesters -a MARCEL -d results -v

DESCRIPTION

CPAN testers provide a valuable service. The reports are available on the Web -
for example, for CPAN ID MARCEL, the reports are at
http://cpantesters.perl.org/author/MARCEL.html. I don't like to read them in
the browser and click on each individual failure report. I also don't look at
the success reports. I'd rather download the failure reports and read them in
my favourite editor, vim. I want to be able to run this program repeatedly and
only download new failure reports, as well as delete old ones that no longer
appear in the master list - probably because a new version of the distribution
in question was uploaded.

If you are in the same position, then this program might be for you.

You need to pass a base directory using the --dir options. For each
distribution for which there are failure reports, a directory is created. Each
failure report is stored in a file within that subdirectory. The HTML is
converted to plain text. For example, at one point in time, I ran the program
using:

sync_cpantesters -a MARCEL -d reports

and the directory structure created looked like this:

reports/Aspect-0.12/449224
reports/Attribute-Memoize-0.01/39824
reports/Attribute-Memoize-0.01/71010
reports/Attribute-Overload-0.04/700557
reports/Attribute-TieClasses-0.03/700575
reports/Attribute-Util-1.02/455076
reports/Attribute-Util-1.02/475237
reports/Attribute-Util-1.02/477578
reports/Attribute-Util-1.02/485231
reports/Attribute-Util-1.02/489218
...

COMMAND-LINE OPTIONS

--author <cpanid>, -a <cpanid>

    The CPAN ID for which you want to download CPAN testers results. In my
    case, this id is MARCEL.

    You have to use exactly one of --author or --uri.
--uri <uri>, -u <uri>

    The URI from which to download the CPAN testers results. It needs to be in
    the same format as, say, http://cpantesters.perl.org/author/MARCEL.html.
    You might want to use this option if you've already downloadd the relevant
    file; in this case, use a file:// URI.

    You have to use exactly one of --author or --uri.
--dir <dir>, -d <dir>

    The directory you want to download the reports to. This can be a relative
    or absolute path. This argument is mandatory.

--verbose, -v

    Be more verbose.

--help, -h

    Show this documentation.