octokit 4.7.0 → 4.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 24ad9c72b02054c430f10ff8614064cce38297b2
-  data.tar.gz: 11f0aebf4f5266212ebaa314702622f7fdf0d6be
+  metadata.gz: 6f3b264edbac32970be83bf7b14081732f130d12
+  data.tar.gz: 15af8a2c6a80cfe94fdd14bb56a68dfbc772cb45
 SHA512:
-  metadata.gz: 0067cbdcbdd2bd217622159bc716c5f2ba50b7ae2a6bcff8234ba0ec8a0dcd1c4d7f009d6391d6f70c8f7fb5ff907ed27e56c0ba9204edb021e8d5ef6422df16
-  data.tar.gz: d1c6ee18fcdbbcd0c0d2115e3bdf24c832e57d03a8454d1a3ad7f474733854d9992f4323a504256117ccc7769120971bb1634417a5d710ff49ee635187716a48
+  metadata.gz: 7a77fc4d18fbc0dac671774e2486ba93aee5a434490db33579afa768a0386fbf12fcc251ff19fa514fa4f0bf564c643538b6b6a33360311bd05d789bfa6914e0
+  data.tar.gz: 134a0f49e4ade9f5b0ffc377b9394d4597c6fe69a871d27b2c90912024b4cd52ab1efc7de6019fcf3140fb756a2a9023f1fa742443227f63888113217ede8a16

data/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2016 Wynn Netherland, Adam Stacoviak, Erik Michaels-Ober
+Copyright (c) 2009-2017 Wynn Netherland, Adam Stacoviak, Erik Michaels-Ober
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -96,6 +96,21 @@ client = Octokit::Client.new(:login => 'defunkt', :password => 'c0d3b4ssssss!')
 client.user
 ```
 
+### Additional Query Parameters
+
+When passing additional parameters to GET based request use the following syntax:
+
+```ruby
+ # query: { parameter_name: 'value' }
+ # Example: Get repository listing by owner in ascending order
+ client.repos({}, query: {type: 'owner', sort: 'asc'})
+
+ # Example: Get contents of a repository by ref
+ # https://api.github.com/repos/octokit/octokit.rb/contents/path/to/file.rb?ref=some-other-branch
+ client.contents('octokit/octokit.rb', path: 'path/to/file.rb', query: {ref: 'some-other-branch'})
+
+```
+
 [API methods]: http://octokit.github.io/octokit.rb/method_list.html
 
 ### Consuming resources
@@ -262,6 +277,14 @@ user = client.user 'defunkt'
 [access scopes]: http://developer.github.com/v3/oauth/#scopes
 [app-creds]: http://developer.github.com/v3/#increasing-the-unauthenticated-rate-limit-for-oauth-applications
 
+## Default results per_page
+
+Default results from the GitHub API are 30, if you wish to add more you must do so during Octokit configuration.
+
+```ruby
+  Octokit::Client.new(access_token: "<your 40 char token>", per_page: 100)
+```
+
 ## Pagination
 
 Many GitHub API resources are [paginated][]. While you may be tempted to start
@@ -270,7 +293,7 @@ previous, and last pages for you in the `Link` response header as [Hypermedia
 link relations](#hypermedia-agent).
 
 ```ruby
-issues = Octokit.issues 'rails/rails', :per_page => 100
+issues = Octokit.issues 'rails/rails'
 issues.concat Octokit.last_response.rels[:next].get.data
 ```
 
@@ -526,8 +549,10 @@ traffic:
 
 ```ruby
 stack = Faraday::RackBuilder.new do |builder|
-  builder.response :logger
+  builder.use Octokit::Middleware::FollowRedirects
   builder.use Octokit::Response::RaiseError
+  builder.use Octokit::Response::FeedParser
+  builder.response :logger
   builder.adapter Faraday.default_adapter
 end
 Octokit.middleware = stack
@@ -655,6 +680,7 @@ implementations:
 * Ruby 2.1
 * Ruby 2.2
 * Ruby 2.3
+* Ruby 2.4
 
 If something doesn't work on one of these Ruby versions, it's a bug.
 

data/lib/octokit/client.rb

@@ -10,6 +10,7 @@ require 'octokit/repository'
 require 'octokit/user'
 require 'octokit/organization'
 require 'octokit/preview'
+require 'octokit/client/apps'
 require 'octokit/client/authorizations'
 require 'octokit/client/commits'
 require 'octokit/client/commit_comments'
@@ -22,13 +23,13 @@ require 'octokit/client/feeds'
 require 'octokit/client/gists'
 require 'octokit/client/gitignore'
 require 'octokit/client/hooks'
-require 'octokit/client/integrations'
 require 'octokit/client/issues'
 require 'octokit/client/labels'
 require 'octokit/client/legacy_search'
 require 'octokit/client/licenses'
 require 'octokit/client/meta'
 require 'octokit/client/markdown'
+require 'octokit/client/marketplace'
 require 'octokit/client/milestones'
 require 'octokit/client/notifications'
 require 'octokit/client/objects'
@@ -78,13 +79,14 @@ module Octokit
     include Octokit::Client::Gists
     include Octokit::Client::Gitignore
     include Octokit::Client::Hooks
-    include Octokit::Client::Integrations
+    include Octokit::Client::Apps
     include Octokit::Client::Issues
     include Octokit::Client::Labels
     include Octokit::Client::LegacySearch
     include Octokit::Client::Licenses
     include Octokit::Client::Meta
     include Octokit::Client::Markdown
+    include Octokit::Client::Marketplace
     include Octokit::Client::Milestones
     include Octokit::Client::Notifications
     include Octokit::Client::Objects

data/lib/octokit/client/apps.rb

@@ -0,0 +1,164 @@
+module Octokit
+  class Client
+
+    # Methods for the Apps API
+    module Apps
+
+      # Find all installations that belong to an App
+      #
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/#find-installations
+      #
+      # @return [Array<Sawyer::Resource>] A list of installations
+      def find_app_installations(options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        paginate "app/installations", opts
+      end
+      alias find_installations find_app_installations
+
+      def find_integration_installations(options = {})
+        octokit_warn(
+          "Deprecated: Octokit::Client::Apps#find_integration_installations "\
+          "method is deprecated. Please update your call to use "\
+          "Octokit::Client::Apps#find_app_installations before the next major "\
+          "Octokit version update."
+        )
+        find_app_installations(options)
+      end
+
+      # Find all installations that are accessible to the authenticated user
+      #
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/#list-installations-for-user
+      #
+      # @return [Array<Sawyer::Resource>] A list of installations
+      def find_user_installations(options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        paginate "user/installations", opts
+      end
+
+      # Get a single installation
+      #
+      # @param id [Integer] Installation id
+      #
+      # @see https://developer.github.com/v3/apps/#get-a-single-installation
+      #
+      # @return [Sawyer::Resource] Installation information
+      def installation(id, options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        get "app/installations/#{id}", opts
+      end
+
+      # Create a new installation token
+      #
+      # @param installation [Integer] The id of a GitHub App Installation
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/#find-installations
+      #
+      # @return [<Sawyer::Resource>] An installation token
+      def create_app_installation_access_token(installation, options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        post "installations/#{installation}/access_tokens", opts
+      end
+      alias create_installation_access_token create_app_installation_access_token
+
+      def create_integration_installation_access_token(installation, options = {})
+        octokit_warn(
+          "Deprecated: Octokit::Client::Apps#create_integration_installation_access_token "\
+          "method is deprecated. Please update your call to use "\
+          "Octokit::Client::Apps#create_app_installation_access_token before the next major "\
+          "Octokit version update."
+        )
+        create_app_installation_access_token(installation, options)
+      end
+
+      # List repositories that are accessible to the authenticated installation
+      #
+      # @param options [Hash] A customizable set of options
+      # @see https://developer.github.com/v3/apps/installations/#list-repositories
+      #
+      # @return [Array<Sawyer::Resource>] A list of repositories
+      def list_app_installation_repositories(options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        paginate "installation/repositories", opts
+      end
+      alias list_installation_repos list_app_installation_repositories
+
+      def list_integration_installation_repositories(options = {})
+        octokit_warn(
+          "Deprecated: Octokit::Client::Apps#list_integration_installation_repositories "\
+          "method is deprecated. Please update your call to use "\
+          "Octokit::Client::Apps#list_app_installation_repositories before the next major "\
+          "Octokit version update."
+        )
+        list_app_installation_repositories(options)
+      end
+
+      # Add a single repository to an installation
+      #
+      # @param installation [Integer] The id of a GitHub App Installation
+      # @param repo [Integer] The id of the GitHub repository
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/installations/#add-repository-to-installation
+      #
+      # @return [Boolean] Success
+      def add_repository_to_app_installation(installation, repo, options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        boolean_from_response :put, "user/installations/#{installation}/repositories/#{repo}", opts
+      end
+      alias add_repo_to_installation add_repository_to_app_installation
+
+      def add_repository_to_integration_installation(installation, repo, options = {})
+        octokit_warn(
+          "Deprecated: Octokit::Client::Apps#add_repository_to_integration_installation "\
+          "method is deprecated. Please update your call to use "\
+          "Octokit::Client::Apps#add_repository_to_app_installation before the next major "\
+          "Octokit version update."
+        )
+        add_repository_to_app_installation(installation, repo, options)
+      end
+
+      # Remove a single repository to an installation
+      #
+      # @param installation [Integer] The id of a GitHub App Installation
+      # @param repo [Integer] The id of the GitHub repository
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/installations/#remove-repository-from-installation
+      #
+      # @return [Boolean] Success
+      def remove_repository_from_app_installation(installation, repo, options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        boolean_from_response :delete, "user/installations/#{installation}/repositories/#{repo}", opts
+      end
+      alias remove_repo_from_installation remove_repository_from_app_installation
+
+      def remove_repository_from_integration_installation(installation, repo, options = {})
+        octokit_warn(
+          "Deprecated: Octokit::Client::Apps#remove_repository_from_integration_installation "\
+          "method is deprecated. Please update your call to use "\
+          "Octokit::Client::Apps#remove_repository_from_app_installation before the next major "\
+          "Octokit version update."
+        )
+        remove_repository_from_app_installation(installation, repo, options)
+      end
+
+      # List repositories accessible to the user for an installation
+      #
+      # @param installation [Integer] The id of a GitHub App Installation
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/apps/building-integrations/setting-up-and-registering-github-apps/identifying-users-for-github-apps/
+      #
+      # @return [Array<Sawyer::Resource>] A list of repositories
+      def find_installation_repositories_for_user(installation, options = {})
+        opts = ensure_api_media_type(:integrations, options)
+        paginate "user/installations/#{installation}/repositories", opts
+      end
+    end
+  end
+end

data/lib/octokit/client/issues.rb

@@ -316,6 +316,19 @@ module Octokit
         options = ensure_api_media_type(:issue_timelines, options)
         paginate "#{Repository.path repo}/issues/#{number}/timeline", options
       end
+
+      # Add assignees to an issue
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param number [Integer] Issue number
+      # @param assignees [Array] Assignees to be added
+      # @return [Sawyer::Resource] Issue
+      # @see https://developer.github.com/v3/issues/assignees/#add-assignees-to-an-issue
+      # @example Add assignees "pengwynn" and "joeyw" to Issue #23 on octokit/octokit.rb
+      #   Octokit.add_assignees("octokit/octokit.rb", 23, ["pengwynn", "joeyw"])
+      def add_assignees(repo, number, assignees, options = {})
+        post "#{Repository.path repo}/issues/#{number}/assignees", options.merge({:assignees => assignees})
+      end
     end
   end
 end

data/lib/octokit/client/licenses.rb

@@ -35,7 +35,7 @@ module Octokit
       # @option options [String] :ref name of the Commit/Branch/Tag. Defaults to 'master'.
       # @return [Sawyer::Resource] The detail of the license file
       # @example
-      #   Octokit.license_contents 'benbalter/licensee'
+      #   Octokit.repository_license_contents 'benbalter/licensee'
       def repository_license_contents(repo, options = {})
         options = ensure_api_media_type(:licenses, options)
         get "#{Repository.path repo}/license", options

data/lib/octokit/client/marketplace.rb

@@ -0,0 +1,60 @@
+module Octokit
+  class Client
+
+    # Methods for the Marketplace Listing API
+    #
+    # @see https://developer.github.com/v3/apps/marketplace/
+    module Marketplace
+
+      # List all plans for an app's marketplace listing
+      #
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/marketplace/#list-all-plans-for-your-marketplace-listing
+      #
+      # @return [Array<Sawyer::Resource>] A list of plans
+      def list_plans(options = {})
+        opts = ensure_api_media_type(:marketplace, options)
+        paginate "/marketplace_listing/plans", opts
+      end
+
+      # List all GitHub accounts on a specific plan
+      #
+      # @param plan_id [Integer] The id of the GitHub plan
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/marketplace/#list-all-github-accounts-user-or-organization-on-a-specific-plan
+      #
+      # @return [Array<Sawyer::Resource>] A list of accounts
+      def list_accounts_for_plan(plan_id, options = {})
+        opts = ensure_api_media_type(:marketplace, options)
+        paginate "/marketplace_listing/plans/#{plan_id}/accounts", opts
+      end
+
+      # Get the plan associated with a given GitHub account
+      #
+      # @param account_id [Integer] The id of the GitHub account
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/marketplace/#check-if-a-github-account-is-associated-with-any-marketplace-listing
+      #
+      # @return <Sawyer::Resource> Account with plan details, or nil
+      def plan_for_account(account_id, options = {})
+        opts = ensure_api_media_type(:marketplace, options)
+        get "/marketplace_listing/accounts/#{account_id}", opts
+      end
+
+      # Get user's Marketplace purchases
+      #
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://developer.github.com/v3/apps/marketplace/#get-a-users-marketplace-purchases
+      #
+      # @return [Array<Sawyer::Resource>] A list of Marketplace purchases
+      def marketplace_purchases(options = {})
+        opts = ensure_api_media_type(:marketplace, options)
+        get "/user/marketplace_purchases", opts
+      end
+    end
+  end
+end

data/lib/octokit/client/notifications.rb

@@ -108,10 +108,6 @@ module Octokit
       # Mark thread as read
       #
       # @param thread_id [Integer] Id of the thread to update.
-      # @param options [Hash] Optional parameters.
-      # @option options [Boolean] :unread Changes the unread status of the
-      #   threads.
-      # @option options [Boolean] :read Inverse of 'unread'.
       # @return [Boolean] True if updated, false otherwise.
       # @see https://developer.github.com/v3/activity/notifications/#mark-a-thread-as-read
       # @example

data/lib/octokit/client/organizations.rb

@@ -220,7 +220,6 @@ module Octokit
       # @example
       #   @client.organization_invitations('github')
       def organization_invitations(org, options = {})
-        options = ensure_api_media_type(:org_memberships, options)
         get "#{Organization.path org}/invitations", options
       end
       alias :org_invitations :organization_invitations
@@ -236,7 +235,6 @@ module Octokit
       # @example
       #   @client.outside_collaborators('github')
       def outside_collaborators(org, options={})
-        options = ensure_api_media_type(:org_memberships, options)
         get "#{Organization.path org}/outside_collaborators", options
       end
 
@@ -252,7 +250,6 @@ module Octokit
       # @example
       #   @client.remove_outside_collaborator('github', 'lizzhale')
       def remove_outside_collaborator(org, user, options={})
-        options = ensure_api_media_type(:org_memberships, options)
         boolean_from_response :delete, "#{Organization.path org}/outside_collaborators/#{user}", options
       end
 
@@ -268,7 +265,6 @@ module Octokit
       # @example
       #   @client.convert_to_outside_collaborator('github', 'lizzhale')
       def convert_to_outside_collaborator(org, user, options={})
-        options = ensure_api_media_type(:org_memberships, options)
         boolean_from_response :put, "#{Organization.path org}/outside_collaborators/#{user}", options
       end
 
@@ -296,6 +292,7 @@ module Octokit
       # @option options [String] :name Team name.
       # @option options [Array<String>] :repo_names Repositories for the team.
       # @option options [Array<String>] :maintainers Maintainers for the team.
+      # @option options [Integer] :parent_team_id ID of a team to set as the parent team.
       # @return [Sawyer::Resource] Hash representing new team.
       # @see https://developer.github.com/v3/orgs/teams/#create-team
       # @example
@@ -307,6 +304,9 @@ module Octokit
         if options.key?(:permission)
           octokit_warn "Deprecated: Passing :permission option to #create_team. Assign team repository permission by passing :permission to #add_team_repository instead."
         end
+        if options.key?(:parent_team_id)
+          options = ensure_api_media_type(:nested_teams, options)
+        end
         post "#{Organization.path org}/teams", options
       end
 
@@ -323,6 +323,20 @@ module Octokit
         get "teams/#{team_id}", options
       end
 
+      # List child teams
+      #
+      # Requires authenticated organization member.
+      #
+      # @param team_id [Integer] Team id.
+      # @return [Sawyer::Resource] Hash representing team.
+      # @see https://developer.github.com/v3/orgs/teams/#list-child-teams
+      # @example
+      #   @client.child_teams(100000, :accept => "application/vnd.github.hellcat-preview+json")
+      def child_teams(team_id, options = {})
+        options = ensure_api_media_type(:nested_teams, options)
+        paginate "teams/#{team_id}/teams", options
+      end
+
       # Update team
       #
       # Requires authenticated organization owner.
@@ -334,6 +348,7 @@ module Octokit
       #   `pull` - team members can pull, but not push to or administer these repositories.
       #   `push` - team members can pull and push, but not administer these repositories.
       #   `admin` - team members can pull, push and administer these repositories.
+      # @option options [Integer] :parent_team_id ID of a team to set as the parent team.
       # @return [Sawyer::Resource] Hash representing updated team.
       # @see https://developer.github.com/v3/orgs/teams/#edit-team
       # @example
@@ -342,6 +357,9 @@ module Octokit
       #     :permission => 'push'
       #   })
       def update_team(team_id, options = {})
+        if options.key?(:parent_team_id)
+          options = ensure_api_media_type(:nested_teams, options)
+        end
         patch "teams/#{team_id}", options
       end
 
@@ -444,7 +462,6 @@ module Octokit
       # @example
       #   @client.team_invitations('github')
       def team_invitations(team_id, options = {})
-        options = ensure_api_media_type(:org_memberships, options)
         get "teams/#{team_id}/invitations", options
       end
 
@@ -610,7 +627,7 @@ module Octokit
       #
       # @return [Sawyer::Resource] Hash of team membership info
       #
-      # @see https://developer.github.com/v3/orgs/teams/#add-team-membership
+      # @see https://developer.github.com/v3/orgs/teams/#add-or-update-team-membership
       #
       # @example Check if a user has a membership for a team
       #   @client.add_team_membership(1234, 'pengwynn')

data/lib/octokit/client/repositories.rb

@@ -358,7 +358,6 @@ module Octokit
       # @example
       #   @client.permission_level('octokit/octokit.rb', 'lizzhale')
       def permission_level(repo, collaborator, options={})
-        options = ensure_api_media_type(:org_memberships, options)
         get "#{Repository.path repo}/collaborators/#{collaborator}/permission", options
       end
 
@@ -516,7 +515,7 @@ module Octokit
       # @param repo [Integer, String, Hash, Repository] A GitHub repository.
       # @param branch [String] Branch name
       # @option options [Hash] :required_status_checks If not null, the following keys are required:  
-      #   <tt>:include_admins [boolean] Enforce required status checks for repository administrators.</tt>  
+      #   <tt>:enforce_admins [boolean] Enforce required status checks for repository administrators.</tt>  
       #   <tt>:strict [boolean] Require branches to be up to date before merging.</tt>  
       #   <tt>:contexts [Array] The list of status checks to require in order to merge into this branch</tt>  
       #

data/lib/octokit/client/reviews.rb

@@ -17,8 +17,7 @@ module Octokit
       #
       # @return [Array<Sawyer::Resource>] Array of Hashes representing the reviews
       def pull_request_reviews(repo, id, options = {})
-        options = ensure_api_media_type(:reviews, options)
-        get "#{Repository.path repo}/pulls/#{id}/reviews", options
+        paginate "#{Repository.path repo}/pulls/#{id}/reviews", options
       end
 
       # Get a single review
@@ -33,7 +32,6 @@ module Octokit
       #
       # @return [Sawyer::Resource] Hash representing the review
       def pull_request_review(repo, number, review, options = {})
-        options = ensure_api_media_type(:reviews, options)
         get "#{Repository.path repo}/pulls/#{number}/reviews/#{review}", options
       end
 
@@ -49,7 +47,6 @@ module Octokit
       #
       # @return [Sawyer::Resource] Hash representing the deleted review
       def delete_pull_request_review(repo, number, review, options = {})
-        options = ensure_api_media_type(:reviews, options)
         delete "#{Repository.path repo}/pulls/#{number}/reviews/#{review}", options
       end
 
@@ -65,8 +62,7 @@ module Octokit
       #
       # @return [Array<Sawyer::Resource>] Array of Hashes representing the review comments
       def pull_request_review_comments(repo, number, review, options = {})
-        options = ensure_api_media_type(:reviews, options)
-        get "#{Repository.path repo}/pulls/#{number}/reviews/#{review}/comments", options
+        paginate "#{Repository.path repo}/pulls/#{number}/reviews/#{review}/comments", options
       end
 
       # Create a pull request review
@@ -94,7 +90,6 @@ module Octokit
       #
       # @return [Sawyer::Resource>] Hash respresenting the review
       def create_pull_request_review(repo, id, options = {})
-        options = ensure_api_media_type(:reviews, options)
         post "#{Repository.path repo}/pulls/#{id}/reviews", options
       end
 
@@ -116,7 +111,6 @@ module Octokit
       # @return [Sawyer::Resource] Hash respresenting the review
       def submit_pull_request_review(repo, number, review, event, options = {})
         options = options.merge(event: event)
-        options = ensure_api_media_type(:reviews, options)
         post "#{Repository.path repo}/pulls/#{number}/reviews/#{review}/events", options
       end
 
@@ -134,7 +128,6 @@ module Octokit
       # @return [Sawyer::Resource] Hash representing the dismissed review
       def dismiss_pull_request_review(repo, number, review, message, options = {})
         options = options.merge(message: message)
-        options = ensure_api_media_type(:reviews, options)
         put "#{Repository.path repo}/pulls/#{number}/reviews/#{review}/dismissals", options
       end
 
@@ -149,8 +142,7 @@ module Octokit
       #
       # @return [Array<Sawyer::Resource>] Array of Hashes representing the review requests
       def pull_request_review_requests(repo, id, options = {})
-        options = ensure_api_media_type(:reviews, options)
-        get "#{Repository.path repo}/pulls/#{id}/requested_reviewers", options
+        paginate "#{Repository.path repo}/pulls/#{id}/requested_reviewers", options
       end
 
       # Create a review request
@@ -166,7 +158,6 @@ module Octokit
       # @return [Sawyer::Resource>] Hash respresenting the pull request
       def request_pull_request_review(repo, id, reviewers, options = {})
         options = options.merge(reviewers: reviewers)
-        options = ensure_api_media_type(:reviews, options)
         post "#{Repository.path repo}/pulls/#{id}/requested_reviewers", options
       end
     end

data/lib/octokit/error.rb

@@ -103,6 +103,20 @@ module Octokit
       @response[:status]
     end
 
+    # Headers returned by the GitHub server.
+    #
+    # @return [Hash]
+    def response_headers
+      @response[:response_headers]
+    end
+
+    # Body returned by the GitHub server.
+    #
+    # @return [String]
+    def response_body
+      @response[:body]
+    end
+
     private
 
     def data

data/lib/octokit/preview.rb

@@ -11,12 +11,13 @@ module Octokit
       :reactions              => 'application/vnd.github.squirrel-girl-preview'.freeze,
       :repository_invitations => 'application/vnd.github.swamp-thing-preview+json'.freeze,
       :issue_timelines        => 'application/vnd.github.mockingbird-preview+json'.freeze,
+      :nested_teams           => 'application/vnd.github.hellcat-preview+json'.freeze,
       :pages                  => 'application/vnd.github.mister-fantastic-preview+json'.freeze,
       :projects               => 'application/vnd.github.inertia-preview+json'.freeze,
       :traffic                => 'application/vnd.github.spiderman-preview'.freeze,
-      :org_membership         => 'application/vnd.github.korra-preview'.freeze,
-      :reviews                => 'application/vnd.github.black-cat-preview'.freeze,
-      :integrations           => 'application/vnd.github.machine-man-preview+json'.freeze
+      :integrations           => 'application/vnd.github.machine-man-preview+json'.freeze,
+      :marketplace            => 'application/vnd.github.valkyrie-preview+json'.freeze,
+      :topics                 => 'application/vnd.github.mercy-preview+json'.freeze
     }
 
     def ensure_api_media_type(type, options)

data/lib/octokit/repository.rb

@@ -28,13 +28,13 @@ module Octokit
         @owner = repo.owner
         @name = repo.name
       when Hash
-        @name = repo[:repo] ||= repo[:name]
-        @owner = repo[:owner] ||= repo[:user] ||= repo[:username]
+        @name = repo[:repo] || repo[:name]
+        @owner = repo[:owner] || repo[:user] || repo[:username]
       else
-        raise_invalid_repository!
+        raise_invalid_repository!(repo)
       end
       if @owner && @name
-        validate_owner_and_name!
+        validate_owner_and_name!(repo)
       end
     end
 
@@ -80,14 +80,16 @@ module Octokit
 
     private
 
-      def validate_owner_and_name!
+      def validate_owner_and_name!(repo)
         if @owner.include?('/') || @name.include?('/') || !url.match(URI::ABS_URI)
-          raise_invalid_repository!
+          raise_invalid_repository!(repo)
         end
       end
 
-      def raise_invalid_repository!
-        raise Octokit::InvalidRepository, "Invalid Repository. Use user/repo format."
+      def raise_invalid_repository!(repo)
+        msg = "#{repo.inspect} is invalid as a repository identifier. " +
+              "Use the repo/user (String) format, or the repository ID (Integer), or a hash containing :repo and :user keys."
+        raise Octokit::InvalidRepository, msg
       end
   end
 end

data/lib/octokit/version.rb

@@ -5,7 +5,7 @@ module Octokit
 
   # Current minor release.
   # @return [Integer]
-  MINOR = 7
+  MINOR = 8
 
   # Current patch level.
   # @return [Integer]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: octokit
 version: !ruby/object:Gem::Version
-  version: 4.7.0
+  version: 4.8.0
 platform: ruby
 authors:
 - Wynn Netherland
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-05 00:00:00.000000000 Z
+date: 2017-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -65,6 +65,7 @@ files:
 - lib/octokit/arguments.rb
 - lib/octokit/authentication.rb
 - lib/octokit/client.rb
+- lib/octokit/client/apps.rb
 - lib/octokit/client/authorizations.rb
 - lib/octokit/client/commit_comments.rb
 - lib/octokit/client/commits.rb
@@ -77,12 +78,12 @@ files:
 - lib/octokit/client/gists.rb
 - lib/octokit/client/gitignore.rb
 - lib/octokit/client/hooks.rb
-- lib/octokit/client/integrations.rb
 - lib/octokit/client/issues.rb
 - lib/octokit/client/labels.rb
 - lib/octokit/client/legacy_search.rb
 - lib/octokit/client/licenses.rb
 - lib/octokit/client/markdown.rb
+- lib/octokit/client/marketplace.rb
 - lib/octokit/client/meta.rb
 - lib/octokit/client/milestones.rb
 - lib/octokit/client/notifications.rb
@@ -152,9 +153,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.5
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: Ruby toolkit for working with the GitHub API
 test_files: []
-has_rdoc: 

data/lib/octokit/client/integrations.rb

@@ -1,77 +0,0 @@
-module Octokit
-  class Client
-
-    # Methods for the Integrations API
-    module Integrations
-
-      # Find all installations that belong to an Integration
-      #
-      # @param options [Hash] An customizable set of options
-      #
-      # @see https://developer.github.com/v3/integrations/#find-installations
-      #
-      # @return [Array<Sawyer::Resource>] A list of installations
-      def find_integration_installations(options = {})
-        opts = ensure_api_media_type(:integrations, options)
-        paginate "/integration/installations", opts
-      end
-      alias find_installations find_integration_installations
-
-      # Create a new installation token
-      #
-      # @param installation [Integer] The id of a a GitHub Integration Installation
-      # @param options [Hash] An customizable set of options
-      #
-      # @see https://developer.github.com/v3/integrations/#find-installations
-      #
-      # @return [<Sawyer::Resource>] An installation token
-      def create_integration_installation_access_token(installation, options = {})
-        opts = ensure_api_media_type(:integrations, options)
-        post "/installations/#{installation}/access_tokens", opts
-      end
-      alias create_installation_access_token create_integration_installation_access_token
-
-      # List repositories that are accessible to the authenticated installation
-      #
-      # @param options [Hash] An customizable set of options
-      # @see https://developer.github.com/v3/integrations/installations/#list-repositories
-      #
-      # @return [Array<Sawyer::Resource>] A list of repositories
-      def list_integration_installation_repositories(options = {})
-        opts = ensure_api_media_type(:integrations, options)
-        paginate "/installation/repositories", opts
-      end
-      alias list_installation_repos list_integration_installation_repositories
-
-      # Add a single repository to an installation
-      #
-      # @param installation [Integer] The id of a a GitHub Integration Installation
-      # @param repo [Integer] The id of the GitHub repository
-      # @param options [Hash] An customizable set of options
-      #
-      # @see https://developer.github.com/v3/integrations/installations/#add-repository-to-installation
-      #
-      # @return [Boolean] Success
-      def add_repository_to_integration_installation(installation, repo, options = {})
-        opts = ensure_api_media_type(:integrations, options)
-        boolean_from_response :put, "/installations/#{installation}/repositories/#{repo}", opts
-      end
-      alias add_repo_to_installation add_repository_to_integration_installation
-
-      # Remove a single repository to an installation
-      #
-      # @param installation [Integer] The id of a a GitHub Integration Installation
-      # @param repo [Integer] The id of the GitHub repository
-      # @param options [Hash] An customizable set of options
-      #
-      # @see https://developer.github.com/v3/integrations/installations/#remove-repository-from-installation
-      #
-      # @return [Boolean] Success
-      def remove_repository_from_integration_installation(installation, repo, options = {})
-        opts = ensure_api_media_type(:integrations, options)
-        boolean_from_response :delete, "/installations/#{installation}/repositories/#{repo}", opts
-      end
-      alias remove_repo_from_installation remove_repository_from_integration_installation
-    end
-  end
-end