octokit 3.6.1 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 016e1858848c8b7eb85db2c79fd06f963b9433c8
-  data.tar.gz: 3241849891bcc79293626322968a75a80a31c8f2
+  metadata.gz: 1f2a4c4a887142b38092500f915ae1e76045a088
+  data.tar.gz: 8b6a457b671dda7b59e4d95a9e21bf02326a0ff1
 SHA512:
-  metadata.gz: 77d89824a06d37e5623d68c000587641d6d85fbd6ab20da373b5f49edfa69d33438db176f99444eed6b7e8d1415b4e4e4ad8b9672239848b64346cd009f6573e
-  data.tar.gz: c325c51b7c9447da4e000e63b993f23c4f70abc97f7bd96bfb9aae257eb81a5dea00d2ac0c262d86df517491729c7dae26facd49f77a191def24c50f6087858f
+  metadata.gz: dcca491b69213f7fd2fe9aee6c439c7751b7d77802a2f8328e64456e6f3bc5739eef054e2640294df1c6430d820adef26d1d30aba1243c4b7fe7a377441b8169
+  data.tar.gz: d6e871030302eb322560f7534ff8ea963d616c455e711666a860c784443933a34e89ec6dc4bbf658e55ea6136d8c090e357b37b92743199c0760f508a2c2d34a

data/lib/octokit/client/hooks.rb

@@ -4,6 +4,8 @@ module Octokit
     # Methods for the Hooks API
     module Hooks
 
+      ORG_HOOKS_PREVIEW_MEDIA_TYPE = "application/vnd.github.sersi-preview+json".freeze
+
       # List all Service Hooks supported by GitHub
       #
       # @return [Sawyer::Resource] A list of all hooks on GitHub
@@ -13,6 +15,286 @@ module Octokit
       def available_hooks(options = {})
         get "hooks", options
       end
+
+      # List repo hooks
+      #
+      # Requires authenticated client.
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
+      # @return [Array<Sawyer::Resource>] Array of hashes representing hooks.
+      # @see https://developer.github.com/v3/repos/hooks/#list-hooks
+      # @example
+      #   @client.hooks('octokit/octokit.rb')
+      def hooks(repo, options = {})
+        paginate "#{Repository.path repo}/hooks", options
+      end
+
+      # Get single hook
+      #
+      # Requires authenticated client.
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
+      # @param id [Integer] Id of the hook to get.
+      # @return [Sawyer::Resource] Hash representing hook.
+      # @see https://developer.github.com/v3/repos/hooks/#get-single-hook
+      # @example
+      #   @client.hook('octokit/octokit.rb', 100000)
+      def hook(repo, id, options = {})
+        get "#{Repository.path repo}/hooks/#{id}", options
+      end
+
+      # Create a hook
+      #
+      # Requires authenticated client.
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
+      # @param name [String] The name of the service that is being called. See
+      #   {https://api.github.com/hooks Hooks} for the possible names.
+      # @param config [Hash] A Hash containing key/value pairs to provide
+      #   settings for this hook. These settings vary between the services and
+      #   are defined in the {https://github.com/github/github-services github-services} repo.
+      # @option options [Array<String>] :events ('["push"]') Determines what
+      #   events the hook is triggered for.
+      # @option options [Boolean] :active Determines whether the hook is
+      #   actually triggered on pushes.
+      # @return [Sawyer::Resource] Hook info for the new hook
+      # @see https://api.github.com/hooks
+      # @see https://github.com/github/github-services
+      # @see https://developer.github.com/v3/repos/hooks/#create-a-hook
+      # @example
+      #   @client.create_hook(
+      #     'octokit/octokit.rb',
+      #     'web',
+      #     {
+      #       :url => 'http://something.com/webhook',
+      #       :content_type => 'json'
+      #     },
+      #     {
+      #       :events => ['push', 'pull_request'],
+      #       :active => true
+      #     }
+      #   )
+      def create_hook(repo, name, config, options = {})
+        options = {:name => name, :config => config, :events => ["push"], :active => true}.merge(options)
+        post "#{Repository.path repo}/hooks", options
+      end
+
+      # Edit a hook
+      #
+      # Requires authenticated client.
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
+      # @param id [Integer] Id of the hook being updated.
+      # @param name [String] The name of the service that is being called. See
+      #   {https://api.github.com/hooks Hooks} for the possible names.
+      # @param config [Hash] A Hash containing key/value pairs to provide
+      #   settings for this hook. These settings vary between the services and
+      #   are defined in the {https://github.com/github/github-services github-services} repo.
+      # @option options [Array<String>] :events ('["push"]') Determines what
+      #   events the hook is triggered for.
+      # @option options [Array<String>] :add_events Determines a list of events
+      #   to be added to the list of events that the Hook triggers for.
+      # @option options [Array<String>] :remove_events Determines a list of events
+      #   to be removed from the list of events that the Hook triggers for.
+      # @option options [Boolean] :active Determines whether the hook is
+      #   actually triggered on pushes.
+      # @return [Sawyer::Resource] Hook info for the updated hook
+      # @see https://api.github.com/hooks
+      # @see https://github.com/github/github-services
+      # @see https://developer.github.com/v3/repos/hooks/#edit-a-hook
+      # @example
+      #   @client.edit_hook(
+      #     'octokit/octokit.rb',
+      #     100000,
+      #     'web',
+      #     {
+      #       :url => 'http://something.com/webhook',
+      #       :content_type => 'json'
+      #     },
+      #     {
+      #       :add_events => ['status'],
+      #       :remove_events => ['pull_request'],
+      #       :active => true
+      #     }
+      #   )
+      def edit_hook(repo, id, name, config, options = {})
+        options = {:name => name, :config => config, :events => ["push"], :active => true}.merge(options)
+        patch "#{Repository.path repo}/hooks/#{id}", options
+      end
+
+      # Delete hook
+      #
+      # Requires authenticated client.
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
+      # @param id [Integer] Id of the hook to remove.
+      # @return [Boolean] True if hook removed, false otherwise.
+      # @see https://developer.github.com/v3/repos/hooks/#delete-a-hook
+      # @example
+      #   @client.remove_hook('octokit/octokit.rb', 1000000)
+      def remove_hook(repo, id, options = {})
+        boolean_from_response :delete, "#{Repository.path repo}/hooks/#{id}", options
+      end
+
+      # Test hook
+      #
+      # Requires authenticated client.
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
+      # @param id [Integer] Id of the hook to test.
+      # @return [Boolean] Success
+      # @see https://developer.github.com/v3/repos/hooks/#test-a-push-hook
+      # @example
+      #   @client.test_hook('octokit/octokit.rb', 1000000)
+      def test_hook(repo, id, options = {})
+        boolean_from_response :post, "#{Repository.path repo}/hooks/#{id}/tests", options
+      end
+
+      # List org hooks
+      #
+      # Requires client authenticated as admin for the org.
+      #
+      # @param org [String] A GitHub organization login.
+      # @return [Array<Sawyer::Resource>] Array of hashes representing hooks.
+      # @see https://developer.github.com/v3/orgs/hooks/#list-hooks
+      # @example
+      #   @client.org_hooks('octokit')
+      def org_hooks(org, options = {})
+        options = ensure_org_hooks_api_media_type(options)
+        paginate "orgs/#{org}/hooks", options
+      end
+      alias :list_org_hooks :org_hooks
+
+      # Get an org hook
+      #
+      # Requires client authenticated as admin for the org.
+      #
+      # @param org [String] A GitHub organization login.
+      # @param id [Integer] Id of the hook to get.
+      # @return [Sawyer::Resource] Hash representing hook.
+      # @see https://developer.github.com/v3/orgs/hooks/#get-single-hook
+      # @example
+      #   @client.org_hook('octokit', 123)
+      def org_hook(org, id, options = {})
+        options = ensure_org_hooks_api_media_type(options)
+        get "orgs/#{org}/hooks/#{id}", options
+      end
+
+      # Create an org hook
+      #
+      # Requires client authenticated as admin for the org.
+      #
+      # @param org [String] A GitHub organization login.
+      # @param config [Hash] A Hash containing key/value pairs to provide
+      #   settings for this hook.
+      # @option options [Array<String>] :events ('["push"]') Determines what
+      #   events the hook is triggered for.
+      # @option options [Boolean] :active Determines whether the hook is
+      #   actually triggered on pushes.
+      # @return [Sawyer::Resource] Hook info for the new hook
+      # @see https://api.github.com/hooks
+      # @see https://developer.github.com/v3/orgs/hooks/#create-a-hook
+      # @example
+      #   @client.create_org_hook(
+      #     'octokit',
+      #     {
+      #       :url => 'http://something.com/webhook',
+      #       :content_type => 'json'
+      #     },
+      #     {
+      #       :events => ['push', 'pull_request'],
+      #       :active => true
+      #     }
+      #   )
+      def create_org_hook(org, config, options = {})
+        options = ensure_org_hooks_api_media_type(options)
+        options = { :name => "web", :config => config }.merge(options)
+        post "orgs/#{org}/hooks", options
+      end
+
+      # Update an org hook
+      #
+      # Requires client authenticated as admin for the org.
+      #
+      # @param org [String] A GitHub organization login.
+      # @param id [Integer] Id of the hook to update.
+      # @param config [Hash] A Hash containing key/value pairs to provide
+      #   settings for this hook.
+      # @option options [Array<String>] :events ('["push"]') Determines what
+      #   events the hook is triggered for.
+      # @option options [Boolean] :active Determines whether the hook is
+      #   actually triggered on pushes.
+      # @return [Sawyer::Resource] Hook info for the new hook
+      # @see https://api.github.com/hooks
+      # @see https://developer.github.com/v3/orgs/hooks/#edit-a-hook
+      # @example
+      #   @client.edit_org_hook(
+      #     'octokit',
+      #     123,
+      #     {
+      #       :url => 'http://something.com/webhook',
+      #       :content_type => 'json'
+      #     },
+      #     {
+      #       :events => ['push', 'pull_request'],
+      #       :active => true
+      #     }
+      #   )
+      def edit_org_hook(org, id, config, options = {})
+        options = ensure_org_hooks_api_media_type(options)
+        options = { :config => config }.merge(options)
+        patch "orgs/#{org}/hooks/#{id}", options
+      end
+      alias :update_org_hook :edit_org_hook
+
+      # Ping org hook
+      #
+      # Requires client authenticated as admin for the org.
+      #
+      # @param org [String] A GitHub organization login.
+      # @param id [Integer] Id of the hook to update.
+      # @return [Boolean] Success
+      # @see https://developer.github.com/v3/orgs/hooks/#ping-a-hook
+      # @example
+      #   @client.ping_org_hook('octokit', 1000000)
+      def ping_org_hook(org, id, options = {})
+        options = ensure_org_hooks_api_media_type(options)
+        boolean_from_response :post, "orgs/#{org}/hooks/#{id}/pings", options
+      end
+
+      # Remove org hook
+      #
+      # Requires client authenticated as admin for the org.
+      #
+      # @param org [String] A GitHub organization login.
+      # @param id [Integer] Id of the hook to update.
+      # @return [Boolean] True if hook removed, false otherwise.
+      # @see https://developer.github.com/v3/orgs/hooks/#delete-a-hook
+      # @example
+      #   @client.remove_org_hook('octokit', 1000000)
+      def remove_org_hook(org, id, options = {})
+        options = ensure_org_hooks_api_media_type(options)
+        boolean_from_response :delete, "orgs/#{org}/hooks/#{id}", options
+      end
+
+      private
+
+      def ensure_org_hooks_api_media_type(options = {})
+        if options[:accept].nil?
+          options[:accept] = ORG_HOOKS_PREVIEW_MEDIA_TYPE
+          warn_org_hooks_preview
+        end
+
+        options
+      end
+
+      def warn_org_hooks_preview
+        octokit_warn <<-EOS
+WARNING: The preview version of the Org Hooks API is not yet suitable for production use.
+You can avoid this message by supplying an appropriate media type in the 'Accept' request
+header. See the blog post for details: http://git.io/<LINK>
+EOS
+      end
     end
   end
 end

data/lib/octokit/client/repositories.rb

@@ -481,140 +481,6 @@ module Octokit
       end
       alias :get_branch :branch
 
-      # List repo hooks
-      #
-      # Requires authenticated client.
-      #
-      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
-      # @return [Array<Sawyer::Resource>] Array of hashes representing hooks.
-      # @see https://developer.github.com/v3/repos/hooks/#list-hooks
-      # @example
-      #   @client.hooks('octokit/octokit.rb')
-      def hooks(repo, options = {})
-        paginate "#{Repository.path repo}/hooks", options
-      end
-
-      # Get single hook
-      #
-      # Requires authenticated client.
-      #
-      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
-      # @param id [Integer] Id of the hook to get.
-      # @return [Sawyer::Resource] Hash representing hook.
-      # @see https://developer.github.com/v3/repos/hooks/#get-single-hook
-      # @example
-      #   @client.hook('octokit/octokit.rb', 100000)
-      def hook(repo, id, options = {})
-        get "#{Repository.path repo}/hooks/#{id}", options
-      end
-
-      # Create a hook
-      #
-      # Requires authenticated client.
-      #
-      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
-      # @param name [String] The name of the service that is being called. See
-      #   {https://api.github.com/hooks Hooks} for the possible names.
-      # @param config [Hash] A Hash containing key/value pairs to provide
-      #   settings for this hook. These settings vary between the services and
-      #   are defined in the {https://github.com/github/github-services github-services} repo.
-      # @option options [Array<String>] :events ('["push"]') Determines what
-      #   events the hook is triggered for.
-      # @option options [Boolean] :active Determines whether the hook is
-      #   actually triggered on pushes.
-      # @return [Sawyer::Resource] Hook info for the new hook
-      # @see https://api.github.com/hooks
-      # @see https://github.com/github/github-services
-      # @see https://developer.github.com/v3/repos/hooks/#create-a-hook
-      # @example
-      #   @client.create_hook(
-      #     'octokit/octokit.rb',
-      #     'web',
-      #     {
-      #       :url => 'http://something.com/webhook',
-      #       :content_type => 'json'
-      #     },
-      #     {
-      #       :events => ['push', 'pull_request'],
-      #       :active => true
-      #     }
-      #   )
-      def create_hook(repo, name, config, options = {})
-        options = {:name => name, :config => config, :events => ["push"], :active => true}.merge(options)
-        post "#{Repository.path repo}/hooks", options
-      end
-
-      # Edit a hook
-      #
-      # Requires authenticated client.
-      #
-      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
-      # @param id [Integer] Id of the hook being updated.
-      # @param name [String] The name of the service that is being called. See
-      #   {https://api.github.com/hooks Hooks} for the possible names.
-      # @param config [Hash] A Hash containing key/value pairs to provide
-      #   settings for this hook. These settings vary between the services and
-      #   are defined in the {https://github.com/github/github-services github-services} repo.
-      # @option options [Array<String>] :events ('["push"]') Determines what
-      #   events the hook is triggered for.
-      # @option options [Array<String>] :add_events Determines a list of events
-      #   to be added to the list of events that the Hook triggers for.
-      # @option options [Array<String>] :remove_events Determines a list of events
-      #   to be removed from the list of events that the Hook triggers for.
-      # @option options [Boolean] :active Determines whether the hook is
-      #   actually triggered on pushes.
-      # @return [Sawyer::Resource] Hook info for the updated hook
-      # @see https://api.github.com/hooks
-      # @see https://github.com/github/github-services
-      # @see https://developer.github.com/v3/repos/hooks/#edit-a-hook
-      # @example
-      #   @client.edit_hook(
-      #     'octokit/octokit.rb',
-      #     100000,
-      #     'web',
-      #     {
-      #       :url => 'http://something.com/webhook',
-      #       :content_type => 'json'
-      #     },
-      #     {
-      #       :add_events => ['status'],
-      #       :remove_events => ['pull_request'],
-      #       :active => true
-      #     }
-      #   )
-      def edit_hook(repo, id, name, config, options = {})
-        options = {:name => name, :config => config, :events => ["push"], :active => true}.merge(options)
-        patch "#{Repository.path repo}/hooks/#{id}", options
-      end
-
-      # Delete hook
-      #
-      # Requires authenticated client.
-      #
-      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
-      # @param id [Integer] Id of the hook to remove.
-      # @return [Boolean] True if hook removed, false otherwise.
-      # @see https://developer.github.com/v3/repos/hooks/#delete-a-hook
-      # @example
-      #   @client.remove_hook('octokit/octokit.rb', 1000000)
-      def remove_hook(repo, id, options = {})
-        boolean_from_response :delete, "#{Repository.path repo}/hooks/#{id}", options
-      end
-
-      # Test hook
-      #
-      # Requires authenticated client.
-      #
-      # @param repo [Integer, String, Hash, Repository] A GitHub repository.
-      # @param id [Integer] Id of the hook to test.
-      # @return [Boolean] Success
-      # @see https://developer.github.com/v3/repos/hooks/#test-a-push-hook
-      # @example
-      #   @client.test_hook('octokit/octokit.rb', 1000000)
-      def test_hook(repo, id, options = {})
-        boolean_from_response :post, "#{Repository.path repo}/hooks/#{id}/tests", options
-      end
-
       # List users available for assigning to issues.
       #
       # Requires authenticated client for private repos.

data/lib/octokit/version.rb

@@ -2,6 +2,6 @@ module Octokit
 
   # Current version
   # @return [String]
-  VERSION = "3.6.1".freeze
+  VERSION = "3.7.0".freeze
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: octokit
 version: !ruby/object:Gem::Version
-  version: 3.6.1
+  version: 3.7.0
 platform: ruby
 authors:
 - Wynn Netherland