WWW::Freshmeat.3pm

Langue: en

Autres versions - même langue

Version: 2006-11-10 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

WWW::Freshmeat - automates searches on Freshmeat.net

VERSION

Version 0.01

SYNOPSIS

     use WWW::Freshmeat;
 
 

     my $fm = new WWW::Freshmeat;
 
 

     my $project = $fm->retrieve_project('project_id');
 
 

     foreach ( @projects, $project ) {
         print $_->name(), "\n";
         print $_->url(), "\n";
         print $_->version(), "\n";
         print $_->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 dies if the project entry cannot be found.

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
www_freshmeat

Additionnally, 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.

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, all rights reserved.

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