NAME

CPAN::Testers::Reports::Count - counts of CPAN Testers reports by month or year

SYNOPSIS

 use CPAN::Testers::Reports::Counts ':all';

 $counts = reports_counts_by_year();

 foreach my $year (sort keys %$counts) {
     print "$year:\n";
     foreach my $category (qw(REPORTS PASS FAIL NA UNKNOWN)) {
         print "   $category = $counts->{$year}->{$category}\n";
     }
 }

DESCRIPTION

This module gives you the number of CPAN Testers reports that were submitted in every month or year that CPAN Testers has been running. The data is returned as a hash reference, with the keys identifying either years or year/month pairs. For each month or year there are five numbers available:

• REPORTS: the total number of reports submitted.

• PASS: the number of successful test reports.

• FAIL: the number of failing test reports.

• NA: the number of "Not Applicable" results. Eg the version of Perl wasn't supported.

• UNKNOWN: the number of Unknown tests. Eg the dist doesn't have any tests.

More detailed definitions of these can be found on the CPAN Testers wiki.

The data is grabbed from the CPAN Testers Statistics web site, so you must have a working internet connection when you use this module.

There are two functions, used to get the reports counts either by year or by month.

reports_counts_by_year

This function returns a hashref which is keyed off the years for which reports have been submitted:

 use CPAN::Testers::Reports::Counts 'reports_counts_by_year';
 $counts = reports_counts_by_year();
 print "total = $counts->{2013}->{REPORTS}\n";

The value in the hash for each year is another hashref, which is keyed off the report grades listed above.

reports_counts_by_month

This function returns a hashref which is keyed off the months for which reports have been submitted. The months are in the format 'YYYY-MM'.

 use CPAN::Testers::Reports::Counts 'reports_counts_by_month';
 $counts = reports_counts_by_month();
 print "Dec 2013 = $counts->{'2013-12'}->{REPORTS}\n";

SEE ALSO

CPAN Testers Statistics, CPAN Testers wiki. CPAN::Testers::Data::Generator - a module used to download and summarize CPAN Testers data.

REPOSITORY

https://github.com/neilb/CPAN-Testers-Reports-Counts

AUTHOR

Neil Bowers <neilb@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Neil Bowers <neilb@cpan.org>.

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