chromedriver-binary 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e37c7672fc5a5a74432545fb3b11927e0e1a7157e4f1210a43b7116b6d78a67f
+  data.tar.gz: 3ba62d5d9a4c307623c33c53c04e9cc95e461eee852f59d3a2baf7e8da28d893
+SHA512:
+  metadata.gz: 1b9c2c0d4fec758a0f12d5e70d052e9c9dc1f20cfd5374f3feb132b884a6f56bf44a5c2db22f90b3536aeb83dfbdbc088bc2eae57994dd5820de149c1ead754f
+  data.tar.gz: 041ecdf8e7a3b39dbc870630241968f87173cd348003c2e4089fcb44dd908d4b72aade8fb964d260b44f6b5fffa27f53e9b0bd562b7602ad9ab443e3860aa4b5

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,5 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="PROJECT_PROFILE" />
+  </settings>
+</component>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,47 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.0
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+RSpec/SubjectStub:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+Layout/MultilineMethodCallIndentation:
+  Enabled: false
+
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/FirstArrayElementIndentation:
+  EnforcedStyle: consistent
+
+RSpec/MultipleMemoizedHelpers:
+  Max: 10
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Max: 10
+
+
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+
+plugins:
+  - rubocop-rake
+  - rubocop-rspec

data/.ruby-gemset

@@ -0,0 +1 @@
+chromedriver-binary

data/.ruby-version

@@ -0,0 +1 @@
+ruby-3.3.4

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-03-28
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Dieter S.
+
+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,97 @@
+# chromedriver-binary
+
+A Ruby gem that automatically downloads and installs ChromeDriver binaries that match your installed Chrome browser
+version.
+
+> Inspired by [webdrivers](https://github.com/titusfortner/webdrivers/tree/main)
+
+## Features
+
+- Automatically detects Chrome browser version
+- Downloads the matching ChromeDriver version
+- Works across Windows, macOS, and Linux platforms
+- Supports environment variable configuration
+- Minimal dependencies
+
+## Installation
+
+Add this to your application's Gemfile:
+
+```ruby
+gem 'chromedriver-binary'
+```
+
+And then execute:
+
+```shell
+$ bundle install
+```
+
+Or install it yourself:
+
+```shell
+$ gem install chromedriver-binary
+```
+
+## Usage
+
+Simply require the gem in your code:
+
+```ruby
+require 'chromedriver/binary'
+
+Chromedriver::Binary.configure do |config|
+  # default STDOUT logger
+  config.logger = logger
+
+  # Proxy default nil
+  config.proxy_addr = 'myproxy_address.com'
+  config.proxy_port = '8080'
+  config.proxy_user = 'username'
+  config.proxy_pass = 'password'
+
+  # install dir
+  config.install_dir = "/tmp" # default "~/.webdrivers"
+end
+
+Chromedriver::Binary::ChromedriverDownloader.update force: true
+
+Chromedriver::Binary::ChromedriverDownloader.driver_path
+
+```
+
+### Rake Tasks
+
+```ruby
+
+require "chromedriver/binary"
+
+load 'chromedriver/Rakefile'
+```
+
+The gem will:
+
+1. Detect your installed Chrome version
+2. Download the matching ChromeDriver binary if needed
+3. Make it available in your PATH
+
+### Configuration
+
+Use environment variables to customize behavior:
+
+- `CHROMEDRIVER_CHROME_PATH`: Specify the Chrome binary location
+- `CHROMEDRIVER_BINARY_PATH`: Override where ChromeDriver is installed
+
+## Development
+
+After checking out the repo:
+
+```shell
+$ bin/setup               # Install dependencies
+$ rake spec               # Run the tests
+$ bundle exec rake install # Install the gem locally
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]
+
+require "chromedriver/binary"
+
+load "chromedriver/Rakefile"
+
+desc "Run tests with coverage"
+task :coverage do
+  ENV["COVERAGE"] = "true"
+  Rake::Task["spec"].execute
+  puts "Coverage report generated in coverage/ directory"
+end

data/lib/chromedriver/Rakefile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "chromedriver/binary"
+
+path = File.expand_path(__dir__)
+Dir.glob("#{path}/binary/tasks/*.rake").each { |f| import f }

data/lib/chromedriver/binary/chromedriver_downloader.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require_relative "version_resolver"
+require_relative "platform"
+require_relative "downloader_helper"
+require_relative "system_helper"
+
+module Chromedriver
+  module Binary
+    class ChromedriverDownloader
+      class << self
+        include VersionResolver
+        include Platform
+        include DownloaderHelper
+        include SystemHelper
+
+        # Define where to install ChromeDriver.
+        def install_dir
+          Chromedriver::Binary.install_dir
+        end
+
+        # Returns the absolute path to the driver_path ChromeDriver binary.
+        def driver_path
+          File.absolute_path File.join(install_dir, file_name)
+        end
+
+        # Downloads and extracts the latest ChromeDriver.
+        #
+        # @return [String] the full path to the downloaded executable.
+        # rubocop:disable Metrics/AbcSize
+        def update(force: false)
+          return driver_path if up_to_date_binary?(force)
+
+          version = latest_patch_version_for_build
+          zip_filename = "chromedriver_#{platform_id}.zip"
+          zip_path = File.join(install_dir, zip_filename)
+          download_url = direct_url_from_api(version, driver_filename)
+
+          prepare_install_dir
+          log_download_start(version, download_url)
+
+          download_file(download_url, zip_path)
+          extract_zip(zip_path, install_dir)
+          make_executable(driver_path)
+          cleanup_zip(zip_path)
+
+          Chromedriver::Binary.logger.debug "ChromeDriver downloaded and extracted to #{install_dir}"
+
+          driver_path
+        end
+
+        # rubocop:enable Metrics/AbcSize
+
+        def correct_binary?
+          current_installed_version == browser_version || current_installed_version == latest_patch_version_for_build
+        rescue ConnectionError, VersionError
+          false
+        end
+
+        private
+
+        def up_to_date_binary?(force)
+          if correct_binary? && !force
+            Chromedriver::Binary.logger.debug "A working webdriver version is already on the system"
+            true
+          else
+            false
+          end
+        end
+
+        def prepare_install_dir
+          FileUtils.mkdir_p(install_dir)
+        end
+
+        def log_download_start(version, url)
+          Chromedriver::Binary.logger.debug(
+            "Downloading ChromeDriver version #{version} for #{platform_id} from #{url}..."
+          )
+        end
+
+        def make_executable(path)
+          FileUtils.chmod "ugo+rx", path
+          Chromedriver::Binary.logger.debug "Completed download and processing of #{path}"
+        end
+
+        def cleanup_zip(zip_path)
+          File.delete(zip_path)
+        end
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/download_progress.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Chromedriver
+  module Binary
+    class DownloadProgress
+      def initialize(logger:, step_bytes: 1 * 1024 * 1024)
+        # Default: 1 MB
+        @logger = logger
+        @step_bytes = step_bytes
+        @total_bytes = 0
+        @next_log_at = step_bytes
+      end
+
+      def track(chunk_size)
+        @total_bytes += chunk_size
+
+        return unless @total_bytes >= @next_log_at
+
+        mb = (@total_bytes.to_f / (1024 * 1024)).round(2)
+        @logger.debug("Downloaded ~#{mb} MB 📦")
+        @next_log_at += @step_bytes
+      end
+
+      def finish
+        mb = (@total_bytes.to_f / (1024 * 1024)).round(2)
+        @logger.info("Download complete! ✅ Total: #{mb} MB")
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/downloader_helper.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "zip"
+require "fileutils"
+
+require_relative "download_progress"
+
+module Chromedriver
+  module Binary
+    module DownloaderHelper
+      def download_file(url, destination)
+        uri = URI.parse(url)
+        logger = Chromedriver::Binary.logger
+        http = create_http(uri)
+
+        logger.debug("Saving to: #{destination}")
+
+        exec_get_request(http, uri) do |response|
+          handle_unsuccessful_response(response)
+          write_response_to_file(response, destination, logger)
+        end
+      rescue StandardError => e
+        logger.debug("Error: #{e.message}")
+        raise "Error downloading file: #{e.message}"
+      end
+
+      def exec_get_request(http, uri, &block)
+        request = Net::HTTP::Get.new(uri)
+        Chromedriver::Binary.logger.debug("Sending HTTP GET request...")
+
+        http.request(request, &block)
+      end
+
+      def extract_zip(zip_file, destination)
+        Zip::File.open(zip_file) do |zip|
+          zip.each do |entry|
+            # Extract all files as top-level (ignoring any folder structure)
+            destination_file = File.join(destination, File.basename(entry.name))
+            entry.extract(destination_file) { true }
+          end
+        end
+      rescue StandardError => e
+        raise "Error extracting ZIP file: #{e.message}"
+      end
+
+      private
+
+      def handle_unsuccessful_response(response)
+        return if response.is_a?(Net::HTTPSuccess)
+
+        raise "Download failed: #{response.code} #{response.message}"
+      end
+
+      def write_response_to_file(response, destination, logger)
+        progress = DownloadProgress.new(logger: logger)
+
+        File.open(destination, "wb") do |file|
+          response.read_body do |chunk|
+            file.write(chunk)
+            progress.track(chunk.bytesize)
+          end
+        end
+
+        progress.finish
+      end
+
+      def create_http(uri)
+        logger = Chromedriver::Binary.logger
+
+        logger.debug("Starting download from: #{uri}")
+
+        Net::HTTP.new(
+          uri.host,
+          uri.port,
+          Chromedriver::Binary.proxy_addr,
+          Chromedriver::Binary.proxy_port,
+          Chromedriver::Binary.proxy_user,
+          Chromedriver::Binary.proxy_pass
+        ).tap do |http|
+          http.use_ssl = uri.scheme == "https"
+
+          log_proxy_info(http, logger)
+        end
+      end
+
+      def log_proxy_info(http, logger)
+        if http.proxy?
+          source = http.proxy_from_env? ? "environment" : "Chromedriver::Binary"
+          logger.debug("Using proxy from #{source}:")
+          logger.debug("Proxy address: #{http.proxy_address}")
+          logger.debug("Proxy port: #{http.proxy_port}")
+
+          return
+        end
+
+        logger.debug("No proxy is being used.")
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/finder.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require_relative "platform"
+require_relative "system_helper"
+
+module Chromedriver
+  module Binary
+    class Finder
+      include Platform
+      include SystemHelper
+
+      def version
+        version = send("#{platform}_version", location)
+        raise VersionError, "Failed to determine Chrome version." if version.nil? || version.empty?
+
+        Chromedriver::Binary.logger.debug "Browser version: #{version}"
+        version[/\d+\.\d+\.\d+\.\d+/]
+      end
+
+      def location
+        if chrome_bin_from_env
+          Chromedriver::Binary.logger.debug "CHROMEDRIVER_CHROME_PATH: #{chrome_bin_from_env}"
+
+          return chrome_bin_from_env
+        end
+
+        send("#{platform}_location").tap do |chrome_bin|
+          raise Chromedriver::Binary::BrowserNotFound, "Failed to determine Chrome binary location." unless chrome_bin
+        end
+      end
+
+      private
+
+      def chrome_bin_from_env
+        ENV.fetch("CHROMEDRIVER_CHROME_PATH", nil)
+      end
+
+      def find_in_paths(directories, files)
+        directories.each do |dir|
+          files.each do |file|
+            path = File.join(dir, file)
+            return path if file_exists?(path)
+          end
+        end
+        nil
+      end
+
+      def file_exists?(path)
+        File.exist?(path)
+      end
+
+      def win_location
+        find_in_paths(%w[LOCALAPPDATA PROGRAMFILES PROGRAMFILES(X86)],
+                      ['\\Google\\Chrome\\Application\\chrome.exe', '\\Chromium\\Application\\chrome.exe'])
+      end
+
+      def mac_location
+        find_in_paths(["", File.expand_path("~")],
+                      ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+                       "/Applications/Chromium.app/Contents/MacOS/Chromium"])
+      end
+
+      def linux_location
+        find_in_paths(
+          %w[/usr/local/sbin /usr/local/bin /usr/sbin /usr/bin /sbin /bin /snap/bin /opt/google/chrome
+             /opt/chromium.org/chromium], %w[google-chrome chrome chromium chromium-browser]
+        )
+      end
+
+      def win_version(location)
+        call("powershell.exe \"(Get-ItemProperty '#{location}').VersionInfo.ProductVersion\"")&.strip
+      end
+
+      def linux_version(location)
+        call(location, "--product-version")&.strip
+      end
+
+      def mac_version(location)
+        call(location, "--version")&.strip
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/platform.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+
+module Chromedriver
+  module Binary
+    module Platform
+      def platform
+        case RbConfig::CONFIG["host_os"].downcase
+        when /linux/ then "linux"
+        when /darwin/ then "mac"
+        when /mswin|msys|mingw|cygwin|bccwin|wince|emc/ then "win"
+        else
+          raise NotImplementedError, "Your OS is not supported by this gem."
+        end
+      end
+
+      def platform_id
+        case platform
+        when /mac/
+          "mac64"
+        when /linux/
+          if File.exist?("/proc/version") && File.read("/proc/version").include?("Microsoft")
+            "win32"
+          else
+            "linux64"
+          end
+        when /win/
+          "win32"
+        end
+      end
+
+      def file_name
+        platform_id == "win32" ? "chromedriver.exe" : "chromedriver"
+      end
+
+      def driver_filename
+        platform = platform_id
+        case platform
+        when "win32"
+          "win32"
+        when "linux64"
+          "linux64"
+        when "mac64"
+          # If you're on an Apple Silicon Mac, check Ruby platform for arm details.
+          if RUBY_PLATFORM.include?("arm64-darwin")
+            "mac-arm64"
+          else
+            "mac-x64"
+          end
+        else
+          raise "Failed to determine driver filename to download for your OS."
+        end
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/railtie.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "rails"
+
+module Chromedriver
+  module Binary
+    class Railtie < Rails::Railtie
+      railtie_name :chromedriver_binary
+
+      rake_tasks do
+        path = File.expand_path(__dir__)
+        Dir.glob("#{path}/tasks/*.rake").each { |f| load f }
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/system_helper.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module Chromedriver
+  module Binary
+    module SystemHelper
+      def call(process, arg = nil)
+        cmd = arg ? [process, arg] : process
+        Chromedriver::Binary.logger.debug "making System call: #{cmd}"
+
+        output, status = capture(*cmd)
+
+        raise "Failed to make system call: #{cmd}" unless status.success?
+
+        Chromedriver::Binary.logger.debug "System call returned: #{output}"
+        output
+      end
+
+      def exists?(file)
+        File.exist?(file).tap do |result|
+          Chromedriver::Binary.logger.debug "#{file} is#{" not" unless result} already downloaded"
+        end
+      end
+
+      private
+
+      def capture(*cmd)
+        Open3.capture2(*cmd)
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/tasks/chromedriver.rake

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+namespace :chromedriver do
+  namespace :binary do
+    require "chromedriver/binary"
+
+    Chromedriver::Binary.logger.level = :info
+
+    desc "Print current chromedriver version"
+    task :version do
+      gem_ver = Chromedriver::Binary::ChromedriverDownloader.current_installed_version
+      if gem_ver
+        Chromedriver::Binary.logger.info "chromedriver #{gem_ver.version}"
+      else
+        Chromedriver::Binary.logger.warn "No existing chromedriver found."
+      end
+    end
+
+    desc "Remove and download updated chromedriver if necessary"
+    task :update do
+      Chromedriver::Binary::ChromedriverDownloader.update force: true
+      # rubocop:disable Layout/LineLength
+      Chromedriver::Binary.logger.info "Updated to chromedriver #{Chromedriver::Binary::ChromedriverDownloader.current_installed_version}"
+      # rubocop:enable Layout/LineLength
+    end
+  end
+end

data/lib/chromedriver/binary/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Chromedriver
+  module Binary
+    VERSION = "0.1.1"
+  end
+end

data/lib/chromedriver/binary/version_resolver.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "open-uri"
+require "json"
+require_relative "finder"
+require_relative "system_helper"
+require_relative "downloader_helper"
+
+module Chromedriver
+  module Binary
+    module VersionResolver
+      include SystemHelper
+      include DownloaderHelper
+
+      BASE_URL = "https://chromedriver.storage.googleapis.com"
+      CHROME_FOR_TESTING_BASE_URL = "https://googlechromelabs.github.io/chrome-for-testing/"
+
+      def normalize_version(version)
+        Gem::Version.new(version.to_s)
+      end
+
+      def browser_build_version
+        normalize_version(browser_version.segments[0..2].join("."))
+      end
+
+      def latest_patch_version_for_build
+        data = fetch_data("latest-patch-versions-per-build.json")
+        patch_version = data.dig(:builds, browser_build_version.to_s.to_sym, :version)
+        raise "No patch version found for build #{browser_build_version}" unless patch_version
+
+        patch_version
+      rescue StandardError => e
+        raise "Error fetching latest patch version: #{e.message}"
+      end
+
+      # @param [_ToS] driver_version
+      def direct_url_from_api(driver_version, driver_filename)
+        data = fetch_data("known-good-versions-with-downloads.json")
+        version_data = data[:versions].find { |e| e[:version] == driver_version.to_s }
+        platform = version_data.dig(:downloads, :chromedriver).find { |e| e[:platform] == driver_filename }
+        platform[:url]
+      end
+
+      #
+      # Returns current chromedriver version.
+      #
+      # @return [Gem::Version]
+      def current_installed_version
+        Chromedriver::Binary.logger.debug "Checking current version"
+        return nil unless exists?(driver_path)
+
+        version = query_binary_version
+        return nil if version.nil?
+
+        # Matches 2.46, 2.46.628411 and 73.0.3683.75
+        normalize_version version[/\d+\.\d+(\.\d+)?(\.\d+)?/]
+      end
+
+      def driver_path
+        raise "driver_path not defined"
+      end
+
+      def query_binary_version
+        version = call(driver_path, "--version")
+        Chromedriver::Binary.logger.debug "Current version of #{driver_path} is #{version}"
+        version
+      rescue Errno::ENOENT
+        Chromedriver::Binary.logger.debug "No Such File or Directory: #{driver_path}"
+        nil
+      end
+
+      private
+
+      def fetch_data(json_file)
+        uri = URI.join(CHROME_FOR_TESTING_BASE_URL, json_file)
+        http = create_http(uri)
+        response = nil
+
+        exec_get_request(http, uri) do |resp|
+          response = resp.body
+        end
+
+        JSON.parse(response, symbolize_names: true)
+      end
+
+      def browser_version
+        normalize_version Chromedriver::Binary::Finder.new.version
+      end
+    end
+  end
+end

data/lib/chromedriver/binary.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative "binary/version"
+require_relative "binary/chromedriver_downloader"
+require_relative "binary/railtie" if defined?(Rails)
+require "logger"
+
+module Chromedriver
+  module Binary
+    class Error < StandardError; end
+
+    class VersionError < Error; end
+
+    class BrowserNotFound < Error; end
+
+    DEFAULT_INSTALL_DIR = File.expand_path("~/.webdrivers")
+
+    @logger = Logger.new($stdout)
+    @logger.level = Logger::DEBUG
+
+    class << self
+      attr_accessor :logger, :proxy_addr, :proxy_port, :proxy_user, :proxy_pass
+      attr_writer :install_dir
+
+      #
+      # Returns the install (download) directory path for the drivers.
+      #
+      # @return [String]
+      def install_dir
+        @install_dir ||= ENV["CHROMEDRIVER_INSTALL_DIR"] || DEFAULT_INSTALL_DIR
+      end
+
+      #
+      # Provides a convenient way to configure the gem.
+      #
+      # @example Configure proxy and cache_time
+      #   Chromedriver::Binary.configure do |config|
+      #     config.proxy_addr = 'myproxy_address.com'
+      #     config.proxy_port = '8080'
+      #     config.proxy_user = 'username'
+      #     config.proxy_pass = 'password'
+      #   end
+      #
+      def configure
+        yield self if block_given?
+      end
+    end
+  end
+end

data/sig/chromedriver/binary/binary.rbs

@@ -0,0 +1,40 @@
+module Chromedriver
+  module Binary
+    @logger: Logger
+
+    @install_dir: String
+
+    DEFAULT_INSTALL_DIR: String
+    VERSION: String
+
+    attr_writer self.install_dir: String
+    attr_accessor self.logger: Logger
+
+    attr_accessor self.proxy_addr: String
+
+    attr_accessor self.proxy_port: Integer
+
+    attr_accessor self.proxy_user: String
+
+    attr_accessor self.proxy_pass: String
+
+    #
+    # Returns the install (download) directory path for the drivers.
+    #
+    # @return [String]
+    def self.install_dir: () -> String
+
+    #
+    # Provides a convenient way to configure the gem.
+    #
+    # @example Configure proxy and cache_time
+    #   Chromedriver::Binary.configure do |config|
+    #     config.proxy_addr = 'myproxy_address.com'
+    #     config.proxy_port = '8080'
+    #     config.proxy_user = 'username'
+    #     config.proxy_pass = 'password'
+    #   end
+    #
+    def self.configure: () { (untyped) -> untyped } -> untyped
+  end
+end

data/sig/chromedriver/binary/chromedriver_downloader.rbs

@@ -0,0 +1,18 @@
+module Chromedriver
+  module Binary
+    class ChromedriverDownloader
+      extend VersionResolver
+      extend Platform
+      extend DownloaderHelper
+      extend SystemHelper
+
+      def self.install_dir: () -> String
+
+      def self.driver_path: () -> String
+
+      def self.update: (?force: bool) -> String
+
+      def self.correct_binary?: () -> bool
+    end
+  end
+end

data/sig/chromedriver/binary/download_progress.rbs

@@ -0,0 +1,14 @@
+module Chromedriver
+  module Binary
+    class DownloadProgress
+      def initialize: (
+          logger: untyped, # Typically Logger, but untyped for flexibility
+          step_bytes: Integer
+        ) -> void
+
+      def track: (Integer) -> void
+
+      def finish: () -> void
+    end
+  end
+end

data/sig/chromedriver/binary/downloader_helper.rbs

@@ -0,0 +1,13 @@
+module Chromedriver
+  module Binary
+    module DownloaderHelper
+      def download_file: (String, String) -> void
+
+      def extract_zip: (String, String) -> void
+
+      private
+
+      def log_proxy_info: (Net::HTTP, untyped) -> void
+    end
+  end
+end

data/sig/chromedriver/binary/platform.rbs

@@ -0,0 +1,9 @@
+module Chromedriver
+  module Binary
+    module Platform
+      def platform: -> untyped
+
+      def platform_id: -> untyped
+    end
+  end
+end

data/sig/chromedriver/binary/system_helper.rbs

@@ -0,0 +1,7 @@
+module Chromedriver
+  module Binary
+    module SystemHelper
+      def call: -> untyped
+    end
+  end
+end

data/sig/chromedriver/binary/version_resolver.rbs

@@ -0,0 +1,7 @@
+module Chromedriver
+  module Binary
+    module VersionResolver
+      def normalize_version: -> untyped
+    end
+  end
+end

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification
+name: chromedriver-binary
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Dieter S.
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-04-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+description: |
+  A Ruby gem that automatically downloads and installs ChromeDriver binaries that match your installed
+  Chrome browser version.
+email:
+- 101627195+dieter-medium@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".idea/.gitignore"
+- ".idea/inspectionProfiles/profiles_settings.xml"
+- ".idea/vcs.xml"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-gemset"
+- ".ruby-version"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/chromedriver/Rakefile
+- lib/chromedriver/binary.rb
+- lib/chromedriver/binary/chromedriver_downloader.rb
+- lib/chromedriver/binary/download_progress.rb
+- lib/chromedriver/binary/downloader_helper.rb
+- lib/chromedriver/binary/finder.rb
+- lib/chromedriver/binary/platform.rb
+- lib/chromedriver/binary/railtie.rb
+- lib/chromedriver/binary/system_helper.rb
+- lib/chromedriver/binary/tasks/chromedriver.rake
+- lib/chromedriver/binary/version.rb
+- lib/chromedriver/binary/version_resolver.rb
+- sig/chromedriver/binary/binary.rbs
+- sig/chromedriver/binary/chromedriver_downloader.rbs
+- sig/chromedriver/binary/download_progress.rbs
+- sig/chromedriver/binary/downloader_helper.rbs
+- sig/chromedriver/binary/platform.rbs
+- sig/chromedriver/binary/system_helper.rbs
+- sig/chromedriver/binary/version_resolver.rbs
+homepage: https://github.com/dieter-medium/chromedriver-binary
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/dieter-medium/chromedriver-binary
+  source_code_uri: https://github.com/dieter-medium/chromedriver-binary
+  changelog_uri: https://github.com/dieter-medium/chromedriver-binary/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: Automatically downloads and installs ChromeDriver binaries.
+test_files: []