Github Metadata

<img src=“http://travis-ci.org/colszowka/github_metadata.png” />

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 © 2011 Christoph Olszowka. See LICENSE for details.