chromedriver-binary 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 902a2a6e60632f196a90d5e17835ba50aca23ca278fc3760b898002d286ff104
-  data.tar.gz: eb2634ab9f92ed8fec4833abae20dea568c7359b2900a6db9819fee4c0cd1ac0
+  metadata.gz: 330cf0e3e6c057941c47f7040eda5c8a28db0c8dd6403c9b1eca8f8966d08650
+  data.tar.gz: d08c0078dee006bfb43360da18eb7694fa862163a5077a7e5f966814a365c1c1
 SHA512:
-  metadata.gz: 10b685c4c0d4d3f285415d3157da4f8495eee5709cba23dcf8ca6d4196fdc93a251cba0aaba7f372abdd39713217d93b2a3091da54ba56ce43b721bb26083e94
-  data.tar.gz: d64025ac5bdfd20347cf17ee505c3f2644e2389bfcd8cf445307a53f8e0315d9f27cf24b3e3e52bbf22c8542889549cce6a124a13a9ee5ded75bade321f244d3
+  metadata.gz: 47a5832bae1937d22078ef0e74c83f19556b63ff29ffb1df79b088f8ed4c46c4c29100cbe167166fbe4deb1ad5247f33f4858f77ae6cc4bd145a002dbf1f47bd
+  data.tar.gz: f57f53f1ac5e2959bd2314673d7560e11be01be6a0af3ccc66aa0168138a1f742d089ea7cc38ab506ed45150a5b45580cf878563c409581a33b30bc2c7d100a4

data/CHANGELOG.md

@@ -1,5 +1,31 @@
+<!-- generated by git-cliff start -->
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [Unreleased]
 
+[unreleased]: https://github.com/dieter-medium/chromedriver-binary/compare/v0.1.3..HEAD
+
+<!-- generated by git-cliff end -->
+
+## [0.1.4] - 2026-09-20
+
+### 🐛 Fixed
+
+- Automatically detect and link a system-installed `chromedriver` (e.g. Debian/Ubuntu's
+  `chromium-driver` package) on Linux ARM64 before falling back to the official download, which
+  Google does not publish for that platform. Checks `CHROMEDRIVER_PATH` first, then a list of
+  common install directories.
+- Declared `logger` as an explicit dependency. Ruby 4.0 no longer ships it as a default gem, so
+  `require "logger"` previously raised `LoadError`.
+- Widened the `rubyzip` dependency to `>= 2.4, < 4.0` and fixed extraction to work correctly under
+  rubyzip 3.x, whose `Entry#extract` changed how its destination argument is interpreted.
+
 ## [0.1.3] - 2025-05-05
 
 ### 🐛 Fixed

data/Rakefile

@@ -15,6 +15,8 @@ require "chromedriver/binary"
 
 load "chromedriver/Rakefile"
 
+Dir.glob("tasks/*.rake").each { |r| load r }
+
 desc "Run tests with coverage"
 task :coverage do
   ENV["COVERAGE"] = "true"

data/cliff.toml

@@ -0,0 +1,138 @@
+# git-cliff ~ configuration file
+# https://git-cliff.org/docs/configuration
+
+[changelog]
+# template for the changelog header
+header = """
+<!-- generated by git-cliff start -->
+# Changelog\n
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n
+"""
+# template for the changelog body
+# https://keats.github.io/tera/docs/#introduction
+body = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+
+{% if version -%}
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else -%}
+    ## [Unreleased]
+{% endif -%}
+
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {%- for commit in commits %}
+        - {{ commit.message | split(pat="\n") | first | upper_first | trim }}\
+            {% if commit.remote.username %} by @{{ commit.remote.username }}{%- endif -%}
+            {% if commit.remote.pr_number %} in \
+            [#{{ commit.remote.pr_number }}]({{ self::remote_url() }}/pull/{{ commit.remote.pr_number }}) \
+            {%- endif -%}
+    {% endfor %}
+{% endfor %}
+
+{%- if github.contributors | filter(attribute="is_first_time", value=true) | length != 0 %}
+  ## New Contributors
+{%- endif -%}
+
+{% for contributor in github.contributors | filter(attribute="is_first_time", value=true) %}
+  * @{{ contributor.username }} made their first contribution
+    {%- if contributor.pr_number %} in \
+      [#{{ contributor.pr_number }}]({{ self::remote_url() }}/pull/{{ contributor.pr_number }}) \
+    {%- endif %}
+{%- endfor %}\n
+"""
+# template for the changelog footer
+footer = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+
+{% for release in releases -%}
+    {% if release.version -%}
+        {% if release.previous.version -%}
+            [{{ release.version | trim_start_matches(pat="v") }}]: \
+                {{ self::remote_url() }}/compare/{{ release.previous.version }}..{{ release.version }}
+        {% endif -%}
+    {% else -%}
+        [unreleased]: {{ self::remote_url() }}/compare/{{ release.previous.version }}..HEAD
+    {% endif -%}
+{% endfor %}
+<!-- generated by git-cliff end -->
+"""
+# remove the leading and trailing whitespace from the templates
+trim = true
+
+[git]
+# parse the commits based on https://www.conventionalcommits.org
+conventional_commits = true
+# filter out the commits that are not conventional
+filter_unconventional = false
+# regex for preprocessing the commit messages
+commit_preprocessors = [
+    # remove issue numbers from commits
+    { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "" },
+]
+# regex for parsing and grouping commits
+commit_parsers = [
+    # ✅ Features (additions)
+    { message = "^feat(?:\\([^)]+\\))?!?:", group = "🚀 Added" },
+    { message = "^[aA]dd", group = "🚀 Added" },
+    { message = "^[sS]upport", group = "🚀 Added" },
+
+    # ❌ Removals
+    { message = "^[rR]emove", group = "🗑️ Removed" },
+    { message = "^[dD]elete", group = "🗑️ Removed" },
+
+    # 🐛 Fixes
+    { message = "^fix(?:\\([^)]+\\))?!?:", group = "🐛 Fixed" },
+    { message = "^[tT]est", group = "🐛 Fixed" },
+    { message = "^[fF]ix", group = "🐛 Fixed" },
+
+    # 🎨 Refactors
+    { message = "^refactor(?:\\([^)]+\\))?!?:", group = "🎨 Refactored" },
+
+    # ⚡️ Performance
+    { message = "^perf(?:\\([^)]+\\))?!?:", group = "⚡️ Performance" },
+
+    # 📝 Docs
+    { message = "^docs(?:\\([^)]+\\))?!?:", group = "📝 Docs" },
+
+    # 💄 Style (formatting, whitespace, etc.)
+    { message = "^style(?:\\([^)]+\\))?!?:", group = "💄 Style" },
+
+    # 🧪 Tests
+    { message = "^test(?:\\([^)]+\\))?!?:", group = "🧪 Tests" },
+
+    # 🔧 Build
+    { message = "^build(?:\\([^)]+\\))?!?:", group = "🔧 Build" },
+
+    # 🛠️ CI
+    { message = "^ci(?:\\([^)]+\\))?!?:", skip = true },
+
+    # 🧹 Chores (skip)
+    { message = "^chore\\(release\\): prepare for", skip = true },
+    { message = "^chore\\(deps.*\\)", skip = true },
+    { message = "^chore\\(pr\\)", skip = true },
+    { message = "^chore\\(pull\\)", skip = true },
+    { message = "^chore(?:\\([^)]+\\))?!?:", skip = true },
+    { message = "^\\s*chore", skip = true },
+
+    # ⏪ Reverts
+    { message = "^revert(?:\\([^)]+\\))?!?:", group = "⏪ Reverted" },
+
+    # 🌀 Catch-all (only if nothing else matched)
+    { message = "^.*", group = "🔄 Changed" }
+]
+
+
+# filter out the commits that are not matched by commit parsers
+filter_commits = false
+# sort the tags topologically
+topo_order = false
+# sort the commits inside sections by oldest/newest order
+sort_commits = "newest"

data/lib/chromedriver/binary/chromedriver_downloader.rb

@@ -5,6 +5,7 @@ require_relative "version_resolver"
 require_relative "platform"
 require_relative "downloader_helper"
 require_relative "system_helper"
+require_relative "system_driver_locator"
 
 module Chromedriver
   module Binary
@@ -14,6 +15,7 @@ module Chromedriver
         include Platform
         include DownloaderHelper
         include SystemHelper
+        include SystemDriverLocator
 
         # Define where to install ChromeDriver.
         def install_dir
@@ -32,10 +34,14 @@ module Chromedriver
         def update(force: false)
           return driver_path if up_to_date_binary?(force)
 
+          return driver_path if linux_arm64? && link_system_driver?
+
           Chromedriver::Binary.logger.warn(<<-EOF_WARNING) if linux_arm64?
 
-             WARNING: The Linux ARM64 version of ChromeDriver is not officially supported by Google.
-             Please use the OS version of ChromeDriver instead.
+             WARNING: The Linux ARM64 version of ChromeDriver is not officially supported by Google,
+             and no working chromedriver was found automatically (checked CHROMEDRIVER_PATH and
+             #{SystemDriverLocator::SEARCH_DIRECTORIES.join(", ")}).
+             Please install the OS version of ChromeDriver instead.
              For instance on Ubuntu, use the `chromium-driver` package and link it to #{driver_path}.
              `apt-get update && apt-get install chromium-driver`
              `mkdir -p #{install_dir} && ln -s /usr/bin/chromedriver #{driver_path}`
@@ -69,6 +75,27 @@ module Chromedriver
 
         private
 
+        # Symlinks a system-installed chromedriver into driver_path and verifies it actually
+        # matches the installed browser before trusting it - a found binary that's the wrong
+        # version is no better than none, so it's unlinked again rather than left in place for
+        # #update to fall through to the (still doomed, but at least unambiguous) download.
+        def link_system_driver?
+          source = system_driver_path
+          return false unless source
+
+          prepare_install_dir
+          FileUtils.ln_sf(source, driver_path)
+
+          if correct_binary?
+            Chromedriver::Binary.logger.info "Linked system chromedriver #{source} to #{driver_path} (Linux ARM64 has no official Google build)"
+            true
+          else
+            Chromedriver::Binary.logger.debug "#{source} exists but its version doesn't match the browser - removing the link and falling back to the official download"
+            FileUtils.rm_f(driver_path)
+            false
+          end
+        end
+
         def up_to_date_binary?(force)
           if correct_binary? && !force
             Chromedriver::Binary.logger.debug "A working webdriver version is already on the system"

data/lib/chromedriver/binary/downloader_helper.rb

@@ -36,9 +36,16 @@ module Chromedriver
       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)
+            next unless entry.file?
+
+            # Extract all files as top-level (ignoring any folder structure). Writes the entry's
+            # bytes directly rather than calling Entry#extract - that method's own destination
+            # argument is not stable across rubyzip major versions: 2.x took a full destination
+            # path as its first positional arg, 3.x repurposed that arg as a path *relative to* a
+            # separate destination_directory: keyword, silently mangling an absolute path passed
+            # the old way (confirmed live: doubled into ".../chromedriver-binary/chromedriver-binary/...").
             destination_file = File.join(destination, File.basename(entry.name))
-            entry.extract(destination_file) { true }
+            File.binwrite(destination_file, entry.get_input_stream.read)
           end
         end
       rescue StandardError => e

data/lib/chromedriver/binary/system_driver_locator.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Chromedriver
+  module Binary
+    # Locates a chromedriver binary already installed on the system - used on Linux ARM64, where
+    # Google's own Chrome for Testing distribution has never published a chromedriver build at all
+    # (a long-standing upstream gap, not a bug in this gem - see ChromedriverDownloader#update's own
+    # comment). Debian/Ubuntu's `chromium-driver` package ships a matching native-arch binary
+    # instead; this lets it be found and linked automatically rather than only ever printing
+    # instructions for a human to run by hand.
+    module SystemDriverLocator
+      SEARCH_DIRECTORIES = %w[/usr/local/sbin /usr/local/bin /usr/sbin /usr/bin /sbin /bin /snap/bin].freeze
+      SEARCH_FILENAMES = %w[chromedriver].freeze
+
+      # @return [String, nil] path to an existing chromedriver binary, or nil if none was found.
+      def system_driver_path
+        driver_from_env || find_driver_on_disk
+      end
+
+      private
+
+      # Same override shape as Finder#chrome_bin_from_env's CHROMEDRIVER_CHROME_PATH, for the driver
+      # instead of the browser - an explicit escape hatch for a system driver outside
+      # SEARCH_DIRECTORIES.
+      def driver_from_env
+        path = ENV.fetch("CHROMEDRIVER_PATH", nil)
+        path if path && File.exist?(path)
+      end
+
+      def find_driver_on_disk
+        SEARCH_DIRECTORIES.each do |dir|
+          SEARCH_FILENAMES.each do |file|
+            path = File.join(dir, file)
+            return path if File.exist?(path)
+          end
+        end
+
+        nil
+      end
+    end
+  end
+end

data/lib/chromedriver/binary/version.rb

@@ -2,6 +2,6 @@
 
 module Chromedriver
   module Binary
-    VERSION = "0.1.3"
+    VERSION = "0.1.4"
   end
 end

data/tasks/changelog.rake

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+def cliff_installed?
+  system("which git-cliff > /dev/null 2>&1")
+end
+
+namespace :changelog do
+  desc "Generate unreleased section in CHANGELOG.md (requires git-cliff)"
+  task :update_unreleased do
+    unless cliff_installed?
+      puts "🚫 git-cliff is not installed!"
+      puts "👉 Install it here: https://git-cliff.org/docs/installation/"
+      exit 1
+    end
+
+    generated = `git cliff --unreleased`
+
+    changelog_path = "CHANGELOG.md"
+    changelog = File.read(changelog_path)
+
+    updated = changelog.sub(
+      /<!--.*generated\s+by\s+git-cliff\s+start\s+-->(.*?)<!--\s+generated\s+by\s+git-cliff\s+end\s+-->/m,
+      generated.strip
+    )
+
+    File.write(changelog_path, updated)
+    puts "✅ Replaced generated section in CHANGELOG.md"
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chromedriver-binary
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Dieter S.
@@ -9,20 +9,40 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  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: rubyzip
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -141,6 +161,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- cliff.toml
 - lib/chromedriver/Rakefile
 - lib/chromedriver/binary.rb
 - lib/chromedriver/binary/chromedriver_downloader.rb
@@ -149,6 +170,7 @@ files:
 - lib/chromedriver/binary/finder.rb
 - lib/chromedriver/binary/platform.rb
 - lib/chromedriver/binary/railtie.rb
+- lib/chromedriver/binary/system_driver_locator.rb
 - lib/chromedriver/binary/system_helper.rb
 - lib/chromedriver/binary/tasks/chromedriver.rake
 - lib/chromedriver/binary/version.rb
@@ -160,6 +182,7 @@ files:
 - sig/chromedriver/binary/platform.rbs
 - sig/chromedriver/binary/system_helper.rbs
 - sig/chromedriver/binary/version_resolver.rbs
+- tasks/changelog.rake
 homepage: https://github.com/dieter-medium/chromedriver-binary
 licenses:
 - MIT
@@ -183,7 +206,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Automatically downloads and installs ChromeDriver binaries.
 test_files: []