lingfennan-github_api 0.18.2

data/lib/github_api/utils/url.rb

@@ -0,0 +1,63 @@
+# encoding:utf-8
+
+require 'cgi'
+require 'addressable/uri'
+
+module Github
+  module Utils
+    module Url
+      extend self
+
+      DEFAULT_QUERY_SEP = /[&;] */n
+
+      KEY_VALUE_SEP = '='.freeze
+
+      def escape_uri(s) Addressable::URI.escape(s.to_s) end
+
+      def escape(s) CGI.escape(s.to_s) end
+
+      def unescape(s) CGI.unescape(s.to_s) end
+
+      def normalize(s) Addressable::URI.parse(s.to_s).normalize.path end
+
+      def build_query(params)
+        params.map { |k, v|
+          if v.class == Array
+            build_query(v.map { |x| [k, x] })
+          else
+            v.nil? ? escape(k) : "#{escape(k)}=#{escape(v)}"
+          end
+        }.join("&")
+      end
+
+      def parse_query(query_string)
+        return '' if query_string.nil? || query_string.empty?
+        params = {}
+
+        query_string.split(DEFAULT_QUERY_SEP).each do |part|
+          k, v = part.split(KEY_VALUE_SEP, 2).map { |el| unescape(el) }
+
+          if cur = params[k]
+            if cur.class == Array
+              params[k] << v
+            else
+              params[k] = [cur, v]
+            end
+          else
+            params[k] = v
+          end
+        end
+        params
+      end
+
+      def parse_query_for_param(query_string, name)
+        parse_query(query_string).each do |key, val|
+          return val.first if (name == key) && val.is_a?(Array)
+          return val if (name == key)
+        end
+        return nil
+      end
+
+    end # Url
+  end # Utils
+end # Github

data/lib/github_api/validations.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+require_relative 'validations/format'
+require_relative 'validations/presence'
+require_relative 'validations/required'
+require_relative 'validations/token'
+
+module Github
+  module Validations
+    include Presence
+    include Format
+    include Token
+    include Required
+
+    VALID_API_KEYS = [
+      'page',
+      'per_page',
+      'auto_pagination',
+      'jsonp_callback'
+    ]
+  end # Validation
+end # Github

data/lib/github_api/validations/format.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+require_relative '../error/client_error'
+
+module Github
+  module Validations
+    module Format
+
+      # Ensures that value for a given key is of the correct form whether
+      # matching regular expression or set of predefined values.
+      #
+      def assert_valid_values(permitted, params)
+        params.each do |k, v|
+          next unless permitted.keys.include?(k)
+          if permitted[k].is_a?(Array) && !permitted[k].include?(params[k])
+            raise Github::Error::UnknownValue.new(k,v, permitted[k].join(', '))
+
+          elsif permitted[k].is_a?(Regexp) && !(permitted[k] =~ params[k])
+            raise Github::Error::UnknownValue.new(k,v, permitted[k])
+          end
+        end
+      end
+
+    end # Format
+  end # Validations
+end # Github

data/lib/github_api/validations/presence.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+require_relative '../error/client_error'
+
+module Github
+  module Validations
+    # A mixin to help validate presence of non-empty values
+    module Presence
+
+      # Ensure that esential arguments are present before request is made.
+      #
+      # == Parameters
+      #  Hash/Array of arguments to be checked against nil and empty string
+      #
+      # == Example
+      #  assert_presence_of user: '...', repo: '...'
+      #  assert_presence_of user, repo
+      #
+      def assert_presence_of(*args)
+        hash = args.last.is_a?(::Hash) ? args.pop : {}
+
+        errors = hash.select { |key, val| val.to_s.empty? }
+        raise Github::Error::Validations.new(errors) unless errors.empty?
+
+        args.each do |arg|
+          raise ArgumentError, "parameter cannot be nil" if arg.nil?
+        end
+      end
+
+    end # Presence
+  end # Validations
+end # Github

data/lib/github_api/validations/required.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require_relative '../error/client_error'
+
+module Github
+  module Validations
+    module Required
+      # Validate all keys present in a provided hash against required set,
+      # on mismatch raise Github::Error::RequiredParams
+      # Note that keys need to be in the same format i.e. symbols or strings,
+      # otherwise the comparison will fail.
+      #
+      # @api public
+      def assert_required_keys(*required, provided)
+        required.flatten.all? { |key|
+          provided.deep_key?(key.to_s)
+        } || (raise Github::Error::RequiredParams.new(provided, required))
+      end
+    end # Required
+  end # Validations
+end # Github

data/lib/github_api/validations/token.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+module Github
+  module Validations
+    module Token
+
+      TOKEN_REQUIRED = [
+        'get /user',
+        'get /user/emails',
+        'get /user/followers',
+        'get /user/following',
+        'get /user/keys',
+        'get /user/repos',
+        'patch /user',
+        'post /user/emails',
+        'post /user/keys',
+        'post /user/repos'
+      ]
+
+      TOKEN_REQUIRED_REGEXP = [
+        /repos\/.*\/.*\/comments/,
+      ]
+
+      # Ensures that required authentication token is present before
+      # request is sent.
+      #
+      def validates_token_for(method, path)
+        return true unless TOKEN_REQUIRED.grep("#{method} #{path}").empty?
+
+        token_required = false
+        TOKEN_REQUIRED_REGEXP.each do |regex|
+          if "#{method} #{path}" =~ regex
+            token_required = true
+          end
+        end
+        return token_required
+      end
+
+    end # Token
+  end # Validations
+end # Github

data/lib/github_api/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Github
+  VERSION = "0.18.2"
+end # Github

metadata

@@ -0,0 +1,338 @@
+--- !ruby/object:Gem::Specification
+name: lingfennan-github_api
+version: !ruby/object:Gem::Version
+  version: 0.18.2
+platform: ruby
+authors:
+- Piotr Murach
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-08-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.2
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: descendants_tracker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.3
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+description: " Ruby client that supports all of the GitHub API methods. It's build
+  in a modular way, that is, you can either instantiate the whole api wrapper Github.new
+  or use parts of it e.i. Github::Client::Repos.new if working solely with repositories
+  is your main concern. Intuitive query methods allow you easily call API endpoints. "
+email: ''
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- LICENSE.txt
+- README.md
+- lib/github_api.rb
+- lib/github_api/api.rb
+- lib/github_api/api/actions.rb
+- lib/github_api/api/arguments.rb
+- lib/github_api/api/config.rb
+- lib/github_api/api/config/property.rb
+- lib/github_api/api/config/property_set.rb
+- lib/github_api/api/factory.rb
+- lib/github_api/authorization.rb
+- lib/github_api/client.rb
+- lib/github_api/client/activity.rb
+- lib/github_api/client/activity/events.rb
+- lib/github_api/client/activity/feeds.rb
+- lib/github_api/client/activity/notifications.rb
+- lib/github_api/client/activity/starring.rb
+- lib/github_api/client/activity/watching.rb
+- lib/github_api/client/authorizations.rb
+- lib/github_api/client/authorizations/app.rb
+- lib/github_api/client/emojis.rb
+- lib/github_api/client/gists.rb
+- lib/github_api/client/gists/comments.rb
+- lib/github_api/client/git_data.rb
+- lib/github_api/client/git_data/blobs.rb
+- lib/github_api/client/git_data/commits.rb
+- lib/github_api/client/git_data/references.rb
+- lib/github_api/client/git_data/tags.rb
+- lib/github_api/client/git_data/trees.rb
+- lib/github_api/client/gitignore.rb
+- lib/github_api/client/issues.rb
+- lib/github_api/client/issues/assignees.rb
+- lib/github_api/client/issues/comments.rb
+- lib/github_api/client/issues/events.rb
+- lib/github_api/client/issues/labels.rb
+- lib/github_api/client/issues/milestones.rb
+- lib/github_api/client/markdown.rb
+- lib/github_api/client/meta.rb
+- lib/github_api/client/orgs.rb
+- lib/github_api/client/orgs/hooks.rb
+- lib/github_api/client/orgs/members.rb
+- lib/github_api/client/orgs/memberships.rb
+- lib/github_api/client/orgs/projects.rb
+- lib/github_api/client/orgs/teams.rb
+- lib/github_api/client/projects.rb
+- lib/github_api/client/projects/cards.rb
+- lib/github_api/client/projects/columns.rb
+- lib/github_api/client/pull_requests.rb
+- lib/github_api/client/pull_requests/comments.rb
+- lib/github_api/client/pull_requests/reviews.rb
+- lib/github_api/client/repos.rb
+- lib/github_api/client/repos/branches.rb
+- lib/github_api/client/repos/branches/protections.rb
+- lib/github_api/client/repos/collaborators.rb
+- lib/github_api/client/repos/comments.rb
+- lib/github_api/client/repos/commits.rb
+- lib/github_api/client/repos/contents.rb
+- lib/github_api/client/repos/deployments.rb
+- lib/github_api/client/repos/downloads.rb
+- lib/github_api/client/repos/forks.rb
+- lib/github_api/client/repos/hooks.rb
+- lib/github_api/client/repos/keys.rb
+- lib/github_api/client/repos/merging.rb
+- lib/github_api/client/repos/pages.rb
+- lib/github_api/client/repos/projects.rb
+- lib/github_api/client/repos/pub_sub_hubbub.rb
+- lib/github_api/client/repos/releases.rb
+- lib/github_api/client/repos/releases/assets.rb
+- lib/github_api/client/repos/releases/tags.rb
+- lib/github_api/client/repos/statistics.rb
+- lib/github_api/client/repos/statuses.rb
+- lib/github_api/client/say.rb
+- lib/github_api/client/scopes.rb
+- lib/github_api/client/search.rb
+- lib/github_api/client/search/legacy.rb
+- lib/github_api/client/users.rb
+- lib/github_api/client/users/emails.rb
+- lib/github_api/client/users/followers.rb
+- lib/github_api/client/users/keys.rb
+- lib/github_api/configuration.rb
+- lib/github_api/connection.rb
+- lib/github_api/constants.rb
+- lib/github_api/core_ext/array.rb
+- lib/github_api/core_ext/hash.rb
+- lib/github_api/core_ext/ordered_hash.rb
+- lib/github_api/deprecation.rb
+- lib/github_api/error.rb
+- lib/github_api/error/client_error.rb
+- lib/github_api/error/service_error.rb
+- lib/github_api/ext/faraday.rb
+- lib/github_api/mash.rb
+- lib/github_api/middleware.rb
+- lib/github_api/mime_type.rb
+- lib/github_api/normalizer.rb
+- lib/github_api/null_encoder.rb
+- lib/github_api/page_iterator.rb
+- lib/github_api/page_links.rb
+- lib/github_api/paged_request.rb
+- lib/github_api/pagination.rb
+- lib/github_api/parameter_filter.rb
+- lib/github_api/params_hash.rb
+- lib/github_api/rate_limit.rb
+- lib/github_api/request.rb
+- lib/github_api/request/basic_auth.rb
+- lib/github_api/request/jsonize.rb
+- lib/github_api/request/oauth2.rb
+- lib/github_api/request/verbs.rb
+- lib/github_api/response.rb
+- lib/github_api/response/atom_parser.rb
+- lib/github_api/response/follow_redirects.rb
+- lib/github_api/response/header.rb
+- lib/github_api/response/jsonize.rb
+- lib/github_api/response/mashify.rb
+- lib/github_api/response/raise_error.rb
+- lib/github_api/response/xmlize.rb
+- lib/github_api/response_wrapper.rb
+- lib/github_api/ssl_certs/cacerts.pem
+- lib/github_api/utils/url.rb
+- lib/github_api/validations.rb
+- lib/github_api/validations/format.rb
+- lib/github_api/validations/presence.rb
+- lib/github_api/validations/required.rb
+- lib/github_api/validations/token.rb
+- lib/github_api/version.rb
+homepage: http://piotrmurach.github.io/github/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2.1
+signing_key: 
+specification_version: 4
+summary: Ruby client for the official GitHub API
+test_files: []