Yanick Champoux > WWW-Ohloh-API > WWW::Ohloh::API::SizeFact

Download:
WWW-Ohloh-API-v0.3.2.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: v0.3.2   Source  

NAME ^

WWW::Ohloh::API::SizeFact - statistics about a Project source code

SYNOPSIS ^

    use WWW::Ohloh::API;

    my $ohloh = WWW::Ohloh::API->new( api_key => $my_api_key );
    my @size_facts = $ohloh->get_size_facts( $project_id );

    my $size_fact = shift @size_facts;

    print $size_fact->month;

DESCRIPTION ^

W::O::A::SizeFact contains the statistics associated with an Ohloh project. To be properly populated, it must be created via the get_size_facts method of a WWW::Ohloh::API object.

METHODS ^

API Data Accessors

month

Indicate the month covered by this SizeFact.

code

The total net lines of code, excluding comments and blanks, as of the end of this month.

comments

The total net lines of comments as of the end of this month.

blanks

The total net blank lines as of the end of this month.

comment_ratio

The fraction of net lines which are comments as of the end of this month.

man_months

The cumulative total months of effort expended by all contributors on this project, including this month.

stats

 ( $month, $commits, $code, $blanks, $comments, $comment_ratio, $man_month )
    = $size_fact->stats;

Return the facts as an array.

Other Methods

as_xml

Return the size fact as an XML string. Note that this is not the exact xml document as returned by the Ohloh server.

Overloading

Array reference

    @stats = @$size_fact;   # equivalent to 
                            # @stats = $size_fact->stats

Using the object as an array reference can be used as a shortcut for the method stats.

SEE ALSO ^

VERSION ^

This document describes WWW::Ohloh::API version 0.3.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.

syntax highlighting: