mux_ruby 3.11.1 → 3.12.0

data/vendor/bundle/ruby/3.2.0/gems/typhoeus-1.4.1/lib/typhoeus/easy_factory.rb

@@ -0,0 +1,206 @@
+require 'set'
+
+module Typhoeus
+
+  # This is a Factory for easies to be used in the hydra.
+  # Before an easy is ready to be added to a multi the
+  # on_complete callback to be set.
+  # This is done by this class.
+  #
+  # @api private
+  class EasyFactory
+
+    RENAMED_OPTIONS =  {
+          :auth_method => :httpauth,
+          :connect_timeout => :connecttimeout,
+          :encoding => :accept_encoding,
+          :follow_location => :followlocation,
+          :max_redirects => :maxredirs,
+          :proxy_type => :proxytype,
+          :ssl_cacert => :cainfo,
+          :ssl_capath => :capath,
+          :ssl_cert => :sslcert,
+          :ssl_cert_type => :sslcerttype,
+          :ssl_key => :sslkey,
+          :ssl_key_password => :keypasswd,
+          :ssl_key_type => :sslkeytype,
+          :ssl_version => :sslversion,
+      }
+
+    CHANGED_OPTIONS =  {
+          :disable_ssl_host_verification => :ssl_verifyhost,
+          :disable_ssl_peer_verification => :ssl_verifypeer,
+          :proxy_auth_method => :proxyauth,
+      }
+
+    REMOVED_OPTIONS =  Set.new([:cache_key_basis, :cache_timeout, :user_agent])
+
+    SANITIZE_IGNORE  = Set.new([:method, :cache_ttl, :cache])
+    SANITIZE_TIMEOUT = Set.new([:timeout_ms, :connecttimeout_ms])
+
+    # Returns the request provided.
+    #
+    # @return [ Typhoeus::Request ]
+    attr_reader :request
+
+    # Returns the hydra provided.
+    #
+    # @return [ Typhoeus::Hydra ]
+    attr_reader :hydra
+
+    # Create an easy factory.
+    #
+    # @example Create easy factory.
+    #   Typhoeus::Hydra::EasyFactory.new(request, hydra)
+    #
+    # @param [ Request ] request The request to build an easy for.
+    # @param [ Hydra ] hydra The hydra to build an easy for.
+    def initialize(request, hydra = nil)
+      @request = request
+      @hydra = hydra
+    end
+
+    # Return the easy in question.
+    #
+    # @example Return easy.
+    #   easy_factory.easy
+    #
+    # @return [ Ethon::Easy ] The easy.
+    def easy
+      @easy ||= Typhoeus::Pool.get
+    end
+
+    # Fabricated easy.
+    #
+    # @example Prepared easy.
+    #   easy_factory.get
+    #
+    # @return [ Ethon::Easy ] The easy.
+    def get
+      begin
+        read_callback_body = request.options.delete(:set_read_callback)
+
+        easy.http_request(
+          request.base_url.to_s,
+          request.options.fetch(:method, :get),
+          sanitize(request.options)
+        )
+
+        # this needs to happen after http_request because
+        # ethon will set infilesize to zero if form.empty?
+        set_read_callback(read_callback_body) if !read_callback_body.nil?
+      rescue Ethon::Errors::InvalidOption => e
+        help = provide_help(e.message.match(/:\s(\w+)/)[1])
+        raise $!, "#{$!}#{help}", $!.backtrace
+      end
+      set_callback
+      easy
+    end
+
+    private
+
+    def sanitize(options)
+      # set nosignal to true by default
+      # this improves thread safety and timeout behavior
+      sanitized = {:nosignal => true}
+      options.each do |k,v|
+        s = k.to_sym
+        next if SANITIZE_IGNORE.include?(s)
+        if new_option = RENAMED_OPTIONS[k.to_sym]
+          warn("Deprecated option #{k}. Please use #{new_option} instead.")
+          sanitized[new_option] = v
+        # sanitize timeouts
+        elsif SANITIZE_TIMEOUT.include?(s)
+          if !v.integer?
+            warn("Value '#{v}' for option '#{k}' must be integer.")
+          end
+          sanitized[k] = v.ceil
+        else
+          sanitized[k] = v
+        end
+      end
+
+      sanitize_timeout!(sanitized, :timeout)
+      sanitize_timeout!(sanitized, :connecttimeout)
+
+      sanitized
+    end
+
+    def sanitize_timeout!(options, timeout)
+      timeout_ms = :"#{timeout}_ms"
+      if options[timeout] && options[timeout].round != options[timeout]
+        if !options[timeout_ms]
+          options[timeout_ms] = (options[timeout]*1000).ceil
+        end
+        options[timeout] = options[timeout].ceil
+      end
+      options
+    end
+
+    # Sets on_complete callback on easy in order to be able to
+    # track progress.
+    #
+    # @example Set callback.
+    #   easy_factory.set_callback
+    #
+    # @return [ Ethon::Easy ] The easy.
+    def set_callback
+      if request.streaming?
+        response = nil
+        easy.on_headers do |easy|
+          response = Response.new(Ethon::Easy::Mirror.from_easy(easy).options)
+          request.execute_headers_callbacks(response)
+        end
+        request.on_body.each do |callback|
+          easy.on_body do |chunk, easy|
+            callback.call(chunk, response)
+          end
+        end
+      else
+        easy.on_headers do |easy|
+          request.execute_headers_callbacks(Response.new(Ethon::Easy::Mirror.from_easy(easy).options))
+        end
+      end
+      request.on_progress.each do |callback|
+        easy.on_progress do |dltotal, dlnow, ultotal, ulnow, easy|
+          callback.call(dltotal, dlnow, ultotal, ulnow, response)
+        end
+      end
+      easy.on_complete do |easy|
+        request.finish(Response.new(easy.mirror.options))
+        Typhoeus::Pool.release(easy)
+        if hydra && !hydra.queued_requests.empty?
+          hydra.dequeue_many
+        end
+      end
+    end
+
+    # Sets up an easy upload with CURLOPT_READFUNCTION
+    # along with CURLOPT_INFILESIZE_LARGE and CURLOPT_UPLOAD
+    #
+    # @param [ String/File ] body The body read by the readfunction.
+    #
+    # @return [ Ethon::Easy ] The easy.
+    def set_read_callback(body)
+      easy.infilesize_large =
+        if body.respond_to?(:bytesize)
+          body.bytesize
+        elsif body.respond_to?(:size)
+          body.size
+        end
+
+      easy.upload = true
+      easy.set_read_callback(body)
+
+      easy
+    end
+
+    def provide_help(option)
+      if new_option = CHANGED_OPTIONS[option.to_sym]
+        "\nPlease try #{new_option} instead of #{option}." if new_option
+      elsif REMOVED_OPTIONS.include?(option.to_sym)
+        "\nThe option #{option} was removed."
+      end
+    end
+  end
+end

data/vendor/bundle/ruby/3.2.0/gems/typhoeus-1.4.1/lib/typhoeus/request.rb

@@ -0,0 +1,223 @@
+require 'zlib'
+require 'digest/sha1'
+require 'typhoeus/request/actions'
+require 'typhoeus/request/before'
+require 'typhoeus/request/block_connection'
+require 'typhoeus/request/cacheable'
+require 'typhoeus/request/callbacks'
+require 'typhoeus/request/marshal'
+require 'typhoeus/request/memoizable'
+require 'typhoeus/request/operations'
+require 'typhoeus/request/responseable'
+require 'typhoeus/request/streamable'
+require 'typhoeus/request/stubbable'
+
+module Typhoeus
+
+  # This class represents a request.
+  #
+  # @example (see #initialize)
+  #
+  # @example Make a request with the shortcut.
+  #   response = Typhoeus.get("www.example.com")
+  #
+  # @see (see #initialize)
+  class Request
+    extend  Request::Actions
+    include Request::Callbacks::Types
+    include Request::Callbacks
+    include Request::Streamable
+    include Request::Marshal
+    include Request::Operations
+    include Request::Responseable
+    include Request::Memoizable
+    include Request::Cacheable
+    include Request::BlockConnection
+    include Request::Stubbable
+    include Request::Before
+
+    # Returns the provided base url.
+    #
+    # @return [ String ]
+    attr_accessor :base_url
+
+    # Returns options, which includes default parameters.
+    #
+    # @return [ Hash ]
+    attr_accessor :options
+
+    # Returns the hydra in which the request ran, if any.
+    #
+    # @return [ Typhoeus::Hydra ]
+    #
+    # @api private
+    attr_accessor :hydra
+
+    # Returns the original options provided.
+    #
+    # @return [ Hash ]
+    #
+    # @api private
+    attr_accessor :original_options
+
+    # @return [ Boolean ]
+    #
+    # @api private
+    attr_accessor :block_connection
+
+    # Creates a new request.
+    #
+    # @example Simplest request.
+    #   response = Typhoeus::Request.new("www.example.com").run
+    #
+    # @example Request with url parameters.
+    #   response = Typhoeus::Request.new(
+    #     "www.example.com",
+    #     params: {a: 1}
+    #   ).run
+    #
+    # @example Request with a body.
+    #   response = Typhoeus::Request.new(
+    #     "www.example.com",
+    #     body: {b: 2}
+    #   ).run
+    #
+    # @example Request with parameters and body.
+    #   response = Typhoeus::Request.new(
+    #     "www.example.com",
+    #     params: {a: 1},
+    #     body: {b: 2}
+    #   ).run
+    #
+    # @example Create a request and allow follow redirections.
+    #   response = Typhoeus::Request.new(
+    #     "www.example.com",
+    #     followlocation: true
+    #   ).run
+    #
+    # @param [ String ] base_url The url to request.
+    # @param [ options ] options The options.
+    #
+    # @option options [ Hash ] :params Translated
+    #   into url parameters.
+    # @option options [ Hash ] :body Translated
+    #   into HTTP POST request body.
+    #
+    # @return [ Typhoeus::Request ] The request.
+    #
+    # @note See {http://rubydoc.info/github/typhoeus/ethon/Ethon/Easy/Options Ethon::Easy::Options} for more options.
+    #
+    # @see Typhoeus::Hydra
+    # @see Typhoeus::Response
+    # @see Typhoeus::Request::Actions
+    def initialize(base_url, options = {})
+      @base_url = base_url
+      @original_options = options
+      @options = options.dup
+
+      set_defaults
+    end
+
+    # Return the url.
+    # In contrast to base_url which returns the value you specified, url returns
+    # the full url including the parameters.
+    #
+    # @example Get the url.
+    #   request.url
+    #
+    # @since 0.5.5
+    def url
+      easy = EasyFactory.new(self).get
+      url = easy.url
+      Typhoeus::Pool.release(easy)
+      url
+    end
+
+    # Returns whether other is equal to self.
+    #
+    # @example Are request equal?
+    #   request.eql?(other_request)
+    #
+    # @param [ Object ] other The object to check.
+    #
+    # @return [ Boolean ] Returns true if equal, else false.
+    #
+    # @api private
+    def eql?(other)
+      self.class == other.class &&
+        self.base_url == other.base_url &&
+        fuzzy_hash_eql?(self.options, other.options)
+    end
+
+    # Overrides Object#hash.
+    #
+    # @return [ Integer ] The integer representing the request.
+    #
+    # @api private
+    def hash
+      Zlib.crc32 cache_key
+    end
+
+    # Returns a cache key for use with caching methods that required a string
+    # for a key. Will get used by ActiveSupport::Cache stores automatically.
+    #
+    # @return [ String ] The cache key.
+    def cache_key
+      Digest::SHA1.hexdigest "#{self.class.name}#{base_url}#{hashable_string_for(options)}"
+    end
+
+    # Mimics libcurls POST body generation. This is not accurate, but good
+    # enough for VCR.
+    #
+    # @return [ String ] The encoded body.
+    #   otherwise.
+    #
+    # @api private
+    def encoded_body
+      Ethon::Easy::Form.new(nil, options[:body]).to_s
+    end
+
+    private
+
+    # Checks if two hashes are equal or not, discarding
+    # first-level hash order.
+    #
+    # @param [ Hash ] left
+    # @param [ Hash ] right hash to check for equality
+    #
+    # @return [ Boolean ] Returns true if hashes have
+    #   same values for same keys and same length,
+    #   even if the keys are given in a different order.
+    def fuzzy_hash_eql?(left, right)
+      return true if (left == right)
+
+      (left.count == right.count) && left.inject(true) do |res, kvp|
+        res && (kvp[1] == right[kvp[0]])
+      end
+    end
+
+    def hashable_string_for(obj)
+      case obj
+      when Hash
+        hashable_string_for(obj.sort_by {|sub_obj| sub_obj.first.to_s})
+      when Array
+        obj.map {|sub_obj| hashable_string_for(sub_obj)}.to_s
+      else
+        obj.to_s
+      end
+    end
+
+    # Sets default header and verbose when turned on.
+    def set_defaults
+      default_user_agent = Config.user_agent || Typhoeus::USER_AGENT
+
+      options[:headers] = {'User-Agent' => default_user_agent}.merge(options[:headers] || {})
+      options[:headers]['Expect'] ||= ''
+      options[:verbose] = Typhoeus::Config.verbose if options[:verbose].nil? && !Typhoeus::Config.verbose.nil?
+      options[:timeout] = Typhoeus::Config.timeout if options[:timeout].nil? && !Typhoeus::Config.timeout.nil?
+      options[:connecttimeout] = Typhoeus::Config.connecttimeout if options[:connecttimeout].nil? && !Typhoeus::Config.connecttimeout.nil?
+      options[:maxredirs] ||= 50
+      options[:proxy] = Typhoeus::Config.proxy unless options.has_key?(:proxy) || Typhoeus::Config.proxy.nil?
+    end
+  end
+end