NAME

WWW::Ohloh::API::Project - an Ohloh project

SYNOPSIS

    use WWW::Ohloh::API;

    my $ohloh = WWW::Ohloh::API->new( api_key => $my_api_key );
    my $project = $ohloh->get_project( id => 1001 );

    print $project->homepage_url;

DESCRIPTION

W::O::A::Project contains the information associated with an Ohloh project as defined at http://www.ohloh.net/api/reference/project. To be properly populated, it must be created via the get_project method of a WWW::Ohloh::API object.

METHODS

API Data Accessors

id

Return the project's id.

name

Return the name of the project.

created_at

Return the time at which the project was initially added to Ohloh.

updated_at

Return the time of the most recent modification of the project's record.

description

Return a description of the project.

homepage_url

Return the URL of the project's homepage.

download_url

Return an url to a project download.

irc_url

Return a URL to an IRC channel associated to the project.

stack_count

Return the number of stacks currently using the project.

average_rating

Return a number ranging from 1.0 to 5.0, representing the average value of all user ratings for this project, where 1 is the worst possible rating, and 5 the best.

rating_count

Return the number of users having rated this project.

analysis_id

Return the id of the analysis obtained with the project. It'll be the latest analysis if the project has been retrieved via get_project, and will be null if retrieved via get_projects.

analysis

Return the current analysis of the project, if available.

Other Methods

as_xml

Return the account information (including the kudo score if it applies) as an XML string. Note that this is not the exact xml document as returned by the Ohloh server.

SEE ALSO

• WWW::Ohloh::API, WWW::Ohloh::API::KudoScore, WWW::Ohloh::API::Analysis, WWW::Ohloh::API::Account.

• Ohloh API reference: http://www.ohloh.net/api/getting_started

• Ohloh Account API reference: http://www.ohloh.net/api/reference/project

VERSION

This document describes WWW::Ohloh::API version 0.0.2

BUGS AND LIMITATIONS

WWW::Ohloh::API is very extremely alpha quality. It'll improve, but till then: Caveat emptor.

The as_xml() method returns a re-encoding of the account data, which can differ of the original xml document sent by the Ohloh server.

Please report any bugs or feature requests to bug-www-ohloh-api@rt.cpan.org, or through the web interface at http://rt.cpan.org.

AUTHOR

Yanick Champoux <yanick@cpan.org>

LICENCE AND COPYRIGHT

Copyright (c) 2008, Yanick Champoux <yanick@cpan.org>. All rights reserved.

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

cpanm WWW::Ohloh::API

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