github_api 0.17.0 → 0.18.1

data/lib/github_api/client/gitignore.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   # When you create a new GitHub repository via the API, you can specify a
   # .gitignore template to apply to the repository upon creation.

data/lib/github_api/client/issues.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   class Client::Issues < API
 

data/lib/github_api/client/issues/assignees.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Issues::Assignees < API
     # Lists all the available assignees (owner + collaborators)
@@ -38,5 +40,38 @@ module Github
     rescue Github::Error::NotFound
       false
     end
+
+    # Add assignees to an issue
+    #
+    # @example
+    #   github = Github.new
+    #   github.issues.assignees.add 'user', 'repo', 'issue-number',
+    #     'hubot', 'other_assignee', ...
+    #
+    # @api public
+    def add(*args)
+      arguments(args, required: [:user, :repo, :number])
+      params = arguments.params
+      params['data'] = { 'assignees' => arguments.remaining } unless arguments.remaining.empty?
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/issues/#{arguments.number}/assignees", params)
+    end
+    alias :<< :add
+
+    # Remove a assignees from an issue
+    #
+    # @example
+    #   github = Github.new
+    #   github.issues.assignees.remove 'user', 'repo', 'issue-number',
+    #     'hubot', 'other_assignee'
+    #
+    # @api public
+    def remove(*args)
+      arguments(args, required: [:user, :repo, :number])
+      params = arguments.params
+      params['data'] = { 'assignees' => arguments.remaining } unless arguments.remaining.empty?
+
+      delete_request("/repos/#{arguments.user}/#{arguments.repo}/issues/#{arguments.number}/assignees", params)
+    end
   end # Issues::Assignees
 end # Github

data/lib/github_api/client/issues/comments.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Issues::Comments < API
 

data/lib/github_api/client/issues/events.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Issues::Events < API
     # List events for an issue

data/lib/github_api/client/issues/labels.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Issues::Labels < API
 

data/lib/github_api/client/issues/milestones.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Issues::Milestones < API
 

data/lib/github_api/client/markdown.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   class Client::Markdown < API
 
@@ -49,7 +51,7 @@ module Github
     #
     def render_raw(*args)
       params = arguments(args).params
-      mime_type, params['data'] = params['mime'], args.shift
+      params['data'] = args.shift
       params['raw'] = true
       params['accept'] = params.fetch('accept') { 'text/plain' }
 

data/lib/github_api/client/meta.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   class Client::Meta < API
     # Get meta information about GitHub.com, the service.

data/lib/github_api/client/orgs.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   # Organizations API
   class Client::Orgs < API

data/lib/github_api/client/orgs/hooks.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   # The Organizations Hooks API manages the post-receive web and
   # service hooks for an organization.

data/lib/github_api/client/orgs/members.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Orgs::Members < API
     # List members

data/lib/github_api/client/orgs/memberships.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Orgs::Memberships < API
     # List your organization memberships

data/lib/github_api/client/orgs/projects.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../../api'
+
 module Github
   class Client::Orgs::Projects < API
     PREVIEW_MEDIA = "application/vnd.github.inertia-preview+json".freeze # :nodoc:

data/lib/github_api/client/orgs/teams.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   # All actions against teams require at a minimum an authenticated user
   # who is a member of the owner's team in the :org being managed.

data/lib/github_api/client/projects.rb

@@ -1,6 +1,8 @@
 # encoding: utf-8
 # frozen_string_literal: true
 
+require_relative '../api'
+
 module Github
   # Projects API
   class Client::Projects < API

data/lib/github_api/client/projects/cards.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Projects::Cards < API
     REQUIRED_MOVE_CARD_PARAMS = %w(position).freeze
@@ -65,7 +67,7 @@ module Github
     #
     # @example
     # github = Github.new
-    # github.projects.cards.create :column_id, id: <content-id>, content_type: 'content-type'
+    # github.projects.cards.create :column_id, content_id: <content-id>, content_type: 'content-type'
     #
     # @see https://developer.github.com/v3/projects/cards/#create-a-project-card
     #

data/lib/github_api/client/projects/columns.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Projects::Columns < API
     REQUIRED_COLUMN_PARAMS = %w(name).freeze

data/lib/github_api/client/pull_requests.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   class Client::PullRequests < API
 

data/lib/github_api/client/pull_requests/comments.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::PullRequests::Comments < API
     # List comments on a pull request

data/lib/github_api/client/pull_requests/reviews.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::PullRequests::Reviews < API
     PREVIEW_MEDIA = "application/vnd.github.black-cat-preview+json".freeze # :nodoc:

data/lib/github_api/client/repos.rb

@@ -1,9 +1,12 @@
 # encoding: utf-8
 
+require_relative '../api'
+
 module Github
   class Client::Repos < API
     # Load all the modules after initializing Repos to avoid superclass mismatch
     require_all 'github_api/client/repos',
+      'branches',
       'collaborators',
       'comments',
       'commits',
@@ -87,6 +90,9 @@ module Github
     # Access to Repos::Statuses API
     namespace :statuses
 
+    # Access to Repos::Branches API
+    namespace :branches
+
     # List repositories for the authenticated user
     #
     # @example
@@ -278,7 +284,6 @@ module Github
       arguments(args, required: [:user, :repo]) do
         permit %w[ anon ]
       end
-      params = arguments.params
 
       response = get_request("/repos/#{arguments.user}/#{arguments.repo}/contributors", arguments.params)
       return response unless block_given?
@@ -338,7 +343,6 @@ module Github
     # @api public
     def delete(*args)
       arguments(args, required: [:user, :repo])
-      params = arguments.params
 
       delete_request("/repos/#{arguments.user}/#{arguments.repo}", arguments.params)
     end
@@ -356,14 +360,14 @@ module Github
     #   repos.branches 'user-name', 'repo-name'
     #
     # @api public
-    def branches(*args)
-      arguments(args, required: [:user, :repo])
+    # def branches(*args)
+    #   arguments(args, required: [:user, :repo])
 
-      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/branches", arguments.params)
-      return response unless block_given?
-      response.each { |el| yield el }
-    end
-    alias :list_branches :branches
+    #   response = get_request("/repos/#{arguments.user}/#{arguments.repo}/branches", arguments.params)
+    #   return response unless block_given?
+    #   response.each { |el| yield el }
+    # end
+    # alias :list_branches :branches
 
     # Get branch
     #
@@ -373,11 +377,11 @@ module Github
     #   github.repos.branch user: 'user-name', repo: 'repo-name', branch: 'branch-name'
     #   github.repos(user: 'user-name', repo: 'repo-name', branch: 'branch-name').branch
     # @api public
-    def branch(*args)
-      arguments(args, required: [:user, :repo, :branch])
+    # def branch(*args)
+    #   arguments(args, required: [:user, :repo, :branch])
 
-      get_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}", arguments.params)
-    end
+    #   get_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}", arguments.params)
+    # end
 
     # List contributors
     #

data/lib/github_api/client/repos/branches.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  class Client::Repos::Branches < API
+    require_all 'github_api/client/repos/branches', 'protections'
+
+    # Access to Repos::Branches::Protections API
+    namespace :protections
+
+    # List branches
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branches.list 'user-name', 'repo-name'
+    #   github.repos(user: 'user-name', repo: 'repo-name').branches.list
+    #
+    # @example
+    #   repos = Github::Repos.new
+    #   repos.branches.list 'user-name', 'repo-name'
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/branches", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get branch
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branches.get 'user-name', 'repo-name', 'branch-name'
+    #   github.repos.branches.get user: 'user-name', repo: 'repo-name', branch: 'branch-name'
+    #   github.repos(user: 'user-name', repo: 'repo-name', branch: 'branch-name').branches.get
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :branch])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}", arguments.params)
+    end
+    alias :find :get
+  end # Client::Repos::Branches
+end # Github

data/lib/github_api/client/repos/branches/protections.rb

@@ -0,0 +1,75 @@
+# encoding: utf-8
+
+require_relative '../../../api'
+
+module Github
+  # The Branch Protections API
+  class Client::Repos::Branches::Protections < API
+    VALID_PROTECTION_PARAM_NAMES = %w[
+      required_status_checks
+      required_pull_request_reviews
+      enforce_admins
+      restrictions
+      accept
+    ].freeze
+
+    # Get a single branch's protection
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branches.protections.get 'user', 'repo', 'branch'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :branch])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}/protection", arguments.params)
+    end
+    alias :find :get
+
+    # Edit a branch protection
+    #
+    # Users with push access to the repository can edit a branch protection.
+    #
+    # @param [Hash] params
+    # @input params [String] :required_status_checks
+    #   Required.
+    # @input params [String] :enforce_admins
+    #   Required.
+    # @input params [String] :restrictions
+    #   Required.
+    # @input params [String] :required_pull_request_reviews
+    #   Required.
+    # Look to the branch protection API t see how to use these
+    # https://developer.github.com/v3/repos/branches/#update-branch-protection
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branches.protections.edit 'user', 'repo', 'branch',
+    #     required_pull_request_reviews: {dismiss_stale_reviews: false}
+    #
+    # @api public
+    def edit(*args)
+      arguments(args, required: [:user, :repo, :branch]) do
+        permit VALID_PROTECTION_PARAM_NAMES
+      end
+
+      put_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}/protection", arguments.params)
+    end
+    alias :update :edit
+
+    # Delete a branch protection
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branches.protections.delete 'user', 'repo', 'branch'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:user, :repo, :branch])
+
+      delete_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}/protection", arguments.params)
+    end
+    alias :remove :delete
+  end # Client::Repos::Branches::Protections
+end # Github

data/lib/github_api/client/repos/collaborators.rb

@@ -1,5 +1,7 @@
 # encoding: utf-8
 
+require_relative '../../api'
+
 module Github
   class Client::Repos::Collaborators < API
     # List collaborators
@@ -21,7 +23,6 @@ module Github
     # @api public
     def list(*args)
       arguments(args, required: [:user, :repo])
-      params = arguments.params
 
       response = get_request("/repos/#{arguments.user}/#{arguments.repo}/collaborators", arguments.params)
       return response unless block_given?