The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.