ethon-impersonate 0.17.2-aarch64-darwin

data/lib/ethon_impersonate/multi.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+require 'ethon_impersonate/easy/util'
+require 'ethon_impersonate/multi/stack'
+require 'ethon_impersonate/multi/operations'
+require 'ethon_impersonate/multi/options'
+
+module EthonImpersonate
+
+  # This class represents libcurl multi.
+  class Multi
+    include EthonImpersonate::Multi::Stack
+    include EthonImpersonate::Multi::Operations
+    include EthonImpersonate::Multi::Options
+
+    # Create a new multi. Initialize curl in case
+    # it didn't happen before.
+    #
+    # @example Create a new Multi.
+    #   Multi.new
+    #
+    # @param [ Hash ] options The options.
+    #
+    # @option options :socketdata [String]
+    #  Pass a pointer to whatever you want passed to the
+    #  curl_socket_callback's forth argument, the userp pointer. This is not
+    #  used by libcurl but only passed-thru as-is. Set the callback pointer
+    #  with CURLMOPT_SOCKETFUNCTION.
+    # @option options :pipelining [Boolean]
+    #  Pass a long set to 1 to enable or 0 to disable. Enabling pipelining
+    #  on a multi handle will make it attempt to perform HTTP Pipelining as
+    #  far as possible for transfers using this handle. This means that if
+    #  you add a second request that can use an already existing connection,
+    #  the second request will be "piped" on the same connection rather than
+    #  being executed in parallel. (Added in 7.16.0)
+    # @option options :timerfunction [Proc]
+    #  Pass a pointer to a function matching the curl_multi_timer_callback
+    #  prototype. This function will then be called when the timeout value
+    #  changes. The timeout value is at what latest time the application
+    #  should call one of the "performing" functions of the multi interface
+    #  (curl_multi_socket_action(3) and curl_multi_perform(3)) - to allow
+    #  libcurl to keep timeouts and retries etc to work. A timeout value of
+    #  -1 means that there is no timeout at all, and 0 means that the
+    #  timeout is already reached. Libcurl attempts to limit calling this
+    #  only when the fixed future timeout time actually changes. See also
+    #  CURLMOPT_TIMERDATA. This callback can be used instead of, or in
+    #  addition to, curl_multi_timeout(3). (Added in 7.16.0)
+    # @option options :timerdata [String]
+    #  Pass a pointer to whatever you want passed to the
+    #  curl_multi_timer_callback's third argument, the userp pointer. This
+    #  is not used by libcurl but only passed-thru as-is. Set the callback
+    #  pointer with CURLMOPT_TIMERFUNCTION. (Added in 7.16.0)
+    # @option options :maxconnects [Integer]
+    #  Pass a long. The set number will be used as the maximum amount of
+    #  simultaneously open connections that libcurl may cache. Default is
+    #  10, and libcurl will enlarge the size for each added easy handle to
+    #  make it fit 4 times the number of added easy handles.
+    #  By setting this option, you can prevent the cache size from growing
+    #  beyond the limit set by you.
+    #  When the cache is full, curl closes the oldest one in the cache to
+    #  prevent the number of open connections from increasing.
+    #  This option is for the multi handle's use only, when using the easy
+    #  interface you should instead use the CURLOPT_MAXCONNECTS option.
+    #  (Added in 7.16.3)
+    # @option options :max_total_connections [Integer]
+    # Pass a long. The set number will be used as the maximum amount of 
+    # simultaneously open connections in total. For each new session, 
+    # libcurl will open a new connection up to the limit set by 
+    # CURLMOPT_MAX_TOTAL_CONNECTIONS. When the limit is reached, the 
+    # sessions will be pending until there are available connections. 
+    # If CURLMOPT_PIPELINING is 1, libcurl will try to pipeline if the host 
+    # is capable of it.
+    # The default value is 0, which means that there is no limit. However, 
+    # for backwards compatibility, setting it to 0 when CURLMOPT_PIPELINING 
+    # is 1 will not be treated as unlimited. Instead it will open only 1 
+    # connection and try to pipeline on it.
+    # (Added in 7.30.0)
+    # @option options :execution_mode [Boolean]
+    #  Either :perform (default) or :socket_action, specifies the usage
+    #  method that will be used on this multi object. The default :perform
+    #  mode provides a #perform function that uses curl_multi_perform
+    #  behind the scenes to automatically continue execution until all
+    #  requests have completed. The :socket_action mode provides an API
+    #  that allows the {Multi} object to be integrated into an external
+    #  IO loop, by calling #socket_action and responding to the 
+    #  socketfunction and timerfunction callbacks, using the underlying
+    #  curl_multi_socket_action semantics.
+    #
+    # @return [ Multi ] The new multi.
+    def initialize(options = {})
+      Curl.init
+      @execution_mode = options.delete(:execution_mode) || :perform
+      set_attributes(options)
+      init_vars
+    end
+
+    # Set given options.
+    #
+    # @example Set options.
+    #   multi.set_attributes(options)
+    #
+    # @raise InvalidOption
+    #
+    # @see initialize
+    #
+    # @api private
+    def set_attributes(options)
+      options.each_pair do |key, value|
+        unless respond_to?("#{key}=")
+          raise Errors::InvalidOption.new(key)
+        end
+        method("#{key}=").call(value)
+      end
+    end
+
+    private
+
+    # Internal function to gate functions to a specific execution mode
+    #
+    # @raise ArgumentError
+    #
+    # @api private
+    def ensure_execution_mode(expected_mode)
+      raise ArgumentError, "Expected the Multi to be in #{expected_mode} but it was in #{@execution_mode}" if expected_mode != @execution_mode
+    end
+  end
+end

data/lib/ethon_impersonate/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+module EthonImpersonate
+
+  # EthonImpersonate version.
+  VERSION = "0.17.2"
+end

data/lib/ethon_impersonate.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+require 'logger'
+require 'ffi'
+require 'thread'
+begin
+  require 'mime/types/columnar'
+rescue LoadError
+  begin
+    require 'mime/types'
+  rescue LoadError
+  end
+end
+require 'tempfile'
+
+require 'ethon_impersonate/libc'
+require 'ethon_impersonate/curl'
+require 'ethon_impersonate/easy'
+require 'ethon_impersonate/errors'
+require 'ethon_impersonate/loggable'
+require 'ethon_impersonate/multi'
+require 'ethon_impersonate/impersonate'
+require 'ethon_impersonate/version'
+
+# EthonImpersonate is a very simple curl-impersonate wrapper.
+# It provides direct access to libcurl functionality
+# as well as some helpers for doing http requests.
+module EthonImpersonate
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: ethon-impersonate
+version: !ruby/object:Gem::Version
+  version: 0.17.2
+platform: aarch64-darwin
+authors:
+- David Sojevic
+- Hans Hasselberg
+bindir: bin
+cert_chain: []
+date: 2025-04-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+description: Realistic browser-like HTTP requests using curl-impersonate's impersonation
+  capabilities.
+email:
+- david@sojevic.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- config/puma.rb
+- ethon-impersonate.gemspec
+- ext/libcurl-impersonate.4.dylib
+- lib/ethon-impersonate.rb
+- lib/ethon/impersonate.rb
+- lib/ethon_impersonate.rb
+- lib/ethon_impersonate/curl.rb
+- lib/ethon_impersonate/curls/classes.rb
+- lib/ethon_impersonate/curls/codes.rb
+- lib/ethon_impersonate/curls/constants.rb
+- lib/ethon_impersonate/curls/form_options.rb
+- lib/ethon_impersonate/curls/functions.rb
+- lib/ethon_impersonate/curls/infos.rb
+- lib/ethon_impersonate/curls/messages.rb
+- lib/ethon_impersonate/curls/options.rb
+- lib/ethon_impersonate/curls/settings.rb
+- lib/ethon_impersonate/easy.rb
+- lib/ethon_impersonate/easy/callbacks.rb
+- lib/ethon_impersonate/easy/debug_info.rb
+- lib/ethon_impersonate/easy/features.rb
+- lib/ethon_impersonate/easy/form.rb
+- lib/ethon_impersonate/easy/header.rb
+- lib/ethon_impersonate/easy/http.rb
+- lib/ethon_impersonate/easy/http/actionable.rb
+- lib/ethon_impersonate/easy/http/custom.rb
+- lib/ethon_impersonate/easy/http/delete.rb
+- lib/ethon_impersonate/easy/http/get.rb
+- lib/ethon_impersonate/easy/http/head.rb
+- lib/ethon_impersonate/easy/http/options.rb
+- lib/ethon_impersonate/easy/http/patch.rb
+- lib/ethon_impersonate/easy/http/post.rb
+- lib/ethon_impersonate/easy/http/postable.rb
+- lib/ethon_impersonate/easy/http/put.rb
+- lib/ethon_impersonate/easy/http/putable.rb
+- lib/ethon_impersonate/easy/informations.rb
+- lib/ethon_impersonate/easy/mirror.rb
+- lib/ethon_impersonate/easy/operations.rb
+- lib/ethon_impersonate/easy/options.rb
+- lib/ethon_impersonate/easy/params.rb
+- lib/ethon_impersonate/easy/queryable.rb
+- lib/ethon_impersonate/easy/response_callbacks.rb
+- lib/ethon_impersonate/easy/util.rb
+- lib/ethon_impersonate/errors.rb
+- lib/ethon_impersonate/errors/ethon_error.rb
+- lib/ethon_impersonate/errors/global_init.rb
+- lib/ethon_impersonate/errors/invalid_option.rb
+- lib/ethon_impersonate/errors/invalid_value.rb
+- lib/ethon_impersonate/errors/multi_add.rb
+- lib/ethon_impersonate/errors/multi_fdset.rb
+- lib/ethon_impersonate/errors/multi_remove.rb
+- lib/ethon_impersonate/errors/multi_timeout.rb
+- lib/ethon_impersonate/errors/select.rb
+- lib/ethon_impersonate/impersonate.rb
+- lib/ethon_impersonate/impersonate/fingerprints.rb
+- lib/ethon_impersonate/impersonate/settings.rb
+- lib/ethon_impersonate/impersonate/targets.rb
+- lib/ethon_impersonate/impersonate/tls.rb
+- lib/ethon_impersonate/libc.rb
+- lib/ethon_impersonate/loggable.rb
+- lib/ethon_impersonate/multi.rb
+- lib/ethon_impersonate/multi/operations.rb
+- lib/ethon_impersonate/multi/options.rb
+- lib/ethon_impersonate/multi/stack.rb
+- lib/ethon_impersonate/version.rb
+homepage: https://github.com/dsojevic/ethon-impersonate
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Impersonate browser-like HTTP requests.
+test_files: []