github_api2 1.0.0

data/lib/github_api2/client/repos/releases/assets.rb

@@ -0,0 +1,136 @@
+# encoding: utf-8
+
+require_relative '../../../api'
+
+module Github
+  # The Release Assets API
+  class Client::Repos::Releases::Assets < API
+
+    VALID_ASSET_PARAM_NAMES = %w[
+      name
+      label
+      content_type
+    ].freeze # :nodoc:
+
+    # List assets for a release
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.assets.list 'owner', 'repo', 'id'
+    #   github.repos.releases.assets.list 'owner', 'repo', 'id' { |asset| ... }
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:owner, :repo, :id]).params
+
+      response = get_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/#{arguments.id}/assets", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get a single release asset
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.assets.get 'owner', 'repo', 'id'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:owner, :repo, :id]).params
+
+      get_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/assets/#{arguments.id}" , arguments.params)
+    end
+    alias :find :get
+
+    # Upload a release asset
+    #
+    # @param [Hash] params
+    # @input params [String] :name
+    #   Required string. The file name of the asset
+    # @input params [String] :content_type
+    #   Required string. The content type of the asset.
+    #   Example: “application/zip”.
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.assets.upload 'owner', 'repo', 'id', 'file-path'
+    #     name: "batman.jpg",
+    #     content_type: "application/octet-stream"
+    #
+    # @api public
+    def upload(*args)
+      arguments(args, required: [:owner, :repo, :id, :filepath]) do
+        permit VALID_ASSET_PARAM_NAMES
+      end
+      params = arguments.params
+
+      unless type = params['content_type']
+        type = infer_media(arguments.filepath)
+      end
+
+      file = Faraday::UploadIO.new(arguments.filepath, type)
+      options = {
+        headers: { content_type: type },
+        endpoint: upload_endpoint,
+        query: {'name' => params['name']}
+      }
+      params['data']    = file.read
+      params['options'] = options
+
+      post_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/#{arguments.id}/assets", params)
+    ensure
+      file.close if file
+    end
+
+    # Infer media type of the asset
+    #
+    def infer_media(filepath)
+      require 'mime/types'
+      types = MIME::Types.type_for(filepath)
+      types.empty? ? 'application/octet-stream' : types.first
+    rescue LoadError
+      raise Github::Error::UnknownMedia.new(filepath)
+    end
+
+    # Edit a release asset
+    #
+    # Users with push access to the repository can edit a release asset.
+    #
+    # @param [Hash] params
+    # @input params [String] :name
+    #   Required. The file name of the asset.
+    # @input params [String] :label
+    #   An alternate short description of the asset.
+    #   Used in place of the filename.
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.assets.edit 'owner', 'repo', 'id',
+    #     name: "foo-1.0.0-osx.zip",
+    #     label: "Mac binary"
+    #
+    # @api public
+    def edit(*args)
+      arguments(args, required: [:owner, :repo, :id]) do
+        permit VALID_ASSET_PARAM_NAMES
+      end
+
+      patch_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/assets/#{arguments.id}", arguments.params)
+    end
+    alias :update :edit
+
+    # Delete a release asset
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.assets.delete 'owner', 'repo', 'id'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:owner, :repo, :id])
+
+      delete_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/assets/#{arguments.id}", arguments.params)
+    end
+  end # Client::Repos::Releases::Assets
+end # Github

data/lib/github_api2/client/repos/releases/tags.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+require_relative '../../../api'
+
+module Github
+  # The Releases API
+  class Client::Repos::Releases::Tags < API
+    # Get a published release with the specified tag.
+    #
+    # @see https://developer.github.com/v3/repos/releases/#get-a-release-by-tag-name
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.tags.get 'owner', 'repo', 'tag'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:owner, :repo, :tag]).params
+
+      get_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/tags/#{arguments.tag}" , arguments.params)
+    end
+    alias_method :find, :get
+  end # Client::Repos::Releases::Tags
+end # Github

data/lib/github_api2/client/repos/releases.rb

@@ -0,0 +1,189 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  # The Releases API
+  class Client::Repos::Releases < API
+
+    require_all 'github_api2/client/repos/releases', 'assets', 'tags'
+
+    # Access to Repos::Releases::Assets API
+    namespace :assets
+
+    # Access to Repos::Releases::Tags API
+    namespace :tags
+
+    # List releases for a repository
+    #
+    # Users with push access to the repository will receive all releases
+    # (i.e., published releases and draft releases). Users with pull access
+    # will receive published releases only.
+    #
+    # @see https://developer.github.com/v3/repos/releases/#list-releases-for-a-repository
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.list 'owner', 'repo'
+    #   github.repos.releases.list 'owner', 'repo' { |release| ... }
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:owner, :repo])
+
+      response = get_request("/repos/#{arguments.owner}/#{arguments.repo}/releases", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias_method :all, :list
+
+    # Get a single release
+    #
+    # @see https://developer.github.com/v3/repos/releases/#get-a-single-release
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.get 'owner', 'repo', 'id'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:owner, :repo, :id]).params
+
+      get_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/#{arguments.id}" , arguments.params)
+    end
+    alias_method :find, :get
+
+    # Create a release
+    #
+    # Users with push access to the repository can create a release.
+    #
+    # @see https://developer.github.com/v3/repos/releases/#create-a-release
+    #
+    # @param [Hash] params
+    # @input params [String] :tag_name
+    #   Required. The name of the tag.
+    # @input params [String] :target_commitish
+    #   Specifies the commitish value that determines where the Git tag
+    #   is created from. Can be any branch or commit SHA. Defaults to
+    #   the repository's default branch (usually 'master').
+    #   Unused if the Git tag already exists.
+    # @input params [String] :name
+    #   The name of the release.
+    # @input params [String] :body
+    #   Text describing the contents of the tag.
+    # @input params [Boolean] :draft
+    #   true to create a draft (unpublished) release,
+    #   false to create a published one. Default: false
+    # @input params [Boolean] :prerelease
+    #   true to identify the release as a prerelease.
+    #   false to identify the release as a full release. Default: false
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.create 'owner', 'repo',
+    #     tag_name: "v1.0.0",
+    #     target_commitish: "master",
+    #     name: "v1.0.0",
+    #     body: "Description of the release",
+    #     draft: false,
+    #     prerelease: false
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:owner, :repo]) do
+        assert_required :tag_name
+      end
+
+      post_request("/repos/#{arguments.owner}/#{arguments.repo}/releases",
+                   arguments.params)
+    end
+
+    # Edit a release
+    #
+    # Users with push access to the repository can edit a release.
+    #
+    # @see https://developer.github.com/v3/repos/releases/#edit-a-release
+    #
+    # @param [String] :owner
+    # @param [String] :repo
+    # @param [Integer] :id
+    # @param [Hash] params
+    # @input params [String] :tag_name
+    #   Required. The name of the tag.
+    # @input params [String] :target_commitish
+    #   Specifies the commitish value that determines where the Git tag
+    #   is created from. Can be any branch or commit SHA. Defaults to
+    #   the repository's default branch (usually 'master').
+    #   Unused if the Git tag already exists.
+    # @input params [String] :name
+    #   The name of the release.
+    # @input params [String] :body
+    #   Text describing the contents of the tag.
+    # @input params [Boolean] :draft
+    #   true to create a draft (unpublished) release,
+    #   false to create a published one. Default: false
+    # @input params [Boolean] :prerelease
+    #   true to identify the release as a prerelease.
+    #   false to identify the release as a full release. Default: false
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.edit 'owner', 'repo', 'id',
+    #     tag_name: "v1.0.0",
+    #     target_commitish: "master",
+    #     name: "v1.0.0",
+    #     body: "Description of the release",
+    #     draft: false,
+    #     prerelease: false
+    #
+    # @api public
+    def edit(*args)
+      arguments(args, required: [:owner, :repo, :id])
+
+      patch_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/#{arguments.id}", arguments.params)
+    end
+    alias_method :update, :edit
+
+    # Delete a release
+    #
+    # Users with push access to the repository can delete a release.
+    #
+    # @see https://developer.github.com/v3/repos/releases/#delete-a-release
+    #
+    # @param [String] :owner
+    # @param [String] :repo
+    # @param [Integer] :id
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.delete 'owner', 'repo', 'id'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:owner, :repo, :id]).params
+
+      delete_request("/repos/#{arguments.owner}/#{arguments.repo}/releases/#{arguments.id}", arguments.params)
+    end
+
+    # Get the latest release
+    #
+    # View the latest published full release for the repository.
+    # Draft releases and prereleases are not returned.
+    #
+    # @see https://developer.github.com/v3/repos/releases/#get-the-latest-release
+    #
+    # @param [String] :owner
+    # @param [String] :repo
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.releases.latest 'owner', 'repo'
+    #
+    # @api public
+    def latest(*args)
+      arguments(args, required: [:owner, :repo]).params
+
+      get_request("repos/#{arguments.owner}/#{arguments.repo}/releases/latest", arguments.params)
+    end
+  end # Client::Repos::Statuses
+end # Github

data/lib/github_api2/client/repos/statistics.rb

@@ -0,0 +1,89 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  # The Repository Statistics API allows you to fetch the data that GitHub uses
+  # for visualizing different types of repository activity.
+  class Client::Repos::Statistics < API
+
+    # Get contributors list with additions, deletions, and commit counts
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.stats.contributors user: '...', repo: '...'
+    #   github.repos.stats.contributors user: '...', repo: '...' { |stat| ... }
+    #
+    # @api public
+    def contributors(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/stats/contributors", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # Get the last year of commit activity data
+    #
+    # Returns the last year of commit activity grouped by week.
+    # The days array is a group of commits per day, starting on Sunday
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.stats.commit_activity user: '...', repo: '...'
+    #   github.repos.stats.commit_activity user: '...', repo: '...' { |stat| ... }
+    #
+    # @api public
+    def commit_activity(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/stats/commit_activity", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # Get the number of additions and deletions per week
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.stats.code_frequency user: '...', repo: '...'
+    #  github.repos.stats.code_frequency user: '...', repo: '...' { |stat| ... }
+    #
+    # @api public
+    def code_frequency(*args)
+      arguments(args, required: [:user, :repo])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/stats/code_frequency", arguments.params)
+    end
+
+    # Get the weekly commit count for the repo owner and everyone else
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.stats.participation user: '...', repo: '...'
+    #   github.repos.stats.participation user: '...', repo: '...' { |stat| ... }
+    #
+    # @api public
+    def participation(*args)
+      arguments(args, required: [:user, :repo])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/stats/participation", arguments.params)
+    end
+
+    # Get the number of commits per hour in each day
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.stats.punch_card user: '...', repo: '...'
+    #   github.repos.stats.punch_card user: '...', repo: '...' { |stat| ... }
+    #
+    # @api public
+    def punch_card(*args)
+      arguments(args, required: [:user, :repo])
+
+      response = get_request("/repos/#{arguments.user}/#{arguments.repo}/stats/punch_card", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+  end # Client::Repos::Statistics
+end # Github

data/lib/github_api2/client/repos/statuses.rb

@@ -0,0 +1,91 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  # The Status API allows external services to mark commits with a success,
+  # failure, error, or pending state, which is then reflected in pull requests
+  # involving those commits.
+  class Client::Repos::Statuses < API
+
+    VALID_STATUS_PARAM_NAMES = %w[
+      state
+      target_url
+      description
+      context
+    ].freeze # :nodoc:
+
+    REQUIRED_PARAMS = %w[ state ].freeze # :nodoc:
+
+    # List Statuses for a specific SHA
+    #
+    # @param [String] :ref
+    #   Ref to fetch the status for. It can be a SHA, a branch name,
+    #   or a tag name.
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.statuses.list 'user-name', 'repo-name', 'ref'
+    #   github.repos.statuses.list 'user-name', 'repo-name', 'ref' { |status| ... }
+    #
+    # Get the combined Status for a specific Ref
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.statuses.list 'user', 'repo', 'ref', combined: true
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:user, :repo, :ref])
+      params = arguments.params
+      user, repo, ref = arguments.user, arguments.repo, arguments.ref
+
+      response = if params.delete('combined')
+        get_request("/repos/#{user}/#{repo}/commits/#{ref}/status", params)
+      else
+        get_request("/repos/#{user}/#{repo}/commits/#{ref}/statuses", params)
+      end
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Create a status
+    #
+    # @param [Hash] params
+    # @input params [String] :state
+    #   Required. The state of the status. Can be one of pending,
+    #   success, error, or failure.
+    # @input params [String] :target_url
+    #   The target URL to associate with this status. This URL will
+    #   be linked from the GitHub UI to allow users to easily see
+    #   the ‘source’ of the Status.
+    #
+    #   For example, if your Continuous Integration system is posting
+    #   build status, you would want to provide the deep link for
+    #   the build output for this specific SHA:
+    #   http://ci.example.com/user/repo/build/sha.
+    # @input params [String] :description
+    #   A short description of the status
+    # @input params [String] :context
+    #   A string label to differentiate this status from the
+    #   status of other systems. Default: "default"
+    #
+    # @example
+    #   github = Github.new
+    #   github.repos.statuses.create 'user-name', 'repo-name', 'sha',
+    #     state:  "success",
+    #     target_url: "http://ci.example.com/johndoe/my-repo/builds/sha",
+    #     description: "Successful build #3 from origin/master"
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo, :sha]) do
+        permit VALID_STATUS_PARAM_NAMES, recursive: false
+        assert_required REQUIRED_PARAMS
+      end
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/statuses/#{arguments.sha}", arguments.params)
+    end
+  end # Client::Repos::Statuses
+end # Github