lingfennan-github_api 0.18.2

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

@@ -0,0 +1,100 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  class Client::Gists::Comments < API
+    # List comments on a gist
+    #
+    # @see https://developer.github.com/v3/gists/comments/#list-comments-on-a-gist
+    #
+    # @example
+    #   github = Github.new
+    #   github.gists.comments.list 'gist-id'
+    #
+    # @return [Hash]
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:gist_id])
+
+      response = get_request("/gists/#{arguments.gist_id}/comments",
+                             arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias_method :all, :list
+
+    # Get a single comment
+    #
+    # @see https://developer.github.com/v3/gists/comments/#get-a-single-comment
+    #
+    # @example
+    #   github = Github.new
+    #   github.gists.comments.get 'gist-id', 'comment-id'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:gist_id, :id])
+
+      get_request("/gists/#{arguments.gist_id}/comments/#{arguments.id}",
+                  arguments.params)
+    end
+    alias_method :find, :get
+
+    # Create a comment
+    #
+    # @see https://developer.github.com/v3/gists/comments/#create-a-comment
+    #
+    # @param [Hash] params
+    # @option params [String] :body
+    #   Required. The comment text.
+    #
+    # @example
+    #   github = Github.new
+    #   github.gists.comments.create 'gist-id'
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:gist_id])
+
+      post_request("/gists/#{arguments.gist_id}/comments", arguments.params)
+    end
+
+    # Edit a comment
+    #
+    # @see https://developer.github.com/v3/gists/comments/#edit-a-comment
+    #
+    # @param [Hash] params
+    # @option params [String] :body
+    #   Required. The comment text.
+    #
+    # @example
+    #   github = Github.new
+    #   github.gists.comments.edit 'gist-id', 'comment-id'
+    #
+    # @api public
+    def edit(*args)
+      arguments(args, required: [:gist_id, :id])
+
+      patch_request("/gists/#{arguments.gist_id}/comments/#{arguments.id}",
+                    arguments.params)
+    end
+
+    # Delete a comment
+    #
+    # @see https://developer.github.com/v3/gists/comments/#delete-a-comment
+    #
+    # @xample
+    #   github = Github.new
+    #   github.gists.comments.delete 'gist-id', 'comment-id'
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:gist_id, :id])
+
+      delete_request("/gists/#{arguments.gist_id}/comments/#{arguments.id}",
+                     arguments.params)
+    end
+  end # Gists::Comments
+end # Github

data/lib/github_api/client/git_data.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+require_relative '../api'
+
+module Github
+  class Client::GitData < API
+
+    require_all 'github_api/client/git_data',
+      'blobs',
+      'commits',
+      'references',
+      'tags',
+      'trees'
+
+    # Access to GitData::Blobs API
+    namespace :blobs
+
+    # Access to GitData::Commits API
+    namespace :commits
+
+    # Access to GitData::References API
+    namespace :references
+
+    # Access to GitData::Tags API
+    namespace :tags
+
+    # Access to GitData::Tags API
+    namespace :trees
+
+  end # GitData
+end # Github

data/lib/github_api/client/git_data/blobs.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  # Since blobs can be any arbitrary binary data, the input and responses for
+  # the blob api takes an encoding parameter that can be either utf-8 or base64.
+  # If your data cannot be losslessly sent as a UTF-8 string, you can base64 encode it.
+  class Client::GitData::Blobs < API
+
+    VALID_BLOB_PARAM_NAMES = %w[ content encoding ].freeze
+
+    # Get a blob
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.blobs.get 'user-name', 'repo-name', 'sha'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :sha])
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/git/blobs/#{arguments.sha}", arguments.params)
+    end
+    alias :find :get
+
+    # Create a blob
+    #
+    # @param [Hash] params
+    # @input params [String] :content
+    #   String of content.
+    # @input params [String] :encoding
+    #   String containing encoding<tt>utf-8</tt> or <tt>base64</tt>
+    #
+    # @examples
+    #  github = Github.new
+    #  github.git_data.blobs.create 'user-name', 'repo-name',
+    #    content: "Content of the blob",
+    #    encoding: "utf-8"
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_BLOB_PARAM_NAMES
+        assert_required VALID_BLOB_PARAM_NAMES
+      end
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/git/blobs", arguments.params)
+    end
+  end # GitData::Blobs
+end # Github

data/lib/github_api/client/git_data/commits.rb

@@ -0,0 +1,101 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  class Client::GitData::Commits < API
+
+    VALID_COMMIT_PARAM_NAMES = %w[
+      message
+      tree
+      parents
+      author
+      committer
+      name
+      email
+      date
+    ].freeze
+
+    REQUIRED_COMMIT_PARAMS = %w[
+      message
+      tree
+      parents
+    ].freeze
+
+    # Get a commit
+    #
+    # @example
+    #   github = Github.new
+    #   github.git_data.commits.get 'user-name', 'repo-name', 'sha'
+    #
+    # @example
+    #   commits = Github::Commits.new user: 'user-name', repo: 'repo-name'
+    #   commits.get sha: '...'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :sha])
+      params = arguments.params
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/git/commits/#{arguments.sha}", params)
+    end
+    alias :find :get
+
+    # Create a commit
+    #
+    # @param [Hash] params
+    # @input params [String] :message
+    #   The commit message
+    # @input params [String] :tree
+    #   String of the SHA of the tree object this commit points to
+    # @input params [Array[String]] :parents
+    #   Array of the SHAs of the commits that were the parents of this commit.
+    #   If omitted or empty, the commit will be written as a root commit.
+    #   For a single parent, an array of one SHA should be provided,
+    #   for a merge commit, an array of more than one should be provided.
+    #
+    # Optional Parameters
+    #
+    # You can provide an additional commiter parameter, which is a hash
+    # containing information about the committer. Or, you can provide an author
+    # parameter, which is a hash containing information about the author.
+    #
+    # The committer section is optional and will be filled with the author
+    # data if omitted. If the author section is omitted, it will be filled
+    # in with the authenticated users information and the current date.
+    #
+    # Both the author and commiter parameters have the same keys:
+    #
+    # @input params [String] :name
+    #   String of the name of the author (or commiter) of the commit
+    # @input params [String] :email
+    #   String of the email of the author (or commiter) of the commit
+    # @input params [Timestamp] :date
+    #   Indicates when this commit was authored (or committed).
+    #   This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
+    #
+    # @example
+    #   github = Github.new
+    #   github.git_data.commits.create 'user-name', 'repo-name',
+    #     message: "my commit message",
+    #     author: {
+    #       name: "Scott Chacon",
+    #       email: "schacon@gmail.com",
+    #       date: "2008-07-09T16:13:30+12:00"
+    #     },
+    #     parents: [
+    #       "7d1b31e74ee336d15cbd21741bc88a537ed063a0"
+    #     ],
+    #     tree: "827efc6d56897b048c772eb4087f854f46256132"]
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_COMMIT_PARAM_NAMES
+        assert_required REQUIRED_COMMIT_PARAMS
+      end
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/git/commits", arguments.params)
+    end
+  end # GitData::Commits
+end # Github

data/lib/github_api/client/git_data/references.rb

@@ -0,0 +1,150 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  class Client::GitData::References < API
+
+    VALID_REF_PARAM_NAMES = %w[ ref sha force ].freeze
+
+    REQUIRED_REF_PARAMS = %w[ ref sha ].freeze
+
+    VALID_REF_PARAM_VALUES = {
+      'ref' => %r{^refs\/\w+(\/\w+)*} # test fully qualified reference
+    }
+
+    # Get all references
+    #
+    # This will return an array of all the references on the system,
+    # including things like notes and stashes if they exist on the server.
+    # Anything in the namespace, not just <tt>heads</tt> and <tt>tags</tt>,
+    # though that would be the most common.
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.references.list 'user-name', 'repo-name'
+    #
+    # @example
+    #  github.git_data.references.list 'user-name', 'repo-name', ref:'tags'
+    #
+    # @api public
+    def list(*args)
+      arguments(args, required: [:user, :repo])
+      params = arguments.params
+      user = arguments.user
+      repo = arguments.repo
+
+      response = if (ref = params.delete('ref'))
+        formatted_ref = validate_reference ref
+        get_request("/repos/#{user}/#{repo}/git/#{formatted_ref}", params)
+      else
+        get_request("/repos/#{user}/#{repo}/git/refs", params)
+      end
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get a reference
+    #
+    # The ref in the URL must be formatted as <tt>heads/branch</tt>,
+    # not just branch. For example, the call to get the data for a
+    # branch named sc/featureA would be formatted as heads/sc/featureA
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.references.get 'user-name', 'repo-name', 'heads/branch'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :ref])
+      validate_reference arguments.ref
+      params = arguments.params
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/git/refs/#{arguments.ref}", params)
+    end
+    alias :find :get
+
+    # Create a reference
+    #
+    # @param [Hash] params
+    # @input params [String] :ref
+    #   The name of the fully qualified reference (ie: refs/heads/master).
+    #   If it doesn’t start with ‘refs’ and have at least two slashes,
+    #   it will be rejected.
+    # @input params [String] :sha
+    #   The SHA1 value to set this reference to
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.references.create 'user-name', 'repo-name',
+    #    ref: "refs/heads/master",
+    #    sha:  "827efc6d56897b048c772eb4087f854f46256132"
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_REF_PARAM_NAMES
+        assert_required REQUIRED_REF_PARAMS
+      end
+      params = arguments.params
+      validate_reference params['ref']
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/git/refs", params)
+    end
+
+    # Update a reference
+    #
+    # @param [Hash] params
+    # @input params [String] :sha
+    #   The SHA1 value to set this reference to
+    # @input params [Boolean] :force
+    #   Indicates whether to force the update or to make sure the update
+    #   is a fast-forward update. Leaving this out or setting it to false
+    #   will make sure you’re not overwriting work. Default: false
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.references.update 'user-name', 'repo-name', 'heads/master',
+    #    sha:  "827efc6d56897b048c772eb4087f854f46256132",
+    #    force: true
+    #
+    # @api public
+    def update(*args)
+      arguments(args, required: [:user, :repo, :ref]) do
+        permit VALID_REF_PARAM_NAMES
+        assert_required %w[ sha ]
+      end
+
+      patch_request("/repos/#{arguments.user}/#{arguments.repo}/git/refs/#{arguments.ref}", arguments.params)
+    end
+
+    # Delete a reference
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.references.delete 'user-name', 'repo-name',
+    #    "heads/master"
+    #
+    # @api public
+    def delete(*args)
+      arguments(args, required: [:user, :repo, :ref])
+      params = arguments.params
+
+      delete_request("/repos/#{arguments.user}/#{arguments.repo}/git/refs/#{arguments.ref}", params)
+    end
+    alias :remove :delete
+
+    private
+
+    def validate_reference(ref)
+      refs = (ref =~ (/^(\/)?refs.*/) ? ref : "refs/#{ref}").gsub(/(\/)+/, '/')
+      refs.gsub!(/^\//, '')
+      unless VALID_REF_PARAM_VALUES['ref'] =~ refs
+        raise ArgumentError, "Provided 'reference' is invalid"
+      end
+
+      refs
+    end
+  end # GitData::References
+end # Github

data/lib/github_api/client/git_data/tags.rb

@@ -0,0 +1,95 @@
+# encoding: utf-8
+
+require_relative '../../api'
+
+module Github
+  class Client::GitData::Tags < API
+    # This tags api only deals with tag objects -
+    # so only annotated tags, not lightweight tags.
+    # Refer https://developer.github.com/v3/git/tags/#parameters
+
+    VALID_TAG_PARAM_NAMES = %w[
+      tag
+      message
+      object
+      type
+      name
+      email
+      date
+      tagger
+    ].freeze
+
+    VALID_TAG_PARAM_VALUES = {
+      'type' => %w[ blob tree commit ]
+    }
+
+    # Get a tag
+    #
+    # @example
+    #  github = Github.new
+    #  github.git_data.tags.get 'user-name', 'repo-name', 'sha'
+    #
+    # @api public
+    def get(*args)
+      arguments(args, required: [:user, :repo, :sha])
+      params = arguments.params
+
+      get_request("/repos/#{arguments.user}/#{arguments.repo}/git/tags/#{arguments.sha}", params)
+    end
+    alias :find :get
+
+    # Create a tag object
+    #
+    # Note that creating a tag object does not create the reference that
+    # makes a tag in Git. If you want to create an annotated tag in Git,
+    # you have to do this call to create the tag object, and then create
+    # the refs/tags/[tag] reference. If you want to create a lightweight
+    # tag, you simply have to create the reference -
+    # this call would be unnecessary.
+    #
+    # @param [Hash] params
+    # @input params [String] :tag
+    #   The tag
+    # @input params [String] :message
+    #   The tag message
+    # @input params [String] :object
+    #   The SHA of the git object this is tagging
+    # @input params [String] :type
+    #   The type of the object we're tagging.
+    #   Normally this is a commit but it can also be a tree or a blob
+    # @input params [Hash] :tagger
+    #   A hash with information about the individual creating the tag.
+    #
+    # The tagger hash contains the following keys:
+    # @input tagger [String] :name
+    #   The name of the author of the tag
+    # @input tagger [String] :email
+    #   The email of the author of the tag
+    # @input tagger [String] :date
+    #   When this object was tagged. This is a timestamp in ISO 8601
+    #   format: YYYY-MM-DDTHH:MM:SSZ.
+    #
+    # @xample
+    #  github = Github.new
+    #  github.git_data.tags.create 'user-name', 'repo-name',
+    #     tag: "v0.0.1",
+    #     message: "initial version\n",
+    #     type: "commit",
+    #     object: "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
+    #     tagger: {
+    #       name: "Scott Chacon",
+    #       email: "schacon@gmail.com",
+    #       date: "2011-06-17T14:53:3"
+    #     }
+    #
+    # @api public
+    def create(*args)
+      arguments(args, required: [:user, :repo]) do
+        permit VALID_TAG_PARAM_NAMES
+        assert_values VALID_TAG_PARAM_VALUES
+      end
+
+      post_request("/repos/#{arguments.user}/#{arguments.repo}/git/tags", arguments.params)
+    end
+  end # GitData::Tags
+end # Github