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:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

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.