NAME

CPAN::WWW::Top100::Retrieve - Retrieves the CPAN Top100 data from http://ali.as/top100

SYNOPSIS

        #!/usr/bin/perl
        use strict; use warnings;

        use CPAN::WWW::Top100::Retrieve;
        use Data::Dumper;

        my $top100 = CPAN::WWW::Top100::Retrieve->new;
        print Dumper( $top100->list( 'heavy' ) );

DESCRIPTION

This module retrieves the data from CPAN Top100 and returns it in a structured format.

Constructor

This module uses Moose, so you can pass either a hash or hashref to the constructor. The object will cache all data relevant to the Top100 for as long as it's alive. If you want to get fresh data just make a new object and use that.

The attributes are:

debug

( not required )

A boolean value specifying debug warnings or not.

ua

( not required )

The LWP::UserAgent object to use in place of the default one.

The default is:

        LWP::UserAgent->new;

uri

( not required )

The uri of Top100 data we should use to retrieve data in place of the default one.

The default is:

        CPAN::WWW::Top100::Retrieve::Utils::default_top100_uri()

Methods

Currently, there is only one method: list(). You call this and get the arrayref of data back. For more information please look at the CPAN::WWW::Top100::Retrieve::Dist class. You can call list() as many times as you want, no need to re-instantiate the object for each query.

list

Takes one argument: the $type of Top100 list and returns an arrayref of dists.

WARNING: list() will return an empty list if errors happen. Please look at the error() method for the string.

Example:

        use Data::Dumper;
        print Dumper( $top100->list( 'heavy' ) );
        print Dumper( $top100->list( 'volatile' ) );

error

Returns the error string if it was set, undef if not.

SEE ALSO

CPAN::WWW::Top100::Retrieve::Dist

CPAN::WWW::Top100::Retrieve::Utils

SUPPORT

You can find documentation for this module with the perldoc command.

        perldoc CPAN::WWW::Top100::Retrieve

Websites

• Search CPAN

  http://search.cpan.org/dist/CPAN-WWW-Top100-Retrieve

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/CPAN-WWW-Top100-Retrieve

• CPAN Ratings

  http://cpanratings.perl.org/d/CPAN-WWW-Top100-Retrieve

• CPAN Forum

  http://cpanforum.com/dist/CPAN-WWW-Top100-Retrieve

• RT: CPAN's Request Tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=CPAN-WWW-Top100-Retrieve

• CPANTS Kwalitee

  http://cpants.perl.org/dist/overview/CPAN-WWW-Top100-Retrieve

• CPAN Testers Results

  http://cpantesters.org/distro/C/CPAN-WWW-Top100-Retrieve.html

• CPAN Testers Matrix

  http://matrix.cpantesters.org/?dist=CPAN-WWW-Top100-Retrieve

• Git Source Code Repository

  This code is currently hosted on github.com under the account "apocalypse". Please feel free to browse it and pull from it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

  http://github.com/apocalypse/perl-cpan-www-top100-retrieve

Bugs

Please report any bugs or feature requests to bug-cpan-www-top100-retrieve at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPAN-WWW-Top100-Retrieve. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

AUTHOR

Apocalypse <apocal@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2010 by Apocalypse

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

The full text of the license can be found in the LICENSE file included with this module.

cpanm CPAN::WWW::Top100::Retrieve

perl -MCPAN -e shell
install CPAN::WWW::Top100::Retrieve