github_api 0.11.3 → 0.12.0

data/lib/github_api/client/pull_requests.rb

@@ -0,0 +1,205 @@
+# encoding: utf-8
+
+module Github
+  class Client::PullRequests < API
+
+    require_all 'github_api/client/pull_requests',
+      'comments'
+
+    VALID_REQUEST_PARAM_NAMES = %w[
+      title
+      body
+      base
+      head
+      state
+      issue
+      commit_message
+      mime_type
+      resource
+    ].freeze
+
+    VALID_REQUEST_PARAM_VALUES = {
+      'state' => %w[ open closed ]
+    }
+
+    # Access to PullRequests::Comments API
+    namespace :comments
+
+    # List pull requests
+    #
+    # @example
+    #  github = Github.new user: 'user-name', repo: 'repo-name'
+    #  github.pull_requests.list
+    #  github.pull_requests.list { |req| ... }
+    #
+    # @example
+    #  pulls = Github::PullRequests.new
+    #  pulls.pull_requests.list 'user-name', 'repo-name'
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_REQUEST_PARAM_NAMES
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/pulls", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get a single pull request
+    #
+    # = Examples
+    #  github = Github.new
+    #  github.pull_requests.get 'user-name', 'repo-name', 'number'
+    #
+    #  pulls = Github::PullRequests.new
+    #  pulls.get 'user-name', 'repo-name', 'number'
+    #
+    def get(*args)
+      arguments(args, required: [:user, :repo, :number])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}", arguments.params)
+    end
+    alias :find :get
+
+    # Create a pull request
+    #
+    # @param [Hash] params
+    # @option params [String] :title 
+    #   Required string
+    # @option params [String] :body
+    #   Optional string
+    # @option params [String] :base
+    #   Required string - The branch you want your changes pulled into.
+    # @option params [String] :head
+    #   Required string - The branch where your changes are implemented.
+    #
+    # @note: head and base can be either a sha or a branch name.
+    # Typically you would namespace head with a user like this: username:branch.
+    #
+    # Alternative Input
+    # You can also create a Pull Request from an existing Issue by passing
+    # an Issue number instead of <tt>title</tt> and <tt>body</tt>.
+    # @option params [Numeric] :issue
+    #   Required number - Issue number in this repository to turn into a Pull Request.
+    #
+    # @example
+    #  github = Github.new oauth_token: '...'
+    #  github.pull_requests.create 'user-name', 'repo-name',
+    #    title: "Amazing new feature",
+    #    body: "Please pull this in!",
+    #    head: "octocat:new-feature",
+    #    base: "master"
+    #
+    # @example
+    #  github.pull_requests.create 'user-name', 'repo-name',
+    #    issue: "5",
+    #    head: "octocat:new-feature",
+    #    base: "master"
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_REQUEST_PARAM_NAMES
+      end
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/pulls", arguments.params)
+    end
+
+    # Update a pull request
+    #
+    # @param [Hash] params
+    # @option params [String] :title
+    #   Optional string
+    # @optoin params [String] :body
+    #   Optional string
+    # @option params [String] :state
+    #   Optional string - State of this Pull Request.
+    #   Valid values are open and closed.
+    #
+    # @example
+    #  github = Github.new oauth_token: '...'
+    #  github.pull_requests.update 'user-name', 'repo-name', 'number'
+    #    title: "Amazing new title",
+    #    body: "Update body",
+    #    state: "open"
+    #
+    # @api public
+    def update(*args)
+      arguments(args, required: [:user, :repo, :number]) do
+        permit VALID_REQUEST_PARAM_NAMES
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      patch_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}", arguments.params)
+    end
+
+    # List commits on a pull request
+    #
+    # @example
+    #  github = Github.new
+    #  github.pull_requests.commits 'user-name', 'repo-name', 'number'
+    #
+    # @api public
+    def commits(*args)
+      arguments(args, required: [:user, :repo, :number])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}/commits", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # List pull requests files
+    #
+    # @example
+    #  github = Github.new
+    #  github.pull_requests.files 'user-name', 'repo-name', 'number'
+    #
+    # @api public
+    def files(*args)
+      arguments(args, required: [:user, :repo, :number])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}/files", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # Check if pull request has been merged
+    #
+    # @example
+    #  github = Github.new
+    #  github.pull_requests.merged? 'user-name', 'repo-name', 'number'
+    #
+    # @api public
+    def merged?(*args)
+      arguments(args, required: [:user, :repo, :number])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}/merge", arguments.params)
+      true
+    rescue Github::Error::NotFound
+      false
+    end
+
+    # Merge a pull request(Merge Button)
+    #
+    # @param [Hash] params
+    # @option params [String] :commit_message
+    #   Optional string - The message that will be used for the merge commit
+    #
+    # @example
+    #  github = Github.new
+    #  github.pull_requests.merge 'user-name', 'repo-name', 'number'
+    #
+    # @api public
+    def merge(*args)
+      arguments(args, required: [:user, :repo, :number]) do
+        permit VALID_REQUEST_PARAM_NAMES
+      end
+
+      put_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}/merge", arguments.params)
+    end
+  end # PullRequests
+end # Github

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

@@ -0,0 +1,165 @@
+# encoding: utf-8
+
+module Github
+  class Client::PullRequests::Comments < API
+
+    VALID_REQUEST_COM_PARAM_NAMES = %w[
+      body
+      commit_id
+      path
+      position
+      in_reply_to
+      mime_type
+      resource
+    ].freeze
+
+    # List comments on a pull request
+    #
+    # @example
+    #   github = Github.new
+    #   github.pull_requests.comments.list 'user-name', 'repo-name', number: 'id'
+    #
+    # List comments in a repository
+    #
+    # By default, Review Comments are ordered by ascending ID.
+    #
+    # @param [Hash] params
+    # @input params [String] :sort
+    #   Optional string. Can be either created or updated. Default: created
+    # @input params [String] :direction
+    #   Optional string. Can be either asc or desc. Ignored without sort parameter
+    # @input params [String] :since
+    #   Optional string of a timestamp in ISO 8601
+    #                         format: YYYY-MM-DDTHH:MM:SSZ
+    # @example
+    #   github = Github.new
+    #   github.pull_requests.comments.list 'user-name', 'repo-name'
+    #   github.pull_requests.comments.list 'user-name', 'repo-name' { |comm| ... }
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:user, :repo])
+      params = arguments.params
+      user = arguments.user
+      repo = arguments.repo
+
+      response = if (number = params.delete('number'))
+        get_request("/repos/#{user}/#{repo}/pulls/#{number}/comments", params)
+      else
+        get_request("/repos/#{user}/#{repo}/pulls/comments", params)
+      end
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get a single comment for pull requests
+    #
+    # @example
+    #   github = Github.new
+    #   github.pull_requests.comments.get 'user-name', 'repo-name', 'number'
+    #
+    # @example
+    #   github.pull_requests.comments.get
+    #     user: 'user-name',
+    #     repo: 'repo-name',
+    #     number: 'comment-number
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :number])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/comments/#{arguments.number}", arguments.params)
+    end
+    alias :find :get
+
+    # Create a pull request comment
+    #
+    # @param [Hash] params
+    # @option params [String] :body
+    #   Required string. The text of the comment.
+    # @option params [String] :commit_id
+    #   Required string - The SHA of the commit to comment on.
+    # @option params [String] :path
+    #   Required string. The relative path of the file to comment on.
+    # @option params [Number] :position
+    #   Required number. The line index in the diff to comment on.
+    #
+    # @example
+    #  github = Github.new
+    #  github.pull_requests.comments.create 'user-name', 'repo-name', 'number',
+    #    body: "Nice change",
+    #    commit_id: "6dcb09b5b57875f334f61aebed695e2e4193db5e",
+    #    path: "file1.txt",
+    #    position: 4
+    #
+    # Alternative Inputs
+    #
+    # Instead of passing commit_id, path, and position you can reply to
+    # an existing Pull Request Comment like this
+    # @option params [String] :body
+    #   Required string. The text of the comment.
+    # @option params [Number] :in_reply_to
+    #   Required number. The comment id to reply to.
+    #
+    # @example
+    #   github = Github.new
+    #   github.pull_requests.comments.create 'user-name','repo-name', 'number',
+    #     body: "Nice change",
+    #     in_reply_to: 4
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo, :number]) do
+        permit VALID_REQUEST_COM_PARAM_NAMES
+      end
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/#{arguments.number}/comments", arguments.params)
+    end
+
+    # Edit a pull request comment
+    #
+    # @param [Hash] params
+    # @option params [String] :body
+    #   Required string. The text of the comment.
+    #
+    # @example
+    #   github = Github.new
+    #   github.pull_requests.comments.edit 'user-name', 'repo-name', 'number',
+    #     body: "Nice change"
+    #
+    # @api public
+    def edit(*args)
+      arguments(args, required: [:user, :repo, :number]) do
+        permit VALID_REQUEST_COM_PARAM_NAMES
+      end
+
+      patch_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/comments/#{arguments.number}", arguments.params)
+    end
+
+    # Delete a pull request comment
+    #
+    # @example
+    #   github = Github.new
+    #   github.pull_requests.comments.delete 'user-name', 'repo-name', 'number'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:user, :repo, :number])
+
+      delete_request("/repos/#{arguments.user}/#{arguments.repo}/pulls/comments/#{arguments.number}", arguments.params)
+    end
+
+  private
+
+    # To let user know that the params supplied are wrong before request is made
+    def _validate_reply_to(params)
+      if params['in_reply_to'] && !assert_required_keys(%w[ body in_reply_to ], params)
+        raise ArgumentError, "Required params are: #{%w[ body in_reply_to].join(',')}"
+
+      elsif !assert_required_keys(VALID_REQUEST_COM_PARAM_NAMES - %w[ in_reply_to ], params)
+        raise ArgumentError, "Required params are: #{VALID_REQUEST_COM_PARAM_NAMES.join(', ')}"
+      end
+    end
+  end # PullRequests::Comments
+end # Github

data/lib/github_api/client/repos.rb

@@ -0,0 +1,451 @@
+# encoding: utf-8
+
+module Github
+  class Client::Repos < API
+    # Load all the modules after initializing Repos to avoid superclass mismatch
+    require_all 'github_api/client/repos',
+      'collaborators',
+      'comments',
+      'commits',
+      'contents',
+      'deployments',
+      'downloads',
+      'forks',
+      'hooks',
+      'keys',
+      'merging',
+      'pages',
+      'pub_sub_hubbub',
+      'releases',
+      'statistics',
+      'statuses'
+
+    DEFAULT_REPO_OPTIONS = {
+      "homepage"   => "https://github.com",
+      "private"    => false,
+      "has_issues" => true,
+      "has_wiki"   => true,
+      "has_downloads" => true
+    }.freeze
+
+    REQUIRED_REPO_OPTIONS = %w[ name ]
+
+    VALID_REPO_OPTIONS = %w[
+      name
+      description
+      homepage
+      private
+      has_issues
+      has_wiki
+      has_downloads
+      team_id
+      auto_init
+      gitignore_template
+      default_branch
+    ].freeze
+
+    VALID_REPO_TYPES = %w[ all public private member ].freeze
+
+    # Access to Repos::Collaborators API
+    namespace :collaborators
+
+    # Access to Repos::Comments API
+    namespace :comments
+
+    # Access to Repos::Commits API
+    namespace :commits
+
+    # Access to Repos::Contents API
+    namespace :contents
+
+    # Access to Repos::Deployments API
+    namespace :deployments
+
+    # Access to Repos::Downloads API
+    namespace :downloads
+
+    # Access to Repos::Forks API
+    namespace :forks
+
+    # Access to Repos::Hooks API
+    namespace :hooks
+
+    # Access to Repos::Keys API
+    namespace :keys
+
+    # Access to Repos::Merging API
+    namespace :merging
+
+    # Access to Repos::Pages API
+    namespace :pages
+
+    # Access to Repos::PubSubHubbub API
+    namespace :pubsubhubbub, full_name: :pub_sub_hubbub
+
+    # Access to Repos::Releases API
+    namespace :releases
+
+    # Access to Repos::Statistics API
+    namespace :stats, full_name: :statistics
+
+    # Access to Repos::Statuses API
+    namespace :statuses
+
+    # List repositories for the authenticated user
+    #
+    # @example
+    #   github = Github.new oauth_token: '...'
+    #   github.repos.list
+    #   github.repos.list { |repo| ... }
+    #
+    # List all repositories
+    #
+    # This provides a dump of every repository,
+    # in the order that they were created.
+    #
+    # @param [Hash] params
+    # @option params [Integer] :since
+    #   the integer ID of the last Repository that you've seen.
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.list :every
+    #   github.repos.list :every { |repo| ... }
+    #
+    # List public repositories for the specified user.
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.list user: 'user-name'
+    #   github.repos.list user: 'user-name', { |repo| ... }
+    #
+    # List repositories for the specified organisation.
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.list org: 'org-name'
+    #  github.repos.list org: 'org-name', { |repo| ... }
+    #
+    # @api public
+    def list(*args)
+      arguments(args) do
+        permit %w[ user org type sort direction since ]
+      end
+      params = arguments.params
+
+      response = if (user_name = params.delete('user') || user)
+        get_request("/users/#{user_name}/repos", params)
+      elsif (org_name = params.delete('org') || org)
+        get_request("/orgs/#{org_name}/repos", params)
+      elsif args.map(&:to_s).include?('every')
+        get_request('/repositories', params)
+      else
+        # For authenticated user
+        get_request('/user/repos', params)
+      end
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get a repository
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.get 'user-name', 'repo-name'
+    #  github.repos.get user: 'user-name', repo: 'repo-name'
+    #  github.repos(user: 'user-name', repo: 'repo-name').get
+    #
+    def get(*args)
+      arguments(args, required: [:user, :repo])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}", arguments.params)
+    end
+    alias :find :get
+
+    # Create a new repository for the autheticated user.
+    #
+    # @param [Hash] params
+    # @option params [String] :name
+    #   Required string
+    # @option params [String] :description
+    #   Optional string
+    # @option params [String] :homepage
+    #   Optional string
+    # @option params [Boolean] :private
+    #   Optional boolean - true to create a private  repository,
+    #                      false to create a public one.
+    # @option params [Boolean] :has_issues
+    #   Optional boolean - true to enable issues  for this repository,
+    #                      false to disable them
+    # @option params [Boolean] :has_wiki
+    #   Optional boolean - true to enable the wiki for this repository,
+    #                      false to disable it. Default is true
+    # @option params [Boolean] :has_downloads
+    #   Optional boolean - true to enable downloads for this repository
+    # @option params [String] :org
+    #   Optional string - The organisation in which this
+    #   repository will be created
+    # @option params [Numeric] :team_id
+    #   Optional number - The id of the team that will be granted
+    #   access to this repository. This is only valid when creating
+    #   a repo in an organization
+    # @option params [Boolean] :auto_init
+    #   Optional boolean - true to create an initial commit with
+    #   empty README. Default is false.
+    # @option params [String] :gitignore_template
+    #   Optional string - Desired language or platform .gitignore
+    #   template to apply. Use the name of the template without
+    #   the extension. For example, “Haskell” Ignored if
+    #   auto_init parameter is not provided.
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.create "name": 'repo-name'
+    #    "description": "This is your first repo",
+    #    "homepage": "https://github.com",
+    #    "private": false,
+    #    "has_issues": true,
+    #    "has_wiki": true,
+    #    "has_downloads": true
+    #
+    # Create a new repository in this organisation. The authenticated user
+    # must be a member of this organisation
+    #
+    # @example
+    #   github = Github.new oauth_token: '...'
+    #   github.repos.create name: 'repo-name', org: 'organisation-name'
+    #
+    # @example
+    def create(*args)
+      arguments(args) do
+        permit VALID_REPO_OPTIONS + %w[ org ]
+        assert_required %w[ name ]
+      end
+      params = arguments.params
+
+      # Requires authenticated user
+      if (org = params.delete('org') || org)
+        post_request("/orgs/#{org}/repos", params.merge_default(DEFAULT_REPO_OPTIONS))
+      else
+        post_request('/user/repos', params.merge_default(DEFAULT_REPO_OPTIONS))
+      end
+    end
+
+    # Delete a repository
+    #
+    # Deleting a repository requires admin access.
+    # If OAuth is used, the delete_repo scope is required.
+    #
+    # @example
+    #  github = Github.new oauth_token: '...'
+    #  github.repos.delete 'user-name', 'repo-name'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:user, :repo])
+
+      delete_request("/repos/#{arguments.user}/#{arguments.repo}", arguments.params)
+    end
+    alias :remove :delete
+
+    # List contributors
+    #
+    # @param [Hash] params
+    # @option params [Boolean] :anon
+    #   Optional flag. Set to 1 or true to include anonymous contributors.
+    #
+    # @examples
+    #  github = Github.new
+    #  github.repos.contributors 'user-name','repo-name'
+    #  github.repos.contributors 'user-name','repo-name' { |cont| ... }
+    #
+    # @api public
+    def contributors(*args)
+      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?
+      response.each { |el| yield el }
+    end
+    alias :list_contributors :contributors
+    alias :contribs :contributors
+
+    # Edit a repository
+    #
+    # @param [Hash] params
+    # @option params [String] :name
+    #   Required string
+    # @option params [String] :description
+    #   Optional string
+    # @option params [String] :homepage
+    #   Optional string
+    # @option params [Boolean] :private
+    #   Optional boolean, false to create public repos, false to create a private one
+    # @option params [Boolean] :has_issues
+    #   Optional boolean - true to enable issues for this repository,
+    #   false to disable them
+    # @option params [Boolean] :has_wiki
+    #   Optional boolean - true to enable the wiki for this repository,
+    #   false to disable it. Default is true
+    # @option params [Boolean] :has_downloads
+    #   Optional boolean - true to enable downloads for this repository
+    # @option params [String] :default_branch
+    #   Optional string - Update the default branch for this repository.
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.edit 'user-name', 'repo-name',
+    #    name: 'hello-world',
+    #    description: 'This is your first repo',
+    #    homepage: "https://github.com",
+    #    public: true, has_issues: true
+    #
+    def edit(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_REPO_OPTIONS
+        assert_required %w[ name ]
+      end
+
+      patch_request("/repos/#{arguments.user}/#{arguments.repo}", arguments.params.merge_default(DEFAULT_REPO_OPTIONS))
+    end
+
+    # Delete a repository
+    #
+    # Deleting a repository requires admin access.
+    # If OAuth is used, the delete_repo scope is required.
+    #
+    # @example
+    #  github = Github.new oauth_token: '...'
+    #  github.repos.delete 'user-name', 'repo-name'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:user, :repo])
+      params = arguments.params
+
+      delete_request("/repos/#{arguments.user}/#{arguments.repo}", arguments.params)
+    end
+    alias :remove :delete
+
+    # List branches
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branches 'user-name', 'repo-name'
+    #   github.repos(user: 'user-name', repo: 'repo-name').branches
+    #
+    # @example
+    #   repos = Github::Repos.new
+    #   repos.branches 'user-name', 'repo-name'
+    #
+    # @api public
+    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
+
+    # Get branch
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.branch 'user-name', 'repo-name', 'branch-name'
+    #   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])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/branches/#{arguments.branch}", arguments.params)
+    end
+
+    # List contributors
+    #
+    # @param [Hash] params
+    # @option params [Boolean] :anon
+    #   Optional flag. Set to 1 or true to include anonymous contributors.
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.contributors 'user-name','repo-name'
+    #  github.repos.contributors 'user-name','repo-name' { |cont| ... }
+    #
+    # @api public
+    def contributors(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit ['anon']
+      end
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/contributors", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :list_contributors :contributors
+    alias :contribs :contributors
+
+    # List languages
+    #
+    # @examples
+    #  github = Github.new
+    #  github.repos.languages 'user-name', 'repo-name'
+    #  github.repos.languages 'user-name', 'repo-name' { |lang| ... }
+    #
+    # @api public
+    def languages(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/languages", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :list_languages :languages
+
+    # List tags
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.tags 'user-name', 'repo-name'
+    #   github.repos.tags 'user-name', 'repo-name' { |tag| ... }
+    #
+    # @api public
+    def tags(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/tags", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :list_tags :tags
+    alias :repo_tags :tags
+    alias :repository_tags :tags
+
+    # List teams
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.teams 'user-name', 'repo-name'
+    #   github.repos.teams 'user-name', 'repo-name' { |team| ... }
+    #
+    # @example
+    #   github.repos(user: 'user-name, repo: 'repo-name').teams
+    #
+    # @api public
+    def teams(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/teams", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :list_teams :teams
+    alias :repo_teams :teams
+    alias :repository_teams :teams
+  end # Client::Repos
+end # Github