Contents

= Github Metadata
{<img src="http://travis-ci.org/colszowka/github_metadata.png" />}[http://travis-ci.org/colszowka/github_metadata]

The Github repository API does not include all the information available on the
web view of a repo. It also has some trouble reporting correctly the availability of 
a wiki and issues.

The github_metadata gem is here to solve this. Currently it gives you, for any github repo:

* The availability and (if present) the count of wiki pages
* The availability and (if present) the count of issues
* The count of pull requests
* The list of contributors, with username and real name if available, and thereby also
  the count of contributors
* The default branch
* The most recent commits
* The average date for recent commits (to analyze project activity - hat tip to Ryan Bates for the
  idea!)
    
== Usage

  $ gem install github_metadata
  $ irb
  > require 'github_metadata'
  > m = GithubMetadata.new('aslakhellesoy', 'cucumber')
  > m.has_wiki?
  => true
  > m.wiki_pages
  => 71
  > m.has_issues?
  => false
  > m.contributor_usernames
  => ['aslakhellesoy', ...]
  
Check out the full documentation to see all available methods.

== TODO
  
  * Better (any?) error handling
  * Merge with my very own first_github_commit gem, which retrieves the very first commit to a repo

== Compatible rubies

Tested on MRI 1.8.7, 1.9.2, 1.9.3
  
== Note on Patches/Pull Requests

* Fork the project.
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a
  future version unintentionally.
* Commit, do not mess with rakefile, version, or history.
  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2011 Christoph Olszowka. See LICENSE for details.

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
github_metadata-0.3.0	README.rdoc