build(deps): upgrade dependencies for modern environment compatibility

- Add Ruby 4.0 support (released Dec 2025), bump minimum to Ruby 3.2
- Update Rails 8.1 from beta to stable release
- Drop Rails 7.0 (EOL) and JRuby 9.4 (targets Ruby 3.1) from CI
- Bump CI default Ruby from 3.4 to 4.0 across all workflows
- Update default BUNDLE_GEMFILE to Rails 8.1
- Bump upload-artifact action from v4 to v6
- Update Dockerfile base image to Ruby 4.0
- Update README requirements to match gemspec

Author: Twill

.github/actions/upload-screenshots/action.yml

@@ -8,14 +8,14 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v6
       with:
         name: ${{ inputs.name }}-diffs
         retention-days: 1
         path: |
           test/fixtures/app/doc/screenshots/
 
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v6
       with:
         name: ${{ inputs.name }}-capybara-fails
         retention-days: 1

.github/workflows/lint.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.3'
+          ruby-version: '4.0'
           bundler-cache: true
 
       - name: Run Standard Ruby linter

.github/workflows/test.yml

@@ -15,7 +15,7 @@ on:
   workflow_dispatch:
 
 env:
-  BUNDLE_GEMFILE: gemfiles/rails80_gems.rb
+  BUNDLE_GEMFILE: gemfiles/rails81_gems.rb
   DEBIAN_FRONTEND: noninteractive
   FERRUM_PROCESS_TIMEOUT: 40
   JAVA_OPTS: -Xmn2g -Xms6g -Xmx6g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -Xss1m
@@ -42,7 +42,7 @@ jobs:
 
       - uses: ./.github/actions/setup-ruby-and-dependencies
         with:
-          ruby-version: 3.4
+          ruby-version: '4.0'
 
       - run: bin/rake test
         env:
@@ -59,7 +59,7 @@ jobs:
 
       - uses: ./.github/actions/setup-ruby-and-dependencies
         with:
-          ruby-version: 3.4
+          ruby-version: '4.0'
           cache-apt-packages: true
 
       - run: bin/rake test
@@ -93,37 +93,24 @@ jobs:
     continue-on-error: ${{ matrix.experimental }}
     strategy:
       matrix:
-        ruby-version: [ 3.4, 3.3, 3.2, jruby-9.4, jruby-10.0 ]
+        ruby-version: [ '4.0', 3.4, 3.3, 3.2, jruby-10.0 ]
         gemfile:
           - rails71_gems.rb
           - rails72_gems.rb
           - rails80_gems.rb
           - rails81_gems.rb
         experimental: [ false ]
         exclude:
-          # We already tested last version
-          - ruby-version: 3.4
-            gemfile: rails80_gems.rb
-            experimental: false
-          # JRuby 9.x is Ruby 3.1 compatible, and Rails 8 requires Ruby 3.2.
-          - ruby-version: jruby-9.4
-            gemfile: rails80_gems.rb
-            experimental: false
-          - ruby-version: jruby-9.4
+          # We already tested last version in the functional-test job
+          - ruby-version: '4.0'
             gemfile: rails81_gems.rb
             experimental: false
         include:
-          - ruby-version: 3.5.0-preview1
-            gemfile: rails81_gems.rb
-            experimental: true
-          - ruby-version: 3.5.0-preview1
-            gemfile: edge_gems.rb
-            experimental: true
-          - ruby-version: 3.4
+          - ruby-version: '4.0'
             gemfile: edge_gems.rb
             experimental: true
           - ruby-version: jruby-head
-            gemfile: rails80_gems.rb
+            gemfile: rails81_gems.rb
             experimental: true
 
     env:
@@ -168,7 +155,7 @@ jobs:
 
       - uses: ./.github/actions/setup-ruby-and-dependencies
         with:
-          ruby-version: 3.4
+          ruby-version: '4.0'
           cache-apt-packages: ${{ matrix.screenshot-driver == 'vips' }}
 
       - name: Cache Selenium

Dockerfile

@@ -3,7 +3,7 @@
 #   $ docker build . -t csd
 #   $ docker run -v $(pwd):/app -ti csd rake test
 
-FROM jetthoughts/cimg-ruby:3.4-chrome
+FROM jetthoughts/cimg-ruby:4.0-chrome
 
 ENV DEBIAN_FRONTEND=noninteractive \
  BUNDLE_PATH=/bundle

README.md

@@ -45,8 +45,8 @@ Or install it yourself as:
 
 `capybara-screenshot-diff` supports the currently supported versions of Ruby and Rails:
 
-* Ruby 3.0+ (https://www.ruby-lang.org/en/downloads/branches/)
-* Rails 6.1+ (https://guides.rubyonrails.org/maintenance_policy.html)
+* Ruby 3.2+ (https://www.ruby-lang.org/en/downloads/branches/)
+* Rails 7.1+ (https://guides.rubyonrails.org/maintenance_policy.html)
 
 * [for :vips driver] libvips 8.9 or later, see the [libvips install instructions](https://libvips.github.io/libvips/install.html)
 

capybara-screenshot-diff.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.summary = "Track your GUI changes with diff assertions"
   spec.description = "Save screen shots and track changes with graphical diff"
   spec.homepage = "https://github.com/donv/capybara-screenshot-diff"
-  spec.required_ruby_version = ">= 3.1"
+  spec.required_ruby_version = ">= 3.2"
   spec.license = "MIT"
   spec.metadata["allowed_push_host"] = "https://rubygems.org/"
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "actionpack", ">= 7.0", "< 9"
-  spec.add_development_dependency "activesupport", ">= 7.0", "< 9"
+  spec.add_development_dependency "actionpack", ">= 7.1", "< 9"
+  spec.add_development_dependency "activesupport", ">= 7.1", "< 9"
   spec.add_runtime_dependency "capybara", ">= 2", "< 4"
 end

gemfiles/rails70_gems.rb

@@ -3,5 +3,5 @@
 gems = "#{File.dirname __dir__}/gems.rb"
 eval File.read(gems), binding, gems
 
-gem "activesupport", "~> 8.1.0.beta1"
-gem "actionpack", "~> 8.1.0.beta1"
+gem "activesupport", "~> 8.1.0"
+gem "actionpack", "~> 8.1.0"