NAME

readstats.pl - script to read the cpanstats database and verify the contents.

SYNOPSIS

perl readstats.pl [-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

-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.

--database

Specify the exact path to the cpanstats database if not ./cpanstats.db.

--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 an email to barbie@cpan.org. However, it would help greatly if you are able to pinpoint problems or even supply a patch.

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

SEE ALSO

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

AUTHOR

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

COPYRIGHT AND LICENSE

Copyright (C) 2005-2008 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.