Skip to content

Latest commit

 

History

History
73 lines (59 loc) · 4.24 KB

contributor_fact.md

File metadata and controls

73 lines (59 loc) · 4.24 KB
Raw

ContributorFact

A ContributorFact contains a selection of high-level statistics about a person who commited source code to a Project. One ContributorFact record exists for each contributor.

A ContributorFact is part of an Analysis, and is derived from lower-level statistics contained within the Analysis.

A new ContributorFact is created for each Project contributor whenever a new Analysis is created for the Project.

ContributorFacts only exist after Ohloh has downloaded and analyzed the project source code.

Properties

  • analysis_id The unique ID for the Analysis which provided the source data for this ContributorFact.
  • contributor_id The ID for the person who contributed the code measured in this ContributorFact. The contributor_id is not globally unique. It is derived from the author name found in the source control server log, and is unique within the scope of an individual project only.
  • contributor_name The name used by the author of this code when committing to the source control server.
  • account_id If this contribution has been claimed by an Ohloh member, the element contains the unique ID of the Ohloh Account. Otherwise, this element is omitted.
  • account_name If this contribution has been claimed by an Ohloh member, this element contains the Account name. Otherwise, this element is omitted.
  • primary_language_id The unique ID of the Language most often used by this contributor, measured by the number of code lines added. If this contributor has not committed any code in a language which Ohloh can recognize, this value will be null.
  • primary_language_nice_name The nice_name of the Language specified by primary_language_id.
  • comment_ratio The fraction of new lines added by this contributor which are comments. Note that Ohloh does not track the net lines of current code attributable to an specific individual. This statistic merely sums over all new lines added, and does not consider whether the added lines were later removed by this contributor or any other.
  • first_commit_time The time of the first commit by this contributor.
  • last_commit_time The time of the last commit by this contributor.
  • man_months The total number of calendar months in which this contributor made at least one commit. Note that this is not simply the number of months between first_commit_time and last_commit_time: months in which there was no activity for this contributor are not counted.
  • commits The total number of commits made by this contributor.
  • contributor_language_facts A collection of ContributorLanguageFacts may be included here, covering statistics in individual Languages. This collection is only present when ContributorFacts are queried individually.

URL

To get a single ContributorFact based on the latest Analysis for a Project:

curl https://www.openhub.net/projects/{project_id}/contributors/{contributor_id}.xml

This ContributorFact will include within it a collection of ContributorLanguageFacts covering statistics for individual languages.

Collection URL

To get a list of all ContributorFacts based on the lastest Analysis for a Project:

curl https://www.openhub.net/projects/{project_id}/contributors.xml

ContributorFacts returned from this call will not include ContributorLanguageFacts. Those can be obtained by retrieving ContributorFacts individually only.

The project collection request supports the standard collection request parameters, with the following details:

  • query If supplied, only ContributorFacts with a matching contributor_name will be returned. Ohloh account names are not matched.
  • sort ContributorFact collections support the following sort options:
    • name
    • kudo_position
    • commits Highest commits, first
    • commits_12_mo (default) Highest commits in past twelve months, first
    • language
    • latest_commit
    • newest
    • oldest