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 * AnnoCPAN: Annotated CPAN documentation * CPAN Ratings * CPAN Forum * RT: CPAN's Request Tracker * CPANTS Kwalitee * CPAN Testers Results * CPAN Testers Matrix * 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 :) Bugs Please report any bugs or feature requests to "bug-cpan-www-top100-retrieve at rt.cpan.org", or through the web interface at . I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. AUTHOR Apocalypse 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.