The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

CPAN::Testers::WWW::Statistics::Pages - CPAN Testers Statistics pages.

SYNOPSIS

my %hash = { config => 'options' };
my $obj = CPAN::Testers::WWW::Statistics->new(%hash);
my $ct = CPAN::Testers::WWW::Statistics::Pages->new(parent => $obj);

$ct->update_full();       # updates statistics data and web pages

# alternatively called individual processes

$ct->update_data();       # updates statistics data
$ct->build_basics();      # updates basic web pages
$ct->build_matrices();    # updates matrix style web pages
$ct->build_stats();       # updates stats style web pages

DESCRIPTION

Using the cpanstats database, this module extracts all the data and generates all the HTML pages needed for the CPAN Testers Statistics website. In addition, also generates the data files in order generate the graphs that appear on the site.

Note that this package should not be called directly, but via its parent as:

my %hash = { config => 'options' };
my $obj = CPAN::Testers::WWW::Statistics->new(%hash);

$obj->make_pages();       # updates statistics data and web pages

# alternatively called individual processes

$obj->update();           # updates statistics data
$obj->make_basics();      # updates basic web pages
$obj->make_matrix();      # updates matrix style web pages
$obj->make_stats();       # updates stats style web pages

INTERFACE

The Constructor

  • new

    Page creation object. Allows the user to turn or off the progress tracking.

    new() takes an option hash as an argument, which may contain 'progress => 1' to turn on the progress tracker.

Public Methods

  • setdates

    Prime all key date variable.

  • update_full

    Full update of data and pages.

  • update_data

    Update data and store in JSON format.

  • build_basics

    Create the basic set of pages,those require no statistical calculation.

  • build_matrices

    Create the matrices pages and distribution list pages.

  • build_stats

    Create all other statistical pages; monthly tables, interesting stats, etc.

  • build_leaders

    Create all OS Leaderboards.

  • build_cpan

    Create/update the CPAN specific statistics data files and pages.

  • build_performance

    Create/update the builder performance data file.

  • build_noreports

    Create all OS no report pages.

Private Methods

Data Methods

  • build_data

  • storage_read

  • storage_write

Page Creation Methods

  • _write_basics

    Write out basic pages, all of which are simply built from the templates, without any data processing required.

  • _write_index

    Writes out the main index page, after all stats have been calculated.

  • _report_interesting

    Generates the interesting stats page

  • _report_cpan

    Generates the statistic pages that relate specifically to CPAN.

  • _writepage

    Creates a single HTML page.

CPAN TESTERS FUND

CPAN Testers wouldn't exist without the help and support of the Perl community. However, since 2008 CPAN Testers has grown far beyond the expectations of it's original creators. As a consequence it now requires considerable funding to help support the infrastructure.

In early 2012 the Enlightened Perl Organisation very kindly set-up a CPAN Testers Fund within their donatation structure, to help the project cover the costs of servers and services.

If you would like to donate to the CPAN Testers Fund, please follow the link below to the Enlightened Perl Organisation's donation site.

https://members.enlightenedperl.org/drupal/donate-cpan-testers

If your company would like to support us, you can donate financially via the fund link above, or if you have servers or services that we might use, please send an email to admin@cpantesters.org with details.

Our full list of current sponsors can be found at our I <3 CPAN Testers site.

http://iheart.cpantesters.org

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 bug reports and patches to the RT Queue (see below).

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

SEE ALSO

CPAN::Testers::Data::Generator, CPAN::Testers::WWW::Reports

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-2017 Barbie for Miss Barbell Productions.

This distribution is free software; you can redistribute it and/or
modify it under the Artistic Licence v2.