ethon-impersonate 0.17.10-x86_64-darwin-24

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 15ec8cad2bc555434a7852ad25547c1d9f8c4e2940c41811790777e22044a6c3
+  data.tar.gz: 20aa79252a2079229df35d19a0bef0e819a29c398779b5dd832851f508399efb
+SHA512:
+  metadata.gz: 48219405d85223625bf14c6e51caa7a85b7a97c44b2c06e1a0c6c698b25d17378f6171fd3d6836de264e2face266daabe5c8044e28c7526d8ce73f2b8300cd7a
+  data.tar.gz: 9959463e6060e87857218e01767db283f6d348728a22f2d3f997c4208fe479673960b8b0f1cf106d04bee0da25819e0d23eaa9e8751a7fbd422196835035fa3e

data/CHANGELOG.md

@@ -0,0 +1,391 @@
+# Changelog
+
+## Master
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.17.9...master)
+
+## 0.17.9
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.17.8...v0.17.9)
+
+* Bumped [`curl-impersonate`](https://github.com/lexiforest/curl-impersonate) to `v1.0.0`
+
+## 0.17.8
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.16.0...v0.17.8)
+
+* Added basic support for [`curl-impersonate`](https://github.com/lexiforest/curl-impersonate) @ `v1.0.0rc1`
+
+## 0.16.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.15.0...v0.16.0)
+
+* Added `redirect_url` value to available informations and `Easy::Mirror`.
+  ([Adrien Rey-Jarthon](https://github.com/jarthod)
+
+## 0.15.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.14.0...v0.15.0)
+
+## 0.12.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.11.0...v0.12.0)
+
+- Removed deprecated `CURLE_SSL_CACERT` pinned in curl v7.62.0 ([@arku](https://github.com/arku) in [#158](https://github.com/serpapi/ethon-impersonate/pull/158))
+
+
+## 0.11.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.10.1...v0.11.0)
+
+## 0.10.1
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.10.0...v0.10.1)
+
+## 0.10.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.9.1...v0.10.0)
+
+## 0.9.1
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.9.0...v0.9.1)
+
+## 0.9.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.8.1...v0.9.0)
+
+## 0.8.1
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.8.0...v0.8.1)
+
+* Support optional escaping of params.
+  ([Tasos Laskos](https://github.com/zapotek)
+* `Easy::Mirror`: Reduced object allocations and method calls during info handling.
+  ([Tasos Laskos](https://github.com/zapotek)
+
+## 0.8.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.7.3...v0.7.4)
+
+* `Easy::Mirror`: Reduced object allocations and method calls during info handling.
+  ([Tasos Laskos](https://github.com/zapotek)
+
+## 0.7.4
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.7.3...v0.7.4)
+
+* Support different array encodings for params.
+  ([Marcello Barnaba](https://github.com/ifad), [\#104](https://github.com/serpapi/ethon-impersonate/pull/104))
+* Programtic access to version infos.
+  ([Jonas Wagner](https://github.com/jwagner), [\#90](https://github.com/serpapi/ethon-impersonate/pull/90))
+
+
+## 0.7.3
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.7.2...v0.7.3)
+
+* `EthonImpersonate::Curl::FDSet`
+    * Set `:fd_array` size to the current MS Windows `FD_SETSIZE` (2048).
+        ([Tasos Laskos](https://github.com/zapotek)
+
+* Added `redirect_time` value to available informations and `Easy::Mirror`.
+  ([Adrien Jarthon](https://github.com/jarthod)
+
+## 0.7.2
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.7.1...v0.7.2)
+
+* FFI data-types updated to be more correct.
+
+## 0.7.1
+
+* MS Windows determination delegated to `Gem.windows?` for better accuracy.
+* FFI data-types updated to work on MS Windows.
+
+## 0.7.0
+
+Not backwards compatible changes:
+
+* `mime-types` are no longer a dependency. The gem will be still used if available to determine the mime type of a file which is uploaded. That means you have to have take care of the gem installation yourself.
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.6.3...v0.7.0)
+
+## 0.6.3
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.6.2...v0.6.3)
+
+## 0.6.2
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.6.1...v0.6.2)
+
+## 0.6.1
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.6.0...v0.6.1)
+
+The changelog entries are coming soon!
+
+## 0.6.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.12...v0.6.0)
+
+The changelog entries are coming soon!
+
+Bugfixes:
+
+  * URL-encode nullbytes in parameters instead of escaping them to `\\0`.
+    ([Tasos Laskos](https://github.com/zapotek)
+
+## 0.5.12
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.11...v0.5.12)
+
+Enhancements:
+
+* Performance optimizations.
+  ([Kyle Oppenheim](https://github.com/koppenheim) and [Richie Vos](https://github.com/richievos), [\#48](https://github.com/serpapi/ethon-impersonate/pull/48))
+* Reuse memory pointer.
+  ([Richie Vos](https://github.com/richievos), [\#49](https://github.com/serpapi/ethon-impersonate/pull/49))
+
+Bugfixes:
+
+* Fix windows install.
+  ([Derik Olsson](https://github.com/derikolsson), [\#47](https://github.com/serpapi/ethon-impersonate/pull/47))
+* Handle urls that already contain query params.
+  ([Turner King](https://github.com/turnerking ), [\#45](https://github.com/serpapi/ethon-impersonate/pull/45))
+
+## 0.5.11
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.10...v0.5.11)
+
+Enhancements:
+
+* Add support for postredirs, unrestricted_auth.
+* Add support for cookie, cookiejar, cookiefile.
+  ([erwanlr](https://github.com/erwanlr), [\#46](https://github.com/serpapi/ethon-impersonate/pull/46))
+* Relax ffi requirements.
+  ([voxik](https://github.com/voxik), [\#40](https://github.com/serpapi/ethon-impersonate/pull/40))
+* Various documentation improvements.
+  ([Craig Little](https://github.com/craiglittle))
+
+Bugfixes:
+
+* Fix the memory leaks.
+  ([Richie Vos](https://github.com/richievos), [\#45](https://github.com/serpapi/ethon-impersonate/pull/45))
+
+## 0.5.10
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.9...v0.5.10)
+
+Enhancements:
+
+* Allow custom requests.
+  ([Nathan Sutton](https://github.com/nate), [\#36](https://github.com/serpapi/ethon-impersonate/pull/36))
+* Use updated version of FFI.
+
+Bugfixes:
+
+* Fix windows install issue.
+  ([brainsucker](https://github.com/brainsucker), [\#38](https://github.com/serpapi/ethon-impersonate/pull/38))
+
+## 0.5.9
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.8...v0.5.9)
+
+Enhancements:
+
+* Allow to set multiple protocols.
+
+## 0.5.8
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.7...v0.5.8)
+
+Enhancements:
+
+* Add support for protocols and redir_protocols(
+  [libcurl SASL buffer overflow vulnerability](http://curl.haxx.se/docs/adv_20130206.html)).
+* Add max_send_speed_large and max_recv_speed_large([Paul Schuegraf](https://github.com/pschuegr), [\#33](https://github.com/serpapi/ethon-impersonate/pull/33))
+
+## 0.5.7
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.6...v0.5.7)
+
+Enhancements:
+
+* Use new version of ffi.
+
+## 0.5.6
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.4...v0.5.6)
+
+Bugfixes:
+
+* Easy#reset resets on_complete callbacks.
+
+## 0.5.4
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.3...v0.5.4)
+
+Enhancements:
+
+* Use Libc#getdtablesize to get the FDSet size.
+* New libcurl option accept_encoding.
+* Documentation updates.
+
+## 0.5.3
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.2...v0.5.3)
+
+Enhancements:
+
+* Deprecate Easy#prepare. It is no longer necessary.
+* Unroll metaprogramming for easy and multi options.
+* More specs.
+
+Bugfixes:
+
+* Correct size for FDSets
+* Add proxytypes to enums.
+
+## 0.5.2
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.1...v0.5.2)
+
+Enhancements:
+
+* New libcurl option keypasswd.
+
+Bugfixes:
+
+* Correct request logging when using multi interface.
+* Remove invalid libcurl option sslcertpasswd.
+
+## 0.5.1
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.5.0...v0.5.1)
+
+Bugfixes:
+
+* Mark Curl.select and Curl.easy_perform as blocking so that the GIL is
+  released by ffi.
+
+## 0.5.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.4.4...v0.5.0)
+
+Enhancements:
+
+* New libcurl option proxyuserpwd
+* Rename response_header to response_headers
+
+Bugfixes:
+
+* Mark Curl.select and Curl.easy_perform as blocking so that the GIL is
+  released by ffi.
+
+## 0.4.4
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.4.3...v0.4.4)
+
+Enhancements:
+
+* Prepare multi explicit like easy
+
+## 0.4.3
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.4.2...v0.4.3)
+
+Enhancements:
+
+* Remove deprecated libcurl option put
+* More documentation
+* New libcurl option connecttimeout_ms and timeout_ms
+* Support multi options
+
+Bugfixes:
+
+* Handle nil values in query params
+
+## 0.4.2
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.4.1...v0.4.2)
+
+Enhancements:
+
+* New libcurl option forbid_reuse
+* Use libcurls escape instead of CGI::escape
+
+## 0.4.1
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.4.0...v0.4.1)
+
+Bugfixes:
+
+* Handle nested hash in an array in params correct
+  ( [\#201](https://github.com/typhoeus/typhoeus/issues/201) )
+
+## 0.4.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.3.0...v0.4.0)
+
+Enhancements:
+
+* ruby 1.8.7 compatible
+* EthonImpersonate.logger
+* Deal with string param/body
+* More documentation
+
+Bugfixes:
+
+* Add multi_cleanup to curl
+
+## 0.3.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.2.0...v0.3.0)
+
+Enhancements:
+
+* New libcurl option proxyport
+* Raise invalid value error when providing a wrong key for sslversion or httpauth
+
+Bugfixes:
+
+* Libcurl option sslversion is handled correct
+
+## 0.2.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.1.0...v0.2.0)
+
+Enhancements:
+
+* GET requests are using custom requests only when there is a request body
+* Easy#on_complete takes multiple callbacks
+* raise Errors::GlobalInit when libcurls global_init failed instead of
+  runtime error
+* raise Errors::InvalidOption if option is invalid
+
+## 0.1.0
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.0.2...v0.1.0)
+
+Enhancements:
+
+* Documentation
+  ( [Alex P](https://github.com/ifesdjeen), [\#13](https://github.com/typhoeus/ethon/issues/13) )
+* New libcurl option dns_cache_timeout
+  ( [Chris Heald](https://github.com/cheald), [\#192](https://github.com/typhoeus/typhoeus/pull/192) )
+
+Bugfixes:
+
+* Libcurl option ssl_verifyhost takes an integer.
+* Add space between header key and value.
+
+## 0.0.2
+
+[Full Changelog](https://github.com/serpapi/ethon-impersonate/compare/v0.0.1...v0.0.2)
+
+Bugfixes:
+
+* Add libcurl.so.4 to ffi_lib in order to load correct lib on Debian.
+* Escape zero bytes.
+
+## 0.0.1 Initial version

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2025 SerpApi
+Copyright (c) 2012-2016 Hans Hasselberg
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,164 @@
+
+
+#  Ethon Impersonate ![Chrome](https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome_24x24.png "Chrome") ![Edge](https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_24x24.png "Edge") ![Safari](https://raw.githubusercontent.com/alrra/browser-logos/main/src/safari/safari_24x24.png "Safari") ![Firefox](https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_24x24.png "Firefox") ![Tor](https://raw.githubusercontent.com/alrra/browser-logos/main/src/tor/tor_24x24.png "Tor")
+
+[![Gem Version](https://badge.fury.io/rb/ethon-impersonate.svg)](https://badge.fury.io/rb/ethon-impersonate)
+[![Build Status](https://github.com/serpapi/ethon-impersonate/workflows/Ruby/badge.svg)](https://github.com/serpapi/ethon-impersonate/actions/workflows/ruby.yml)
+
+**Ethon Impersonate** is a fork of [Ethon](https://github.com/typhoeus/ethon) that wraps [libcurl-impersonate](https://github.com/lexiforest/curl-impersonate).
+
+In Greek mythology, Ethon, the son of Typhoeus and Echidna, is a gigantic eagle. So much for the history.
+
+This allows you to make HTTP requests that appear to come from real browsers, helping to bypass bot detection and fingerprinting.
+
+## Installation
+
+With bundler:
+```bash
+gem "ethon-impersonate"
+```
+
+With rubygems:
+```bash
+gem install ethon-impersonate
+```
+
+## Dependencies
+On MacOS Apple Silicon, you need to install the following dependencies using Homebrew:
+
+```bash
+brew install libidn2 rtmpdump zstd
+```
+
+Note: Homebrew must be loaded in the same arch than the Ruby interpreter. If you are using `arch -x86_64` to run Ruby, you must also run Homebrew with `arch -x86_64 brew install ...`.
+
+## Usage
+
+Making the first request is simple:
+
+```ruby
+easy = EthonImpersonate::Easy.new(url: "www.example.com")
+easy.perform
+#=> :ok
+```
+
+You have access to various options, such as following redirects:
+
+```ruby
+easy = EthonImpersonate::Easy.new(url: "www.example.com", followlocation: true)
+easy.perform
+#=> :ok
+```
+
+Once you're done you can inspect the response code and body:
+
+```ruby
+easy = EthonImpersonate::Easy.new(url: "www.example.com", followlocation: true)
+easy.perform
+easy.response_code
+#=> 200
+easy.response_body
+#=> "<!doctype html><html ..."
+```
+
+## Browser Impersonation
+
+The main feature of this gem is the ability to impersonate real browsers. Use the `impersonate` method to configure the request to look like it's coming from a specific browser:
+
+```ruby
+easy = EthonImpersonate::Easy.new(url: "www.example.com")
+easy.impersonate("chrome136")  # Impersonate Chrome 136
+easy.perform
+easy.response_code
+#=> 200
+```
+
+### Available Browser Targets
+
+The gem supports all browser targets available in curl-impersonate. Some popular targets include:
+
+- **Chrome**: `chrome136`, `chrome131_android`
+- **Firefox**: `firefox135`
+- **Safari**: `safari184`, `safari184_ios`
+- **Edge**: `edge101`
+- **Tor**: `tor145`
+
+For a complete list of available targets, see the [curl-impersonate bin directory](https://github.com/lexiforest/curl-impersonate/tree/main/bin).
+
+### Example with Browser Impersonation
+
+```ruby
+# Impersonate Chrome 136
+easy = EthonImpersonate::Easy.new(url: "https://tls.browserleaks.com/json")
+easy.impersonate("chrome136")
+easy.perform
+#=> :ok
+
+# Impersonate Firefox 135
+easy = EthonImpersonate::Easy.new(url: "https://tls.browserleaks.com/json")
+easy.impersonate("firefox135")
+easy.perform
+#=> :ok
+
+# Impersonate Safari 184
+easy = EthonImpersonate::Easy.new(url: "https://tls.browserleaks.com/json")
+easy.impersonate("safari184")
+easy.perform
+#=> :ok
+```
+
+## Http
+
+In order to make life easier, there are some helpers for making HTTP requests:
+
+```ruby
+easy = EthonImpersonate::Easy.new
+easy.http_request("www.example.com", :get, { params: {a: 1} })
+easy.perform
+#=> :ok
+```
+
+```ruby
+easy = EthonImpersonate::Easy.new
+easy.http_request("www.example.com", :post, { params: { a: 1 }, body: { b: 2 } })
+easy.perform
+#=> :ok
+```
+
+This is really handy when making requests since you don't have to care about setting
+everything up correctly.
+
+## Http2
+Standard http2 servers require the client to connect once and create a session (multi) and then add simple requests to the multi handler.
+The `perform` method then takes all the requests in the multi handler and sends them to the server.
+
+See the following example
+```ruby
+multi = EthonImpersonate::Multi.new
+easy = EthonImpersonate::Easy.new
+
+easy.http_request("www.example.com/get", :get, { http_version: :httpv2_0 })
+
+# Sending a request with http version 2 will send an Upgrade header to the server, which many older servers will not support
+# See below for more info: https://everything.curl.dev/http/http2
+# If this is a problem, send the below:
+easy.http_request("www.example.com/get", :get, { http_version: :httpv2_prior_knowledge })
+
+# To set the server to use http2 with https and http1 with http, send the following:
+easy.http_request("www.example.com/get", :get, { http_version: :httpv2_tls })
+
+multi.add(easy)
+multi.perform
+```
+
+## Sponsors
+
+Ethon Impersonate is maintained by **SerpApi**.
+
+Thanks to all <a href="https://github.com/serpapi/ethon-impersonate/graphs/contributors">contributors</a> of this project past and present.
+
+------
+
+<a href="https://serpapi.com/" target="_blank"><img src="https://raw.githubusercontent.com/serpapi/ethon-impersonate/master/assets/serpapi.png" alt="SerpAPI" height="67" width="63"></a>
+
+Scrape Google and other search engines from [SerpApi](https://serpapi.com/)'s fast, easy, and complete API. 0.66s average response time (≤ 0.5s for Ludicrous Speed Max accounts), 99.95% SLAs, pay for successful responses only.

data/config/puma.rb

@@ -0,0 +1 @@
+ENV['OBJC_DISABLE_INITIALIZE_FORK_SAFETY'] = 'YES'

data/ethon-impersonate.gemspec

@@ -0,0 +1,29 @@
+# encoding: utf-8
+# frozen_string_literal: true
+lib = File.expand_path("../lib/", __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+require "ethon_impersonate/version"
+
+Gem::Specification.new do |s|
+  s.name         = "ethon-impersonate"
+  s.version      = EthonImpersonate::VERSION
+  s.platform     = Gem::Platform::RUBY
+  s.authors      = ["David Sojevic", "Hans Hasselberg"]
+  s.email        = ["david@sojevic.com"]
+  s.homepage     = "https://github.com/serpapi/ethon-impersonate"
+  s.summary      = "Impersonate browser-like HTTP requests."
+  s.description  = "Realistic browser-like HTTP requests using curl-impersonate's impersonation capabilities."
+
+  s.required_ruby_version = ">= 2.7"
+  s.required_rubygems_version = ">= 1.3.6"
+  s.license = "MIT"
+
+  s.add_dependency("ffi", ["~> 1.15"])
+
+  s.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0")
+  end.reject { |file| file.start_with?(*%w[. Gemfile Guardfile Rakefile profile spec scripts assets]) || file.end_with?(".gitignore") }
+
+  s.require_path = "lib"
+end

data/lib/ethon-impersonate.rb

@@ -0,0 +1 @@
+require "ethon_impersonate"