NAME

cpanstats-verify - script to verify the contents of the cpanstats database.

SYNOPSIS

  perl cpanstats-verify                 \
     --config=<file>                    \
     --database=<dbcode>                \
     --log=<file> --out=<file>          \
    [-c|-m] [-v|-s --file=$file] [--start=0] [--end=0]

DESCRIPTION

Reads the cpanstats database and verifies the contents. Three kinds of verification can be applied; Check (-c), Missing (-m) and Verify (-v). The start and end counts for the NNTP server can be specified, otherwise values within the database and the script will be assumed.

OPTIONS

--config

Configuration file contain database access details.

--database

Specify the database to use, CPANSTATS or LITESTATS

--log

Specify the logfile generated by the 'cpanstats' program.

--out

Specify the output for this run.

-c | --check

Looks up the entries stored in the database between the START and END NNTP ids, checking the NNTP server for the subjects of any that are missing. Also highlights any subjects that have been marked as bad during processing.

-m | --missing

Looks up the entries stored in the database between the START and END NNTP ids, checking each to ensure all the fields are complete for each type.

-v | --verify

Looks up the entries stored in the database as stored in the named file, and either prints the entry or highlights that it is missing.

-s | --search

Looks up the NNTP entries directly as listed in the named file.

--file

Named file used when verifying a list of NNTP ids.

--start --end

Start and end NNTP ids.

get_lastid

Returns the last NNTP id recorded in the database.

missing_stats

Report on the database entries with missing field values.

check_stats

Report on the database entries which are either missing, or have reported bad processing.

verify_stats

Report on the given database entries highlighting those which are missing.

search_stats

Report on the given database entries highlighting those which are missing.

get_subject

Access the NNTP server to get the real subject recorded for the article, unless we can short cut the network by accessing the information from the project log file.

get_list

Returns the list of NNTP ids from the named file.

load_log

Load log file, the output of cpanstats.pl.

progress

Simple audit logging function.

BUGS, PATCHES & FIXES

There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties, that is not explained within the POD documentation, please send bug reports and patches to the RT Queue (see below).

Fixes are dependant upon their severity and my availablity. Should a fix not be forthcoming, please feel free to (politely) remind me.

RT Queue - http://rt.cpan.org/Public/Dist/Display.html?Name=CPAN-Testers-Data-Generator

SEE ALSO

CPAN::WWW::Testers, CPAN::Testers::WWW::Statistics

http://www.cpantesters.org/, http://stats.cpantesters.org/, http://wiki.cpantesters.org/

AUTHOR

  Barbie, <barbie@cpan.org>
  for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE

  Copyright (C) 2005-2010 Barbie for Miss Barbell Productions.

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