/ 
CPAN-Testers-Data-Generator-1.20
River stage zero No dependents
/ cpanstats

NAME

cpanstats - script to access the Metabase server and update the database.

SYNOPSIS

# single run (max 2500 reports) update from remote metabase
cpanstats -c=data/settings.ini

# continually update database from remote metabase, until no more
# reports are returned
cpanstats -c=data/settings.ini --nonstop

# rebuild default database from local cache
cpanstats -c=data/settings.ini --rebuild  # rebuild entire local dataset
cpanstats -c=data/settings.ini --rebuild --gstart=$guid1
cpanstats -c=data/settings.ini --rebuild --gstart=$guid1 --gend=$guid2
cpanstats -c=data/settings.ini --rebuild --dstart=$date1
cpanstats -c=data/settings.ini --rebuild --dstart=$date1 --dend=$date2

# regenerate reports between to given points
cpanstats -c=data/settings.ini --regenerate --gstart=$guid1 --gend=$guid2
cpanstats -c=data/settings.ini --regenerate --dstart=$date1 --dend=$date2
cpanstats -c=data/settings.ini --regenerate --file=$file

# parse a single report from remote metabase
cpanstats -c=data/settings.ini --parse --guid=$guid1
cpanstats -c=data/settings.ini --parse --file=$file
cpanstats -c=data/settings.ini --parse --guid=$guid1 --force

'parse' will only request a new report from the Metabase, if one doesn't exist in the local database.

# reparse a single report from remote metabase
cpanstats -c=data/settings.ini --reparse --guid=$guid1
cpanstats -c=data/settings.ini --reparse --file=$file
cpanstats -c=data/settings.ini --reparse --guid=$guid1 --check --localonly
cpanstats -c=data/settings.ini --reparse --guid=$guid1 --force

Note that by default 'reparse' will request a new report from the Metabase, but won't update the local copies if the already exist. The 'force' option will ensure that the even local copies are updated.

# tail the reports last entered into the remote metabase
cpanstats -c=data/settings.ini --tail --file=$file

DESCRIPTION

Acts as a wrapper script to the underlying CPAN::Testers::Data::Generator code that interfaces with the Metabase server, parsing and storing facts relating to submitted CPAN Testers reports.

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 dependent upon their severity and my availability. 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::Testers::WWW::Reports, 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-2012 Barbie for Miss Barbell Productions.

This module is free software; you can redistribute it and/or
modify it under the Artistic License 2.0.