WWW::Freshmeat.3pm

Langue: en

Autres versions - même langue

Version: 2009-02-18 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

WWW::Freshmeat - automates searches on Freshmeat.net

VERSION

Version 0.12

SYNOPSIS

     use WWW::Freshmeat;
 
     my $fm = WWW::Freshmeat->new;
 
     my $project = $fm->retrieve_project('project_id');
 
     foreach my $p ( @projects, $project ) {
         print $p->name(), "\n";
         print $p->url(), "\n";
         print $p->version(), "\n";
         print $p->description(), "\n";
     }

DESCRIPTION

"WWW::Freshmeat" derives from "LWP::UserAgent", so it accepts all the methods that "LWP::UserAgent" does, notably "timeout", "useragent", "env_proxy"...

Methods

retrieve_project STRING
Query the freshmeat.net site for the project STRING (should be the Freshmeat ID of the requested project) and returns a "WWW::Freshmeat::Project" object or undef if the project entry cannot be found.
project_from_xml STRING
Receives Freshmeat project XML record and returns a "WWW::Freshmeat::Project" object or undef if the project entry cannot be found.
redir_url STRING
Receives URL and returns URL which it redirects to.

WWW::Freshmeat::Project methods

The "WWW::Freshmeat::Project" object provides some of the fields from the freshmeat.net entry through the following methods
url_project_page
url_homepage
projectname_full
desc_short
desc_full
license
trove_id
projectname_short
www_freshmeat

Additionally, it provides the following ``higher-level'' methods:

name
description
Return either "projectname_full" (respectively "desc_full") or "projectname_short" (respectively "desc_short") if the former is empty.
version
Returns the version of the latest release.
url
"url_homepage" returns a freshmeat.net URL that redirects to the actual project's home page. This url() method tries to follow the redirection and returns the actual homepage URL if it can be found, or the URL to the freshmeat.net entry for the project.
branches
List of branches for project. Returns hash in form of (branch id => branch name).
popularity
Freshmeat popularity data for project. Returns hash with keys record_hits, url_hits, subscribers
url_list
Returns list of URLs for project. You may need to use redir_url to get real link or just pass 1 as argument.
real_author
Returns name of author (not maintainer).

SEE ALSO

LWP::UserAgent.

AUTHOR

Cedric Bouvier, "<cbouvi at cpan.org>"

BUGS

This is very alpha code. It does not even support searching!

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

SUPPORT

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

You can also look for information at:

•
AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/WWW-Freshmeat>

•
CPAN Ratings

<http://cpanratings.perl.org/d/WWW-Freshmeat>

•
RT: CPAN's request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Freshmeat>

•
Search CPAN

<http://search.cpan.org/dist/WWW-Freshmeat>

ACKNOWLEDGEMENTS

Copyright 2006 Cedric Bouvier. Copyright 2009 Alexandr Ciornii.

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