Alexandr Ciornii > WWW-Freshmeat-0.12 > WWW::Freshmeat

Download:
WWW-Freshmeat-0.12.zip

Dependencies

Annotate this POD

CPAN RT

Open  0
Report a bug
Module Version: 0.12   Source   Latest Release: WWW-Freshmeat-0.20

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:

ACKNOWLEDGEMENTS ^

COPYRIGHT & LICENSE ^

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.