octokit 1.24.0 → 1.25.0

data/CONTRIBUTING.md

@@ -2,9 +2,9 @@
 1. [Fork the repository.][fork]
 2. [Create a topic branch.][branch]
 3. Add specs for your unimplemented feature or bug fix.
-4. Run `bundle exec rake spec`. If your specs pass, return to step 3.
+4. Run `bundle exec rspec-queue spec`. If your specs pass, return to step 3.
 5. Implement your feature or bug fix.
-6. Run `bundle exec rake spec`. If your specs fail, return to step 5.
+6. Run `bundle exec rspec-queue spec`. If your specs fail, return to step 5.
 7. Run `open coverage/index.html`. If your changes are not completely covered
    by your tests, return to step 3.
 8. Add documentation for your feature or bug fix.

data/README.md

@@ -1,67 +1,52 @@
 # Octokit
 
-[![Gem Version](https://badge.fury.io/rb/octokit.png)][gem]
-[![Build Status](https://secure.travis-ci.org/pengwynn/octokit.png?branch=master)][travis]
-[![Dependency Status](https://gemnasium.com/pengwynn/octokit.png?travis)][gemnasium]
-[![Code Climate](https://codeclimate.com/github/pengwynn/octokit.png)][codeclimate]
-[![Coverage Status](https://coveralls.io/repos/pengwynn/octokit/badge.png?branch=master)][coveralls]
-
-[gem]: https://rubygems.org/gems/octokit
-[travis]: http://travis-ci.org/pengwynn/octokit
-[gemnasium]: https://gemnasium.com/pengwynn/octokit
-[codeclimate]: https://codeclimate.com/github/pengwynn/octokit
-[coveralls]: https://coveralls.io/r/pengwynn/octokit
-
-Simple Ruby wrapper for the GitHub v3 API.
+Simple Ruby wrapper for the GitHub API.
 
 ## Installation
+
     gem install octokit
 
 ## Documentation
+
 [http://rdoc.info/gems/octokit][documentation]
 
 [documentation]: http://rdoc.info/gems/octokit
 
-## Examples
-### Show a user
-```ruby
-Octokit.user("sferik")
-=> <#Hashie::Rash blog="http://twitter.com/sferik" company="Code for America" created_at="2008/05/14 13:36:12 -0700" email="sferik@gmail.com" followers_count=177 following_count=83 gravatar_id="1f74b13f1e5c6c69cb5d7fbaabb1e2cb" id=10308 location="San Francisco" login="sferik" name="Erik Michaels-Ober" permission=nil public_gist_count=16 public_repo_count=30 type="User">
-```
+### Examples
+
+#### Show a user
 
-### Show who a user follows
 ```ruby
-Octokit.following("sferik")
-=> ["rails", "puls", "wycats", "dhh", "jm3", "joshsusser", "nkallen", "technoweenie", "blaine", "al3x", "defunkt", "schacon", "bmizerany", "rtomayko", "jpr5", "lholden", "140proof", "ephramzerb", "carlhuda", "carllerche", "jnunemaker", "josh", "hoverbird", "jamiew", "jeremyevans", "brynary", "mojodna", "mojombo", "joshbuddy", "igrigorik", "perplexes", "joearasin", "hassox", "nickmarden", "pengwynn", "mmcgrana", "reddavis", "reinh", "mzsanford", "aanand", "pjhyett", "kneath", "tekkub", "adamstac", "timtrueman", "aaronblohowiak", "josevalim", "kaapa", "hurrycane", "jackdempsey", "drogus", "cameronpriest", "danmelton", "marcel", "r", "atmos", "mbleigh", "isaacs", "maxogden", "codeforamerica", "chadk", "laserlemon", "gruber", "lsegal", "bblimke", "wayneeseguin", "brixen", "dkubb", "bhb", "bcardarella", "elliottcable", "fbjork", "mlightner", "dianakimball", "amerine", "danchoi", "develop", "dmfrancisco", "unruthless", "trotter", "hannestyden", "codahale", "ry"]
+Octokit.user "sferik"
+=> #<Hashie::Mash avatar_url="https://secure.gravatar.com/avatar/1f74b13f1e5c6c69cb5d7fbaabb1e2cb?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png" bio="" blog="http://twitter.com/sferik" company="" created_at="2008-05-14T20:36:12Z" email="sferik@gmail.com" events_url="https://api.github.com/users/sferik/events{/privacy}" followers=662 followers_url="https://api.github.com/users/sferik/followers" following=102 following_url="https://api.github.com/users/sferik/following{/other_user}" gists_url="https://api.github.com/users/sferik/gists{/gist_id}" gravatar_id="1f74b13f1e5c6c69cb5d7fbaabb1e2cb" hireable=false html_url="https://github.com/sferik" id=10308 location="San Francisco, CA" login="sferik" name="Erik Michaels-Ober" organizations_url="https://api.github.com/users/sferik/orgs" public_gists=59 public_repos=83 received_events_url="https://api.github.com/users/sferik/received_events" repos_url="https://api.github.com/users/sferik/repos" starred_url="https://api.github.com/users/sferik/starred{/owner}{/repo}" subscriptions_url="https://api.github.com/users/sferik/subscriptions" type="User" updated_at="2013-05-31T16:01:08Z" url="https://api.github.com/users/sferik">
 ```
 
-### Repositories
+#### Repositories
+
 For convenience, methods that require a repository argument may be passed in
 any of the following forms:
 
 ```ruby
-Octokit.repo("pengwynn/octokit")
-
-Octokit.repo({:username => "pengwynn", :name => "octokit"})
+Octokit.repo "octokit/octokit.rb"
 
-Octokit.repo({:username => "pengwynn", :repo => "octokit"})
+Octokit.repo {:username => "octokit", :name => "octokit.rb"}
 
-Octokit.repo(Repository.new('pengwynn/octokit'))
+Octokit.repo {:username => "octokit", :repo => "octokit.rb"}
 
-=> <#Hashie::Rash created_at="2009/12/10 13:41:49 -0800" description="Simple Ruby wrapper for the GitHub API and feeds" fork=false forks=25 has_downloads=true has_issues=true has_wiki=true homepage="http://wynnnetherland.com/projects/octokit" integrate_branch="master" language="Ruby" name="octokit" open_issues=8 owner="pengwynn" private=false pushed_at="2011/05/05 10:48:57 -0700" size=1804 url="https://github.com/pengwynn/octokit" watchers=92>
+Octokit.repo Repository.new('octokit/octokit.rb')
 ```
 
-### List the commits for a repository
+#### List the commits for a repository
 
 ```ruby
-Octokit.commits("pengwynn/octokit")
+Octokit.commits("octokit/octokit.rb")
 
-Octokit.list_commits("pengwynn/octokit")
+Octokit.list_commits("octokit/octokit.rb")
 
-=> [#<Hashie::Mash author=#<Hashie::Mash avatar_url="https://secure.gravatar.com/avatar/7e19cd5486b5d6dc1ef90e671ba52ae0?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png" gravatar_id="7e19cd5486b5d6dc1ef90e671ba52ae0" id=865 login="pengwynn" url="https://api.github.com/users/pengwynn"> commit=#<Hashie::Mash author=#<Hashie::Mash date="2012-10-31T15:17:51Z" email="wynn@github.com" name="Wynn Netherland"> comment_count=0 committer=#<Hashie::Mash date="2012-10-31T15:17:51Z" email="wynn@github.com" name="Wynn Netherland"> message="Fix bug with archive_link for private repo" tree=#<Hashie::Mash sha="49bf2a476aa819f29b0fc1a8805f7567f010006d" url="https://api.github.com/repos/pengwynn/octokit/git/trees/49bf2a476aa819f29b0fc1a8805f7567f010006d"> url="https://api.github.com/repos/pengwynn/octokit/git/commits/8db3df37fad3a021eb8036b007c718149836cb32"> committer=#<Hashie::Mash avatar_url="https://secure.gravatar.com/avatar/7e19cd5486b5d6dc1ef90e671ba52ae0?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png" gravatar_id="7e19cd5486b5d6dc1ef90e671ba52ae0" id=865 login="pengwynn" url="https://api.github.com/users/pengwynn"> parents=[#<Hashie::Mash sha="7a67f4b47791cb77de33e491df87cef06012c79f" url="https://api.github.com/repos/pengwynn/octokit/commits/7a67f4b47791cb77de33e491df87cef06012c79f">] sha="8db3df37fad3a021eb8036b007c718149836cb32" url="https://api.github.com/repos/pengwynn/octokit/commits/8db3df37fad3a021eb8036b007c718149836cb32">, ... , ...]
+=> [#<Hashie::Mash author=#<Hashie::Mash avatar_url="https://secure.gravatar.com/avatar/7e19cd5486b5d6dc1ef90e671ba52ae0?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png" gravatar_id="7e19cd5486b5d6dc1ef90e671ba52ae0" id=865 login="pengwynn" url="https://api.github.com/users/pengwynn"> commit=#<Hashie::Mash author=#<Hashie::Mash date="2012-10-31T15:17:51Z" email="wynn@github.com" name="Wynn Netherland"> comment_count=0 committer=#<Hashie::Mash date="2012-10-31T15:17:51Z" email="wynn@github.com" name="Wynn Netherland"> message="Fix bug with archive_link for private repo" tree=#<Hashie::Mash sha="49bf2a476aa819f29b0fc1a8805f7567f010006d" url="https://api.github.com/repos/octokit/octokit.rb/git/trees/49bf2a476aa819f29b0fc1a8805f7567f010006d"> url="https://api.github.com/repos/octokit/octokit.rb/git/commits/8db3df37fad3a021eb8036b007c718149836cb32"> committer=#<Hashie::Mash avatar_url="https://secure.gravatar.com/avatar/7e19cd5486b5d6dc1ef90e671ba52ae0?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png" gravatar_id="7e19cd5486b5d6dc1ef90e671ba52ae0" id=865 login="pengwynn" url="https://api.github.com/users/pengwynn"> parents=[#<Hashie::Mash sha="7a67f4b47791cb77de33e491df87cef06012c79f" url="https://api.github.com/repos/octokit/octokit.rb/commits/7a67f4b47791cb77de33e491df87cef06012c79f">] sha="8db3df37fad3a021eb8036b007c718149836cb32" url="https://api.github.com/repos/octokit/octokit.rb/commits/8db3df37fad3a021eb8036b007c718149836cb32">, ... , ...]
 ```
 
-## Authenticated Requests
+#### Authenticated Requests
 For methods that require authentication, you'll need to setup a client with
 your login and password.
 
@@ -79,26 +64,7 @@ client = Octokit::Client.new(:login => "me", :oauth_token => "oauth2token")
 client.follow("sferik")
 ```
 
-### Using `.netrc` for stored credentials
-
-Octokit now supports [`.netrc`][netrc] files for storing your GitHub Basic Auth
-credentials. Given a `~/.netrc` like the following
-
-[netrc]: http://www.gnu.org/software/inetutils/manual/html_node/The-_002enetrc-File.html
-
-```
-machine api.github.com login pengwynn password 0ct0c4tz4ev3r!
-```
-
-You can make authenticated calls by telling Octokit to use credentials from
-this file:
-
-```ruby
-Octokit.netrc = true # or /path/to/file
-Octokit.user # authenticates as 'pengwynn' user
-```
-
-## Requesting a specific media type
+#### Requesting a specific media type
 
 You can pass an `:accept` option value to request a particular [media
 type][media-types].
@@ -106,10 +72,10 @@ type][media-types].
 [media-types]: http://developer.github.com/v3/media/
 
 ```ruby
-Octokit.contents 'pengwynn/octokit', :path => 'README.md', :accept => 'application/vnd.github.html'
+Octokit.contents 'octokit/octokit.rb', :path => 'README.md', :accept => 'application/vnd.github.html'
 ```
 
-## Using with GitHub Enterprise
+### Using with GitHub Enterprise
 
 To use with [GitHub Enterprise](https://enterprise.github.com/), you'll need to
 set the API and web endpoints before instantiating a client.
@@ -173,7 +139,7 @@ dependency. Please require it explicitly if you're running Ruby 1.8
 
 Octokit was initially created by Wynn Netherland and [Adam
 Stacoviak](http://twitter.com/adamstac) but has
-turned into a true community effort. Special thanks to the following core
+turned into a true community effort. Special thanks to the following
 contributors:
 
 * [Erik Michaels-Ober](http://github.com/sferik)
@@ -182,12 +148,14 @@ contributors:
 
 
 ## Inspiration
+
 Octokit was inspired by [Octopi][] and aims to be a lightweight,
 less-ActiveResourcey alternative.
 
 [octopi]: https://github.com/fcoury/octopi
 
 ## Copyright
+
 Copyright (c) 2011-2013 Wynn Netherland, Adam Stacoviak, Erik Michaels-Ober.
 See [LICENSE][] for details.
 

data/lib/octokit/client.rb

@@ -26,6 +26,7 @@ require 'octokit/client/markdown'
 require 'octokit/client/emojis'
 require 'octokit/client/statuses'
 require 'octokit/client/say'
+require 'octokit/client/stats'
 require 'octokit/client/rate_limit'
 require 'octokit/client/gitignore'
 require 'octokit/client/github'
@@ -69,6 +70,7 @@ module Octokit
     include Octokit::Client::Emojis
     include Octokit::Client::Statuses
     include Octokit::Client::Say
+    include Octokit::Client::Stats
     include Octokit::Client::RateLimit
     include Octokit::Client::Gitignore
     include Octokit::Client::GitHub

data/lib/octokit/client/authorizations.rb

@@ -72,7 +72,7 @@ module Octokit
       # @see http://developer.github.com/v3/oauth/#scopes for available scopes
       # @example Update the authorization for user ctshryock's project Zoidberg
       #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
-      #  client.create_authorization({:add_scopes => ["gist", "repo"], :note => "Why not Zoidberg possibly?"})
+      #  client.update_authorization(999999, {:add_scopes => ["gist", "repo"], :note => "Why not Zoidberg possibly?"})
       def update_authorization(number, options={})
         # Techincally we can omit scopes as GitHub has a default, however the
         # API will reject us if we send a POST request with an empty body.

data/lib/octokit/client/contents.rb

@@ -1,3 +1,5 @@
+require 'base64'
+
 module Octokit
   class Client
     module Contents
@@ -28,6 +30,107 @@ module Octokit
         url = "repos/#{Repository.new repo}/contents/#{repo_path}"
         get(url, options)
       end
+      alias :content :contents
+
+      # Add content to a repository
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param path [String] A path for the new content
+      # @param message [String] A commit message for adding the content
+      # @param optional content [String] The Base64-encoded content for the file
+      # @option options [String] :branch The branch on which to add the content
+      # @option options [String] :file Path or Ruby File object for content
+      # @return [Hash] The contents and commit info for the addition
+      # @see http://developer.github.com/v3/repos/contents/#create-a-file
+      # @example Add content at lib/octokit.rb
+      #   Octokit.create_contents("pengwynn/octokit",
+      #                    "lib/octokit.rb",
+      #                    "Adding content",
+      #                    "asdf9as0df9asdf8as0d9f8==...",
+      #                    :branch => "my-new-feature")
+      def create_contents(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        repo    = args.shift
+        path    = args.shift
+        message = args.shift
+        content = args.shift
+        if content.nil? && file = options.delete(:file)
+          case file
+          when String
+            if File.exists?(file)
+              file = File.open(file, "r")
+              content = file.read
+              file.close
+            end
+          when File
+            content = file.read
+            file.close
+          end
+        end
+        raise ArgumentError.new "content or :file option required" if content.nil?
+        options[:content] = Base64.encode64(content).delete("\r\n")
+        options[:message] = message
+        url = "repos/#{Repository.new repo}/contents/#{path}"
+        put(url, options)
+      end
+      alias :create_content :create_contents
+      alias :add_content :create_contents
+      alias :add_contents :create_contents
+
+      # Update content in a repository
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param path [String] A path for the content to update
+      # @param message [String] A commit message for updating the content
+      # @param sha [String] The _blob sha_ of the content to update
+      # @param content [String] The Base64-encoded content for the file
+      # @option options [String] :branch The branch on which to update the content
+      # @option options [String] :file Path or Ruby File object for content
+      # @return [Hash] The contents and commit info for the update
+      # @see http://developer.github.com/v3/repos/contents/#update-a-file
+      # @example Update content at lib/octokit.rb
+      #   Octokit.update_contents("pengwynn/octokit",
+      #                    "lib/octokit.rb",
+      #                    "Updating content",
+      #                    "7eb95f97e1a0636015df3837478d3f15184a5f49",
+      #                    "asdf9as0df9asdf8as0d9f8==...",
+      #                    :branch => "my-new-feature")
+      def update_contents(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        repo    = args.shift
+        path    = args.shift
+        message = args.shift
+        sha     = args.shift
+        content = args.shift
+        options.merge!(:sha => sha)
+        create_contents(repo, path, message, content, options)
+      end
+      alias :update_content :update_contents
+
+      # Delete content in a repository
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param path [String] A path for the content to delete
+      # @param message [String] A commit message for deleting the content
+      # @param sha [String] The _blob sha_ of the content to delete
+      # @option options [String] :branch The branch on which to delete the content
+      # @return [Hash] The commit info for the delete
+      # @see http://developer.github.com/v3/repos/contents/#delete-a-file
+      # @example Delete content at lib/octokit.rb
+      #   Octokit.delete_contents("pengwynn/octokit",
+      #                    "lib/octokit.rb",
+      #                    "Deleting content",
+      #                    "7eb95f97e1a0636015df3837478d3f15184a5f49",
+      #                    :branch => "my-new-feature")
+      def delete_contents(repo, path, message, sha, options = {})
+        options[:message] = message
+        options[:sha] = sha
+        url = "repos/#{Repository.new repo}/contents/#{path}"
+        delete(url, options)
+      end
+      alias :delete_content :delete_contents
+      alias :remove_content :delete_contents
+      alias :remove_contents :delete_contents
 
       # This method will provide a URL to download a tarball or zipball archive for a repository.
       #

data/lib/octokit/client/issues.rb

@@ -155,6 +155,7 @@ module Octokit
       # @option options [String] :assignee User login.
       # @option options [Integer] :milestone Milestone number.
       # @option options [String] :labels List of comma separated Label names. Example: <tt>bug,ui,@high</tt>.
+      # @option options [String] :state State of the issue. <tt>open</tt> or <tt>closed</tt>
       # @return [Issue] The updated Issue
       # @see http://developer.github.com/v3/issues/#edit-an-issue
       # @example Change the title of Issue #25

data/lib/octokit/client/markdown.rb

@@ -2,7 +2,7 @@ module Octokit
   class Client
     module Markdown
 
-      # Receive the default Readme for a repository
+      # Render an arbitrary Markdown document
       #
       # @param text [String] Markdown source
       # @option options [String] (optional) :mode (`markdown` or `gfm`)

data/lib/octokit/client/pub_sub_hubbub/service_hooks.rb

@@ -6,7 +6,7 @@ module Octokit
         #
         # @param repo [String, Repository, Hash] A GitHub repository
         # @param service_name [String] service name owner
-        # @param service_arguments [Hash] params that will be passed by subscibed hook.
+        # @param service_arguments [Hash] params that will be passed by subscribed hook.
         #    List of services is available @ https://github.com/github/github-services/tree/master/docs.
         #    Please refer Data node for complete list of arguments.
         # @example Subscribe to push events to one of your repositories to Travis-CI

data/lib/octokit/client/pulls.rb

@@ -131,7 +131,7 @@ module Octokit
       #     :since => '2010-05-04T23:45:02Z'
       #   })
       def pull_requests_comments(repo, options={})
-        get("repos/#{Repository.new repo}/pulls/comments")
+        get("repos/#{Repository.new repo}/pulls/comments", options)
       end
       alias :pulls_comments   :pull_requests_comments
       alias :reviews_comments :pull_requests_comments

data/lib/octokit/client/repositories.rb

@@ -12,6 +12,17 @@ module Octokit
       end
       alias :search_repos :search_repositories
 
+      # Check if a repository exists
+      #
+      # @see http://developer.github.com/v3/repos/#get
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Hashie::Mash] if a repository exists, false otherwise
+      def repository?(repo, options = {})
+        repository(repo, options)
+      rescue Octokit::NotFound
+        false
+      end
+
       # Get a single repository
       #
       # @see http://developer.github.com/v3/repos/#get
@@ -75,13 +86,14 @@ module Octokit
       #
       # @return [Array] List of repositories.
       def all_repositories(options={})
-        get '/repositories', options
+        get 'repositories', options
       end
 
       # Star a repository
       #
       # @param repo [String, Hash, Repository] A GitHub repository
       # @return [Boolean] `true` if successfully starred
+      # @see http://developer.github.com/v3/activity/starring/#star-a-repository
       def star(repo, options={})
         boolean_from_response(:put, "user/starred/#{Repository.new repo}", options)
       end
@@ -90,6 +102,7 @@ module Octokit
       #
       # @param repo [String, Hash, Repository] A GitHub repository
       # @return [Boolean] `true` if successfully unstarred
+      # @see http://developer.github.com/v3/activity/starring/#unstar-a-repository
       def unstar(repo, options={})
         boolean_from_response(:delete, "user/starred/#{Repository.new repo}", options)
       end
@@ -99,6 +112,7 @@ module Octokit
       # @param repo [String, Hash, Repository] A GitHub repository
       # @return [Boolean] `true` if successfully watched
       # @deprecated Use #star instead
+      # @see http://developer.github.com/v3/activity/watching/#watch-a-repository-legacy
       def watch(repo, options={})
         boolean_from_response(:put, "user/watched/#{Repository.new repo}", options)
       end
@@ -108,6 +122,7 @@ module Octokit
       # @param repo [String, Hash, Repository] A GitHub repository
       # @return [Boolean] `true` if successfully unwatched
       # @deprecated Use #unstar instead
+      # @see http://developer.github.com/v3/activity/watching/#stop-watching-a-repository-legacy
       def unwatch(repo, options={})
         boolean_from_response(:delete, "user/watched/#{Repository.new repo}", options)
       end
@@ -116,6 +131,7 @@ module Octokit
       #
       # @param repo [String, Hash, Repository] A GitHub repository
       # @return [Hashie::Mash] Repository info for the new fork
+      # @see http://developer.github.com/v3/repos/forks/#create-a-fork
       def fork(repo, options={})
         post "repos/#{Repository.new repo}/forks", options
       end
@@ -479,6 +495,7 @@ module Octokit
       #   events the hook is triggered for.
       # @option options [Boolean] :active Determines whether the hook is
       #   actually triggered on pushes.
+      # @return [Hashie::Mash] Hook info for the new hook
       # @see Octokit::Client
       # @see https://api.github.com/hooks
       # @see https://github.com/github/github-services
@@ -520,6 +537,7 @@ module Octokit
       #   to be removed from the list of events that the Hook triggers for.
       # @option options [Boolean] :active Determines whether the hook is
       #   actually triggered on pushes.
+      # @return [Hashie::Mash] Hook info for the updated hook
       # @see Octokit::Client
       # @see https://api.github.com/hooks
       # @see https://github.com/github/github-services

data/lib/octokit/client/stats.rb

@@ -0,0 +1,81 @@
+module Octokit
+  class Client
+    module Stats
+
+    # Get contributors list with additions, deletions, and commit counts
+    #
+    # @param repo [String, Hash, Repository] A GitHub repository
+    # @return [Array<Hashie::Mash>] Array of contributor stats
+    # @see http://developer.github.com/v3/repos/statistics/#get-contributors-list-with-additions-deletions-and-commit-counts
+    # @example Get contributor stats for octokit
+    #   @client.contributors_stats('pengwynn/octokit')
+    def contributors_stats(repo)
+      get_stats(repo, "contributors")
+    end
+    alias :contributor_stats :contributors_stats
+
+    # Get the last year of commit activity data
+    #
+    # @param repo [String, Hash, Repository] A GitHub repository
+    # @return [Array<Hashie::Mash>] The last year of commit activity grouped by
+    #   week. The days array is a group of commits per day, starting on Sunday.
+    # @see http://developer.github.com/v3/repos/statistics/#get-the-last-year-of-commit-activity-data
+    # @example Get commit activity for octokit
+    #   @client.commit_activity_stats('pengwynn/octokit')
+    def commit_activity_stats(repo)
+      get_stats(repo, "commit_activity")
+    end
+
+    # Get the number of additions and deletions per week
+    #
+    # @param repo [String, Hash, Repository] A GitHub repository
+    # @return [Array<Hashie::Mash>] Weekly aggregate of the number of additions
+    #   and deletions pushed to a repository.
+    # @see http://developer.github.com/v3/repos/statistics/#get-the-number-of-additions-and-deletions-per-week
+    # @example Get code frequency stats for octokit
+    #   @client.code_frequency_stats('pengwynn/octokit')
+    def code_frequency_stats(repo)
+      get_stats(repo, "code_frequency")
+    end
+
+    # Get the weekly commit count for the repo owner and everyone else
+    #
+    # @param repo [String, Hash, Repository] A GitHub repository
+    # @return [Hashie::Mash] Total commit counts for the owner and total commit
+    #   counts in all. all is everyone combined, including the owner in the last
+    #   52 weeks. If you’d like to get the commit counts for non-owners, you can
+    #   subtract all from owner.
+    # @see http://developer.github.com/v3/repos/statistics/#get-the-weekly-commit-count-for-the-repo-owner-and-everyone-else
+    # @example Get weekly commit counts for octokit
+    #   @client.participation_stats("pengwynn/octokit")
+    def participation_stats(repo)
+      get_stats(repo, "participation")
+    end
+
+    # Get the number of commits per hour in each day
+    #
+    # @param repo [String, Hash, Repository] A GitHub repository
+    # @return [Array<Array>] Arrays containing the day number, hour number, and
+    #   number of commits 
+    # @see http://developer.github.com/v3/repos/statistics/#get-the-number-of-commits-per-hour-in-each-day
+    # @example Get octokit punch card
+    #   @octokit.punch_card_stats
+    def punch_card_stats(repo)
+      get_stats(repo, "punch_card")
+    end
+    alias :punch_card :punch_card_stats
+
+    private
+
+    # @private Get stats for a repository
+    #
+    # @param repo [String, Hash, Repository] A GitHub repository
+    # @param metric [String] The metrics you are looking for
+    # @return [Array<Hashie::Mash>] Magical unicorn stats
+    def get_stats(repo, metric)
+      get("repos/#{Repository.new repo}/stats/#{metric}")
+    end
+
+    end
+  end
+end