octokit 8.1.0 → 9.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dead7bdb61143c1a0b84afa0b02b567a29e117b0b15e0d0ee10271bb9dc62a17
-  data.tar.gz: 648cb60f5d7f8765f925ec2a673dd00331151d3222b392a9814e856e6d303a67
+  metadata.gz: f755fdeae0b35f76932ffa267d2d73e01b5d137f5f740d8e80106fc6c0bcb226
+  data.tar.gz: 473dc0bee0251cb20935bc9e2160e7e92b851271dc67010bda79a94bef8adb68
 SHA512:
-  metadata.gz: 9b5d2d09d0665466a4bdca1d523758ad447db67c911284c2738a311c400267dbbabcf4c92079c83550339b1cd5361abe841a672a89bc77a7345940d3041cee65
-  data.tar.gz: ca2ced14c1bb869c41f94806427fbd16917eadd6486c35c58c69c59c44b384c323b282266ae95b84bd6109674051a963d6b2d1fea15609bbc61c033a55b6e90f
+  metadata.gz: 51f43e8ac4d7082309ce0e673fa0c948f5ff62e5982a2079cec57639a047be09a12a443788993929d3ab82ec6998ed49ceaa479b5d8b3fe5deef04e29549672d
+  data.tar.gz: bfcc814b67b08b256832fb7d168166082289a6281caa0ec81fc98ce03d376d976037e5c99c72e63d9f1440c0d1e1e5bac1c925a0fe5db6ef3d0cae7aa63e56b5

data/README.md

@@ -81,7 +81,7 @@ Install via Rubygems
 
 ... or add to your Gemfile
 
-    gem "octokit", "~> 5.0"
+    gem "octokit"
 
 Access the library in Ruby:
 
@@ -709,6 +709,9 @@ Octokit:
 | `OCTOKIT_TEST_GITHUB_ENTERPRISE_MANAGEMENT_CONSOLE_PASSWORD` | GitHub Enterprise management console password.                                                                                                                                                    |
 | `OCTOKIT_TEST_GITHUB_ENTERPRISE_ENDPOINT`                    | GitHub Enterprise hostname.                                                                                                                                                                       |
 | `OCTOKIT_TEST_GITHUB_ENTERPRISE_MANAGEMENT_CONSOLE_ENDPOINT` | GitHub Enterprise Management Console endpoint.                                                                                                                                                    |
+| `OCTOKIT_TEST_GITHUB_MANAGE_GHES_ENDPOINT`                          | GitHub Enterprise Server GHES Manage Endpoint.                                                                                                                                                    |
+| `OCTOKIT_TEST_GITHUB_MANAGE_GHES_USERNAME`                          | GitHub Enterprise Server GHES Manage Username.                                                                                                                                                    |
+| `OCTOKIT_TEST_GITHUB_MANAGE_GHES_PASSWORD`                          | GitHub Enterprise Server GHES Manage Password.                                                                                                                                                    |
 | `OCTOKIT_TEST_GITHUB_INTEGRATION`                            | [GitHub Integration](https://developer.github.com/early-access/integrations/) owned by your test organization.                                                                                    |
 | `OCTOKIT_TEST_GITHUB_INTEGRATION_INSTALLATION`               | Installation of the GitHub Integration specified above.                                                                                                                                           |
 | `OCTOKIT_TEST_INTEGRATION_PEM_KEY`                           | File path to the private key generated from your integration.                                                                                                                                     |
@@ -738,6 +741,7 @@ implementations:
 * Ruby 3.0
 * Ruby 3.1
 * Ruby 3.2
+* Ruby 3.3
 
 If something doesn't work on one of these Ruby versions, it's a bug.
 

data/lib/octokit/arguments.rb

@@ -8,7 +8,7 @@ module Octokit
 
     def initialize(args)
       @options = args.last.is_a?(::Hash) ? args.pop : {}
-      super(args)
+      super
     end
   end
 end

data/lib/octokit/client/apps.rb

@@ -231,6 +231,18 @@ module Octokit
         end
       end
 
+      # Returns a delivery for the webhook configured for a GitHub App.
+      #
+      # @param delivery_id [String] The id of a GitHub App Hook Delivery
+      # @param options [Hash] A customizable set of options
+      #
+      # @see https://docs.github.com/en/rest/apps/webhooks#get-a-delivery-for-an-app-webhook
+      #
+      # @return [<Sawyer::Resource>] The webhook delivery
+      def app_hook_delivery(delivery_id, options = {})
+        get "/app/hook/deliveries/#{delivery_id}", options
+      end
+
       # Redeliver a delivery for the webhook configured for a GitHub App.
       #
       # @param delivery_id [Integer] The id of a GitHub App Hook Delivery

data/lib/octokit/client/code_scanning.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'base64'
 require 'tempfile'
 require 'zlib'
 
@@ -10,6 +9,144 @@ module Octokit
     #
     # @see https://docs.github.com/rest/code-scanning
     module CodeScanning
+      # Updates a code scanning default setup configuration
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param state [String] The desired state of code scanning default setup
+      # @param query_suite [String] CodeQL query suite to be used
+      # @param languages [Array] List of CodeQL languages to be analyzed
+      #
+      # @return [Sawyer::Resource] Action Run information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration
+      def update_code_scanning_default_config(repo, state, query_suite = nil, languages = nil, options = {})
+        options[:state] = state
+        options[:query_suite] = query_suite if query_suite
+        options[:languages] = languages if languages
+
+        patch "#{Repository.path repo}/code-scanning/default-setup", options
+      end
+
+      # Get Code Scanning Default Configuration
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      #
+      # @return [Sawyer::Resource] CodeQl Default Setup Configuration Information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration
+      def get_code_scanning_default_config(repo, options = {})
+        get "#{Repository.path repo}/code-scanning/default-setup", options
+      end
+
+      # Gets a CodeQL database for a language in a repository
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param language [String]
+      #
+      # @return [Sawyer::Resource] CodeQl Default Setup Configuration Information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository
+      def get_codeql_database_for_repo(repo, language, options = {})
+        get "#{Repository.path repo}/code-scanning/codeql/databases/#{language}", options
+      end
+
+      # Lists the CodeQL databases that are available in a repository
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      #
+      # @return [Array] List of CodeQL Databases
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository
+      def list_codeql_database_for_repo(repo, options = {})
+        get "#{Repository.path repo}/code-scanning/codeql/databases", options
+      end
+
+      # Delete a specified code scanning analysis from a repository
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param analysis_id [Integer] ID of the code scanning analysis
+      #
+      # @return [Sawyer::Resource] Next Code Scanning Analysis Information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository
+      def delete_code_scanning_analysis(repo, analysis_id, options = {})
+        delete "#{Repository.path repo}/code-scanning/analyses/#{analysis_id}", options
+      end
+
+      # Get a code scanning analysis for a repository
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param analysis_id [Integer] ID of the code scanning analysis
+      #
+      # @return [Sawyer::Resource] Code Scanning Analysis
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository
+      def get_code_scanning_analysis(repo, analysis_id, options = {})
+        get "#{Repository.path repo}/code-scanning/analyses/#{analysis_id}", options
+      end
+
+      # List code scanning analyses for a repository
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      #
+      # @return [Array] List of Code Scanning Analyses
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository
+      def list_code_scanning_analysis(repo, options = {})
+        paginate "#{Repository.path repo}/code-scanning/analyses", options
+      end
+
+      # List instances of a code scanning alert
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param alert_number [Integer] The number that identifies an alert
+      #
+      # @return [Array] List of Code Scanning Alerts
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert
+      def list_instances_of_code_scanning_alert(repo, alert_number, options = {})
+        paginate "#{Repository.path repo}/code-scanning/alerts/#{alert_number}/instances", options
+      end
+
+      # Update a code scanning alert
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param alert_number [Integer] The number that identifies an alert
+      # @param state [String] The reason for dismissing or closing the alert. Required when the state is dismissed
+      #
+      # @return [Sawyer::Resource] Code Scanning Alert information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#update-a-code-scanning-alert
+      def update_code_scanning_alert(repo, alert_number, state, reason, comment = nil, options = {})
+        options[:state] = state
+        options[:dismissed_reason] = reason
+        options[:dismissed_comment] = comment if comment
+
+        patch "#{Repository.path repo}/code-scanning/alerts/#{alert_number}", options
+      end
+
+      # Gets a single code scanning alert
+      #
+      # @param repo [Integer, String, Repository, Hash] A GitHub repository
+      # @param alert_number [Integer] The number that identifies an alert
+      #
+      # @return [Sawyer::Resource] Code Scanning Alert
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#get-a-code-scanning-alert
+      def get_code_scanning_alert(repo, alert_number, options = {})
+        get "#{Repository.path repo}/code-scanning/alerts/#{alert_number}", options
+      end
+
+      # List code scanning alerts for a repository
+      #
+      # @param org [String] A GitHub organization
+      #
+      # @return [Array] Code Scanning Alert information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository
+      def list_code_scanning_alerts_for_repo(repo, options = {})
+        paginate "#{Repository.path repo}/code-scanning/alerts", options
+      end
+
+      # List code scanning alerts for an organization
+      #
+      # @param org [String] A GitHub organization
+      #
+      # @return [Array] Code Scanning Alert information
+      # @see https://docs.github.com/en/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization
+      def list_code_scanning_alerts_for_org(org, options = {})
+        paginate "orgs/#{org}/code-scanning/alerts", options
+      end
+
       # Uploads SARIF data containing the results of a code scanning analysis
       #
       # @param repo [Integer, String, Repository, Hash] A GitHub repository
@@ -45,7 +182,7 @@ module Octokit
           Zlib::GzipWriter.open(tempfile) do |gz_file|
             gz_file.write File.binread(file)
           end
-          Base64.strict_encode64(tempfile.read)
+          [tempfile.read].pack('m0') # Base64.strict_encode64
         end
       end
     end

data/lib/octokit/client/contents.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'base64'
-
 module Octokit
   class Client
     # Methods for the Repo Contents API
@@ -80,7 +78,7 @@ module Octokit
         end
         raise ArgumentError, 'content or :file option required' if content.nil?
 
-        options[:content] = Base64.strict_encode64(content)
+        options[:content] = [content].pack('m0') # Base64.strict_encode64
         options[:message] = message
         url = "#{Repository.path repo}/contents/#{path}"
         put url, options

data/lib/octokit/client/environments.rb

@@ -24,7 +24,10 @@ module Octokit
       # @return [Sawyer::Resource] Total count of environments and list of environments
       # @see https://docs.github.com/en/rest/deployments/environments#list-environments
       def environments(repo, options = {})
-        get("#{Repository.path repo}/environments", options)
+        paginate("#{Repository.path repo}/environments", options) do |data, last_response|
+          data.environments.concat last_response.data.environments
+          data.total_count += last_response.data.total_count
+        end
       end
       alias list_environments environments
 

data/lib/octokit/client.rb

@@ -50,7 +50,6 @@ require 'octokit/client/objects'
 require 'octokit/client/organizations'
 require 'octokit/client/pages'
 require 'octokit/client/projects'
-require 'octokit/client/pub_sub_hubbub'
 require 'octokit/client/pull_requests'
 require 'octokit/client/rate_limit'
 require 'octokit/client/reactions'
@@ -118,7 +117,6 @@ module Octokit
     include Octokit::Client::Organizations
     include Octokit::Client::Pages
     include Octokit::Client::Projects
-    include Octokit::Client::PubSubHubbub
     include Octokit::Client::PullRequests
     include Octokit::Client::RateLimit
     include Octokit::Client::Reactions

data/lib/octokit/configurable.rb

@@ -32,6 +32,12 @@ module Octokit
     #   @return [String] An admin password set up for your GitHub Enterprise management console
     # @!attribute management_console_endpoint
     #   @return [String] Base URL for API requests to the GitHub Enterprise management console
+    # @!attribute manage_ghes_endpoint
+    #   @return [String] Base URL for API requests to the GitHub Enterprise Server Manage API
+    # @!attribute manage_ghes_username
+    #   @return [String] API username for requests to the GitHub Enterprise Server Manage API
+    # @!attribute manage_ghes_password
+    #   @return [String] API user password for requests to the GitHub Enterprise Server Manage API
     # @!attribute middleware
     #   @see https://github.com/lostisland/faraday
     #   @return [Faraday::Builder or Faraday::RackBuilder] Configure middleware for Faraday
@@ -59,7 +65,10 @@ module Octokit
                   :middleware, :netrc, :netrc_file,
                   :per_page, :proxy, :ssl_verify_mode, :user_agent
     attr_writer :password, :web_endpoint, :api_endpoint, :login,
-                :management_console_endpoint, :management_console_password
+                :management_console_endpoint, :management_console_password,
+                :manage_ghes_endpoint,
+                :manage_ghes_username,
+                :manage_ghes_password
 
     class << self
       # List of configurable keys for {Octokit::Client}
@@ -77,6 +86,9 @@ module Octokit
           login
           management_console_endpoint
           management_console_password
+          manage_ghes_endpoint
+          manage_ghes_username
+          manage_ghes_password
           middleware
           netrc
           netrc_file
@@ -126,6 +138,10 @@ module Octokit
       File.join(@management_console_endpoint, '')
     end
 
+    def manage_ghes_endpoint
+      File.join(@manage_ghes_endpoint, '')
+    end
+
     # Base URL for generated web URLs
     #
     # @return [String] Default: https://github.com/

data/lib/octokit/default.rb

@@ -12,6 +12,11 @@ if Gem::Version.new(Faraday::VERSION) >= Gem::Version.new('2.0')
   rescue LoadError
     Octokit::Warnable.octokit_warn 'To use retry middleware with Faraday v2.0+, install `faraday-retry` gem'
   end
+  begin
+    require 'faraday/multipart'
+  rescue LoadError
+    Octokit::Warnable.octokit_warn 'To use multipart middleware with Faraday v2.0+, install `faraday-multipart` gem; note: this is used by the ManageGHES client for uploading licenses'
+  end
 end
 
 module Octokit
@@ -102,6 +107,24 @@ module Octokit
         ENV.fetch('OCTOKIT_ENTERPRISE_MANAGEMENT_CONSOLE_ENDPOINT', nil)
       end
 
+      # Default GHES Manage API endpoint from ENV
+      # @return [String]
+      def manage_ghes_endpoint
+        ENV.fetch('OCTOKIT_MANAGE_GHES_ENDPOINT', nil)
+      end
+
+      # Default GHES Manage API username from ENV
+      # @return [String]
+      def manage_ghes_username
+        ENV.fetch('OCTOKIT_MANAGE_GHES_USERNAME', nil)
+      end
+
+      # Default GHES Manage API password from ENV
+      # @return [String]
+      def manage_ghes_password
+        ENV.fetch('OCTOKIT_MANAGE_GHES_PASSWORD', nil)
+      end
+
       # Default options for Faraday::Connection
       # @return [Hash]
       def connection_options

data/lib/octokit/enterprise_management_console_client/management_console.rb

@@ -14,6 +14,7 @@ module Octokit
       # @see https://docs.github.com/en/enterprise-server@3.4/rest/enterprise-admin/management-console#create-a-github-license
       # @return nil
       def upload_license(license, settings = nil)
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         conn = faraday_configuration
 
         params = {}
@@ -28,6 +29,7 @@ module Octokit
       #
       # @return nil
       def start_configuration
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         post '/setup/api/configure', password_hash
       end
 
@@ -37,6 +39,7 @@ module Octokit
       #
       # @return nil
       def upgrade(license)
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         conn = faraday_configuration
 
         params = {}
@@ -49,6 +52,7 @@ module Octokit
       #
       # @return [Sawyer::Resource] The installation information
       def config_status
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         get '/setup/api/configcheck', password_hash
       end
       alias config_check config_status
@@ -57,6 +61,7 @@ module Octokit
       #
       # @return [Sawyer::Resource] The settings
       def settings
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         get '/setup/api/settings', password_hash
       end
       alias get_settings settings
@@ -67,6 +72,7 @@ module Octokit
       #
       # @return [nil]
       def edit_settings(settings)
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         queries = password_hash
         queries[:query][:settings] = settings.to_json.to_s
         put '/setup/api/settings', queries
@@ -76,6 +82,7 @@ module Octokit
       #
       # @return [Sawyer::Resource] The maintenance status
       def maintenance_status
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         get '/setup/api/maintenance', password_hash
       end
       alias get_maintenance_status maintenance_status
@@ -85,6 +92,7 @@ module Octokit
       # @param maintenance [Hash] A hash configuration of the maintenance settings
       # @return [nil]
       def set_maintenance_status(maintenance)
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         queries = password_hash
         queries[:query][:maintenance] = maintenance.to_json.to_s
         post '/setup/api/maintenance', queries
@@ -95,6 +103,7 @@ module Octokit
       #
       # @return [Sawyer::Resource] An array of authorized SSH keys
       def authorized_keys
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         get '/setup/api/settings/authorized-keys', password_hash
       end
       alias get_authorized_keys authorized_keys
@@ -104,6 +113,7 @@ module Octokit
       # @param key Either the file path to a key, a File handler to the key, or the contents of the key itself
       # @return [Sawyer::Resource] An array of authorized SSH keys
       def add_authorized_key(key)
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         queries = password_hash
         case key
         when String
@@ -128,6 +138,7 @@ module Octokit
       # @param key Either the file path to a key, a File handler to the key, or the contents of the key itself
       # @return [Sawyer::Resource] An array of authorized SSH keys
       def remove_authorized_key(key)
+        octokit_warn('The Management Console API will be deprecated in GitHub Enterprise Server 3.14.0, please use the ManageGHES client instead.')
         queries = password_hash
         case key
         when String

data/lib/octokit/error.rb

@@ -10,6 +10,7 @@ module Octokit
     #
     # @param [Hash] response HTTP response
     # @return [Octokit::Error]
+    # rubocop:disable Metrics/CyclomaticComplexity
     def self.from_response(response)
       status  = response[:status].to_i
       body    = response[:body].to_s
@@ -23,6 +24,7 @@ module Octokit
                   when 405      then Octokit::MethodNotAllowed
                   when 406      then Octokit::NotAcceptable
                   when 409      then Octokit::Conflict
+                  when 410      then Octokit::Deprecated
                   when 415      then Octokit::UnsupportedMediaType
                   when 422      then error_for_422(body)
                   when 451      then Octokit::UnavailableForLegalReasons
@@ -36,6 +38,7 @@ module Octokit
         klass.new(response)
       end
     end
+    # rubocop:enable Metrics/CyclomaticComplexity
 
     def build_error_context
       if RATE_LIMITED_ERRORS.include?(self.class)
@@ -317,6 +320,9 @@ module Octokit
   # Raised when GitHub returns a 409 HTTP status code
   class Conflict < ClientError; end
 
+  # Raised when GHES Manage return a 410 HTTP status code
+  class Deprecated < ClientError; end
+
   # Raised when GitHub returns a 414 HTTP status code
   class UnsupportedMediaType < ClientError; end
 

data/lib/octokit/manage_ghes_client/manage_ghes.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+module Octokit
+  # Client for the Manage GitHub Enterprise Server API
+  class ManageGHESClient
+    # Methods for the Manage GitHub Enterprise Server API
+    #
+    # @see https://developer.github.com/v3/enterprise-admin/manage-ghes
+    module ManageAPI
+      # Get information about the maintenance status of the GHES instance
+      #
+      # @return [nil]
+      def maintenance_mode
+        conn = authenticated_client
+
+        @last_response = conn.get('/manage/v1/maintenance')
+      end
+
+      # Configure the maintenance mode of the GHES instance
+      #
+      # @param maintenance [Hash] A hash configuration of the maintenance mode status
+      # @return [nil]
+      def set_maintenance_mode(enabled, options = {})
+        conn = authenticated_client
+
+        options[:enabled] = enabled
+        @last_response = conn.post('/manage/v1/maintenance', options)
+      end
+      alias configure_maintenance_mode set_maintenance_mode
+    end
+
+    # Uploads a license for the first time
+    #
+    # @param license [String] The path to your .ghl license file.
+    #
+    # @return [nil]
+    def upload_license(license)
+      conn = authenticated_client
+      conn.request :multipart
+      params = {}
+      params[:license] = Faraday::FilePart.new(license, 'binary')
+      params[:password] = @manage_ghes_password
+      @last_response = conn.post('/manage/v1/config/init', params, { 'Content-Type' => 'multipart/form-data' })
+    end
+
+    # Start a configuration process.
+    #
+    # @return [nil]
+    def start_configuration
+      conn = authenticated_client
+      @last_response = conn.post('/manage/v1/config/apply')
+    end
+
+    # Get information about the Enterprise installation
+    #
+    # @return [nil]
+    def config_status
+      conn = authenticated_client
+      @last_response = conn.get('/manage/v1/config/apply')
+    end
+    alias config_check config_status
+
+    # Get information about the Enterprise installation
+    #
+    # @return [nil]
+    def settings
+      conn = authenticated_client
+      @last_response = conn.get('/manage/v1/config/settings')
+    end
+    alias get_settings settings
+
+    # Modify the Enterprise settings
+    #
+    # @param settings [Hash] A hash configuration of the new settings
+    #
+    # @return [nil]
+    def edit_settings(settings)
+      conn = authenticated_client
+      @last_response = conn.put('/manage/v1/config/settings', settings.to_json.to_s)
+    end
+
+    def authorized_keys
+      conn = authenticated_client
+      @last_response = conn.get('/manage/v1/access/ssh')
+    end
+    alias get_authorized_keys authorized_keys
+
+    # Add an authorized SSH keys on the Enterprise install
+    #
+    # @param key Either the file path to a key, a File handler to the key, or the contents of the key itself
+    # @return [nil]
+    def add_authorized_key(key)
+      conn = authenticated_client
+      case key
+      when String
+        if File.exist?(key)
+          key = File.open(key, 'r')
+          content = key.read.strip
+          key.close
+        else
+          content = key
+        end
+      when File
+        content = key.read.strip
+        key.close
+      end
+
+      queries = {}
+      queries[:key] = content
+      @last_response = conn.post('/manage/v1/access/ssh', queries)
+    end
+
+    # Removes an authorized SSH keys from the Enterprise install
+    #
+    # @param key Either the file path to a key, a File handler to the key, or the contents of the key itself
+    # @return [nil]
+    def remove_authorized_key(key)
+      conn = authenticated_client
+      case key
+      when String
+        if File.exist?(key)
+          key = File.open(key, 'r')
+          content = key.read.strip
+          key.close
+        else
+          content = key
+        end
+      when File
+        content = key.read.strip
+        key.close
+      end
+
+      queries = {}
+      queries[:key] = content
+      @last_response = conn.run_request(:delete, '/manage/v1/access/ssh', queries, nil)
+    end
+    alias delete_authorized_key remove_authorized_key
+
+    private
+
+    def basic_authenticated?
+      !!(@manage_ghes_username && @manage_ghes_password)
+    end
+
+    # If no username is provided, we assume root site admin should be used
+    def root_site_admin_assumed?
+      !@manage_ghes_username
+    end
+
+    def authenticated_client
+      @authenticated_client ||= Faraday.new(url: @manage_ghes_endpoint) do |c|
+        c.headers[:user_agent] = user_agent
+        c.request  :json
+        c.response :json
+        c.adapter Faraday.default_adapter
+
+        if root_site_admin_assumed?
+          username = 'api_key'
+        elsif basic_authenticated?
+          username = @manage_ghes_username
+        end
+        c.request(*FARADAY_BASIC_AUTH_KEYS, username, @manage_ghes_password)
+
+        # Disabling SSL is essential for certain self-hosted Enterprise instances
+        c.ssl[:verify] = false if connection_options[:ssl] && !connection_options[:ssl][:verify]
+
+        c.use Octokit::Response::RaiseError
+      end
+    end
+  end
+end

data/lib/octokit/manage_ghes_client.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'octokit/configurable'
+require 'octokit/connection'
+require 'octokit/warnable'
+require 'octokit/manage_ghes_client/manage_ghes'
+
+module Octokit
+  # ManageGHESClient is only meant to be used by GitHub Enterprise Server (GHES) operators
+  # and provides access to the Manage GHES API endpoints.
+  #
+  # @see Octokit::Client Use Octokit::Client for regular API use for GitHub
+  #   and GitHub Enterprise.
+  # @see https://developer.github.com/v3/enterprise-admin/manage-ghes/
+  class ManageGHESClient
+    include Octokit::Configurable
+    include Octokit::Connection
+    include Octokit::Warnable
+    include Octokit::ManageGHESClient::ManageAPI
+
+    def initialize(options = {})
+      # Use options passed in, but fall back to module defaults
+      # rubocop:disable Style/HashEachMethods
+      #
+      # This may look like a `.keys.each` which should be replaced with `#each_key`, but
+      # this doesn't actually work, since `#keys` is just a method we've defined ourselves.
+      # The class doesn't fulfill the whole `Enumerable` contract.
+      Octokit::Configurable.keys.each do |key|
+        # rubocop:enable Style/HashEachMethods
+        instance_variable_set(:"@#{key}", options[key] || Octokit.instance_variable_get(:"@#{key}"))
+      end
+    end
+
+    protected
+
+    def endpoint
+      manage_ghes_endpoint
+    end
+
+    # Set Manage GHES API endpoint
+    #
+    # @param value [String] Manage GHES API endpoint
+    def manage_ghes_endpoint=(value)
+      reset_agent
+      @manage_ghes_endpoint = value
+    end
+
+    # Set Manage GHES API username
+    #
+    # @param value [String] Manage GHES API username
+    def manage_ghes_username=(value)
+      reset_agent
+      @manage_ghes_username = value
+    end
+
+    # Set Manage GHES API password
+    #
+    # @param value [String] Manage GHES API password
+    def manage_ghes_password=(value)
+      reset_agent
+      @manage_ghes_password = value
+    end
+  end
+end

data/lib/octokit/repo_arguments.rb

@@ -9,7 +9,7 @@ module Octokit
     attr_reader :repo
 
     def initialize(args)
-      arguments = super(args)
+      arguments = super
       @repo = arguments.shift
 
       arguments

data/lib/octokit/version.rb

@@ -3,7 +3,7 @@
 module Octokit
   # Current major release.
   # @return [Integer]
-  MAJOR = 8
+  MAJOR = 9
 
   # Current minor release.
   # @return [Integer]

data/lib/octokit.rb

@@ -4,6 +4,7 @@ require 'octokit/default'
 require 'octokit/client'
 require 'octokit/enterprise_admin_client'
 require 'octokit/enterprise_management_console_client'
+require 'octokit/manage_ghes_client'
 
 # Ruby toolkit for the GitHub API
 module Octokit
@@ -41,12 +42,24 @@ module Octokit
       @enterprise_management_console_client = Octokit::EnterpriseManagementConsoleClient.new(options)
     end
 
+    # ManageGHESClient client based on configured options {Configurable}
+    #
+    # @return [Octokit::ManageGHESClient] API wrapper
+    def manage_ghes_client
+      if defined?(@manage_ghes_client) && @manage_ghes_client.same_options?(options)
+        return @manage_ghes_client
+      end
+
+      @manage_ghes_client = Octokit::ManageGHESClient.new(options)
+    end
+
     private
 
     def respond_to_missing?(method_name, include_private = false)
       client.respond_to?(method_name, include_private) ||
         enterprise_admin_client.respond_to?(method_name, include_private) ||
-        enterprise_management_console_client.respond_to?(method_name, include_private)
+        enterprise_management_console_client.respond_to?(method_name, include_private) ||
+        manage_ghes_client.respond_to?(method_name, include_private)
     end
 
     def method_missing(method_name, *args, &block)
@@ -56,6 +69,8 @@ module Octokit
         return enterprise_admin_client.send(method_name, *args, &block)
       elsif enterprise_management_console_client.respond_to?(method_name)
         return enterprise_management_console_client.send(method_name, *args, &block)
+      elsif manage_ghes_client.respond_to?(method_name)
+        return manage_ghes_client.send(method_name, *args, &block)
       end
 
       super

data/octokit.gemspec

@@ -5,7 +5,6 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'octokit/version'
 
 Gem::Specification.new do |spec|
-  spec.add_dependency 'base64'
   spec.add_dependency 'faraday', '>= 1', '< 3'
   spec.add_dependency 'sawyer', '~> 0.9'
   spec.authors = ['Wynn Netherland', 'Erik Michaels-Ober', 'Clint Shryock']

metadata

@@ -1,31 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: octokit
 version: !ruby/object:Gem::Version
-  version: 8.1.0
+  version: 9.1.0
 platform: ruby
 authors:
 - Wynn Netherland
 - Erik Michaels-Ober
 - Clint Shryock
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-01 00:00:00.000000000 Z
+date: 2024-06-11 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: base64
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -118,7 +104,6 @@ files:
 - lib/octokit/client/organizations.rb
 - lib/octokit/client/pages.rb
 - lib/octokit/client/projects.rb
-- lib/octokit/client/pub_sub_hubbub.rb
 - lib/octokit/client/pull_requests.rb
 - lib/octokit/client/rate_limit.rb
 - lib/octokit/client/reactions.rb
@@ -149,6 +134,8 @@ files:
 - lib/octokit/enterprise_management_console_client/management_console.rb
 - lib/octokit/error.rb
 - lib/octokit/gist.rb
+- lib/octokit/manage_ghes_client.rb
+- lib/octokit/manage_ghes_client/manage_ghes.rb
 - lib/octokit/middleware/follow_redirects.rb
 - lib/octokit/organization.rb
 - lib/octokit/rate_limit.rb
@@ -166,7 +153,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -181,8 +168,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.5
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Ruby toolkit for working with the GitHub API
 test_files: []

data/lib/octokit/client/pub_sub_hubbub.rb

@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-module Octokit
-  class Client
-    # Methods for the PubSubHubbub API
-    #
-    # @see https://developer.github.com/v3/repos/hooks/#pubsubhubbub
-    module PubSubHubbub
-      # Subscribe to a pubsub topic
-      #
-      # @param topic [String] A recoginized and supported pubsub topic
-      # @param callback [String] A callback url to be posted to when the topic event is fired
-      # @param secret [String] An optional shared secret used to generate a SHA1 HMAC of the outgoing body content
-      # @return [Boolean] true if the subscribe was successful, otherwise an error is raised
-      # @see https://developer.github.com/v3/repos/hooks/#subscribing
-      # @example Subscribe to push events from one of your repositories, having an email sent when fired
-      #   client = Octokit::Client.new(:oauth_token = "token")
-      #   client.subscribe("https://github.com/joshk/devise_imapable/events/push", "github://Email?address=josh.kalderimis@gmail.com")
-      def subscribe(topic, callback, secret = nil)
-        options = {
-          'hub.callback': callback,
-          'hub.mode': 'subscribe',
-          'hub.topic': topic
-        }
-        options.merge!('hub.secret': secret) unless secret.nil?
-
-        response = pub_sub_hubbub_request(options)
-
-        response.status == 204
-      end
-
-      # Unsubscribe from a pubsub topic
-      #
-      # @param topic [String] A recoginized pubsub topic
-      # @param callback [String] A callback url to be unsubscribed from
-      # @return [Boolean] true if the unsubscribe was successful, otherwise an error is raised
-      # @see https://developer.github.com/v3/repos/hooks/#subscribing
-      # @example Unsubscribe to push events from one of your repositories, no longer having an email sent when fired
-      #   client = Octokit::Client.new(:oauth_token = "token")
-      #   client.unsubscribe("https://github.com/joshk/devise_imapable/events/push", "github://Email?address=josh.kalderimis@gmail.com")
-      def unsubscribe(topic, callback)
-        options = {
-          'hub.callback': callback,
-          'hub.mode': 'unsubscribe',
-          'hub.topic': topic
-        }
-        response = pub_sub_hubbub_request(options)
-
-        response.status == 204
-      end
-
-      # Subscribe to a repository through pubsub
-      #
-      # @param repo [String, Repository, Hash] A GitHub repository
-      # @param service_name [String] service name owner
-      # @param service_arguments [Hash] params that will be passed by subscribed hook.
-      #    List of services is available @ https://github.com/github/github-services/tree/master/docs.
-      #    Please refer Data node for complete list of arguments.
-      # @param secret [String] An optional shared secret used to generate a SHA1 HMAC of the outgoing body content
-      # @return [Boolean] True if subscription successful, false otherwise
-      # @see https://developer.github.com/v3/repos/hooks/#subscribing
-      # @example Subscribe to push events to one of your repositories to Travis-CI
-      #    client = Octokit::Client.new(:oauth_token = "token")
-      #    client.subscribe_service_hook('joshk/device_imapable', 'Travis', { :token => "test", :domain => "domain", :user => "user" })
-      def subscribe_service_hook(repo, service_name, service_arguments = {}, secret = nil)
-        topic = "#{Octokit.web_endpoint}#{Repository.new(repo)}/events/push"
-        callback = "github://#{service_name}?#{service_arguments.collect { |k, v| [k, v].map { |p| URI.encode_www_form_component(p) }.join('=') }.join('&')}"
-        subscribe(topic, callback, secret)
-      end
-
-      # Unsubscribe repository through pubsub
-      #
-      # @param repo [String, Repository, Hash] A GitHub repository
-      # @param service_name [String] service name owner
-      #    List of services is available @ https://github.com/github/github-services/tree/master/docs.
-      # @see https://developer.github.com/v3/repos/hooks/#subscribing
-      # @example Subscribe to push events to one of your repositories to Travis-CI
-      #    client = Octokit::Client.new(:oauth_token = "token")
-      #    client.unsubscribe_service_hook('joshk/device_imapable', 'Travis')
-      def unsubscribe_service_hook(repo, service_name)
-        topic = "#{Octokit.web_endpoint}#{Repository.new(repo)}/events/push"
-        callback = "github://#{service_name}"
-        unsubscribe(topic, callback)
-      end
-
-      private
-
-      def pub_sub_hubbub_request(options = {})
-        # This method is janky, bypass normal stack so we don't
-        # serialize request as JSON
-        conn = Faraday.new(url: @api_endpoint) do |http|
-          http.headers[:user_agent] = user_agent
-          if basic_authenticated?
-            http.request(*FARADAY_BASIC_AUTH_KEYS, @login, @password)
-          elsif token_authenticated?
-            http.request :authorization, 'token', @access_token
-          end
-          http.request :url_encoded
-          http.use Octokit::Response::RaiseError
-          http.adapter Faraday.default_adapter
-        end
-
-        conn.post do |req|
-          req.url 'hub'
-          req.headers['Content-Type'] = 'application/x-www-form-urlencoded'
-          req.body = options
-        end
-      end
-    end
-  end
-end