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