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


  # 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


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.


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


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


  Barbie, <>
  for Miss Barbell Productions <>.


  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.