/ 
WWW-FreshMeat-API-0.03
River stage zero No dependents
/ WWW::FreshMeat::API

NAME

WWW::FreshMeat::API - inspect & update your freshmeat.net projects

VERSION

Version 0.03

SYNOPSIS

** IMPORTANT ANNOUNCEMENT **

Circa April 2009 Freshmeat relaunched their site and completely dropped the XML-RPC API :(

In place is a new Freshmeat API 3.0 using REST JSON (or XML).

Its not clear how stable this API is. I'll look more closely at this in a few months time and perform necessary surgery on this module.

So note this module will not work in its present state until I make investigate the new API & changes source code changes.

Very sorry about this.

BW 19-Jul-2009

** END OF ANNOUCEMENT **

use WWW::FreshMeat::API;

my $fm = WWW::FreshMeat::API->new;

$fm->login( username => 'user', password => 'pass' );

say "Your ID for this API session (SID) is ", $fm->sid;

for my $proj ( @{ $fm->fetch_project_list } ) {
    say "Project      ", $proj->{ projectname_full }; 
    say "- short name ", $proj->{ projectname_short };
    say "- status"    ", $proj->{ project_status };
    say "- version    ", $proj->{ project_version };
}

DESCRIPTION

FreshMeat (http://freshmeat.net) provides a very simple XML-RPC API which allows a user to inspect what projects the user as uploaded and also provides an update & withdrawal mechanism of the users projects.

Requirements....

1) Must have a FreshMeat login & password

2) Must have already loaded project onto http://freshmeat.net

For now see ./examples/freshmeat-submit.pl.

More details to follow.

EXPORT

None

METHODS

For session methods see WWW::FreshMeat::API::Session

For Freshmeats public API which are mapped to methods see WWW::FreshMeat::API::Pub & WWW::FreshMeat::API::Pub::V1_03

ATTRIBUTES

mock

Constructor only testing attribute. Not sure this will survive alpha so ignore for now!

AUTHOR

Barry Walsh, <draegtun at cpan.org>

BUGS

Please report any bugs or feature requests to bug-www-freshmeat-api at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-FreshMeat-API. 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::API

You can also look for information at:

MOTIVATIONS

There certainly was! More on that later ;-)

ACKNOWLEDGEMENTS

Moose

Thanks to Stevan Little and cast of thousands for the brilliant Moose module. Using Moose really made developing this module simple and lots of fun!

XML::RPC

Thanks to Niek Albers, http://www.daansystems.com/ for his excellent XML::RPC module.

SEE ALSO

Source Code

GitHub at http://github.com/draegtun/www-freshmeat-api/tree/master

freshmeat-submit

Python script written by ESR no less! http://freshmeat.net/projects/freshmeat-submit/

freshmeat-submit was written in 2003 and last updated 2004. I didn't find freshmeat-submit to be useful to me when writing WWW::FreshMeat::API. Fingers crossed WWW::FreshMeat::API won't look as crufty as freshmeat-submit does after 5 and bit years ;-)

DISCLAIMER

This is alpha software. It does not contain necessary tests & checks yet ;-(

However FreshMeat API is very simple & WWW::FreshMeat::API does work for me.

I hope to make it beta status very shortly!

COPYRIGHT & LICENSE

Copyright 2009,2010 Barry Walsh (Draegtun Systems Ltd), all rights reserved.

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