NAME

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

VERSION

Version 0.01

SYNOPSIS

            

              
              
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:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-FreshMeat-API

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WWW-FreshMeat-API

• CPAN Ratings

  http://cpanratings.perl.org/d/WWW-FreshMeat-API

• Search CPAN

  http://search.cpan.org/dist/WWW-FreshMeat-API/

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

cpanm WWW::FreshMeat::API

perl -MCPAN -e shell
install WWW::FreshMeat::API