automation_helpers 6.0 → 7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1d6285060e12810750da35b34c2177d20a61c452ebf1908e263aa35f77e972b
-  data.tar.gz: 40ce2a6d8c627360e8f251669706f282e2794b79f3b728ba1dbb5522c6705eb5
+  metadata.gz: 0ad027de7b1fd9a155b469103b22ce22b4f5e530350eb36da72647f18ec12bde
+  data.tar.gz: 1d86d8568cc4d0ce42364a94325480ee4ae4cb714e211041d58a52f01e6fd5fd
 SHA512:
-  metadata.gz: 7cb27f6da88756227eb4916b7b60ea5dac209317b79d99f55d70ba860ba6723de20f14b6cff5cd8d3b22667c621ef987561f6d7500a9577996b7c49cb556ebef
-  data.tar.gz: fddf4a7bd98c70bef88ea423d0b164560ccc3df39c15f12de4d668ecc73f8c53a9646eb2f2520bdc8ad9823d9c52b5528e2f9c6c942135d67ea6bfcd33ae0666
+  metadata.gz: a0536aea7a3a41266b35adb04f4cac2a4e56015b0a44ffd0a6fd50ea93c383f86b75f5545f15411843eb467bc0bf9d2c021ddf06d2ccad781632aa7953b10b4c
+  data.tar.gz: b75b94ef7d572d74bacb8c9e0386aa549b8af3101a079b1eb059b829f439e31082e0f16bd1655a7afa4342ec162abc8104c20bf53b1a4be8b70e9e637a329514

data/lib/automation_helpers/drivers/v4/browserstack.rb

@@ -89,7 +89,7 @@ module AutomationHelpers
           {
             'bstack:options' => {
               'local' => 'false',
-              'seleniumVersion' => '4.28.0',
+              'seleniumVersion' => '4.39.0',
               'consoleLogs' => 'verbose',
               'networkLogs' => 'true',
               'resolution' => '1920x1080'

data/lib/automation_helpers/drivers/v4/capabilities.rb

@@ -61,8 +61,7 @@ module AutomationHelpers
               'browserName' => 'internet explorer',
               'bstack:options' => {
                 'ie' => {
-                  # This is a minor hack until the IEDriver catches up and releases a V4 compliant copy
-                  # It is confirmed to be compliant with V4 selenium jars e.t.c.
+                  # This appears to be the last maintained version and we will remove IE support in V8 of helpers
                   'driver' => '4.16.0.0',
                   'arch' => 'x32'
                 }

data/lib/automation_helpers/extensions/capybara/node/element.rb

@@ -20,6 +20,17 @@ module Capybara
         native.rect.y.to_i
       end
 
+      # @return [Capybara::Node::Element]
+      #
+      # Scrolls the element directly into view. Useful to mitigate vs stale element errors
+      def scroll_into_view
+        session.driver.browser.execute_script(
+          "arguments[0].scrollIntoView({block: 'center', inline: 'nearest'});",
+          native
+        )
+        self
+      end
+
       # @return [Boolean]
       #
       # Whether the element is in a stale state or not

data/lib/automation_helpers/extensions/http-cookie/cookie.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module HTTP
+  #
+  # Additional useful methods to extend the HTTP::Cookie class with
+  #
+  class Cookie
+    # @return [Hash]
+    #
+    # A hashified representation of the cookie that will enable you to push it into Selenium Manager
+    def to_h
+      {
+        name: name,
+        value: value,
+        path: path,
+        secure: secure,
+        expires: expires
+      }
+    end
+  end
+end

data/lib/automation_helpers/extensions/http-cookie/cookie_jar.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module HTTP
+  #
+  # Additional useful methods to extend the HTTP::CookieJar class with
+  #
+  class CookieJar
+    # @return [HTTP::Cookie, nil]
+    #
+    # The cookie that has the supplied name
+    def cookie_named(name)
+      cookies.detect { |cookie| cookie.name == name }
+    end
+
+    # @return [Boolean]
+    #
+    # Whether the cookie jar contains the cookie with the supplied name
+    def include?(cookie_name)
+      cookies.any? { |cookie| cookie.name == cookie_name }
+    end
+  end
+end

data/lib/automation_helpers/extensions/selenium/webdriver/element.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Selenium
+  module WebDriver
+    #
+    # Additional useful methods to extend the Selenium::WebDriver::Element class with
+    #
+    class Element
+      # @return [Selenium::WebDriver::Element]
+      #
+      # Scrolls the element directly into view. Useful to mitigate vs stale element errors
+      def scroll_into_view
+        @bridge.execute_script(
+          "arguments[0].scrollIntoView({block: 'center', inline: 'nearest'});",
+          self
+        )
+        self
+      end
+    end
+  end
+end

data/lib/automation_helpers/extensions.rb

@@ -2,6 +2,9 @@
 
 require 'automation_helpers/extensions/capybara/node/element'
 require 'automation_helpers/extensions/cucumber/core/test/case'
+require 'automation_helpers/extensions/http-cookie/cookie'
+require 'automation_helpers/extensions/http-cookie/cookie_jar'
+require 'automation_helpers/extensions/selenium/webdriver/element'
 require 'automation_helpers/extensions/selenium/webdriver/logs'
 require 'automation_helpers/extensions/array'
 require 'automation_helpers/extensions/string'

data/lib/automation_helpers/patches/{capybara.rb → capybara_safari.rb}

@@ -5,7 +5,7 @@ module AutomationHelpers
     #
     # Fix the issue where the `#text` method doesn't normalize whitespace (Only the matchers do)
     #
-    class Capybara < Base
+    class CapybaraSafari < Base
       private
 
       def description
@@ -19,6 +19,14 @@ module AutomationHelpers
       def perform
         ::Capybara::Node::Element.prepend SafariTextPatch
       end
+
+      def deprecate?
+        true
+      end
+
+      def prevent_usage_date
+        Time.new(2027, 3, 30)
+      end
     end
 
     #

data/lib/automation_helpers/patches/capybara_window.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module AutomationHelpers
+  module Patches
+    #
+    # Fix the issue where you cannot close the first window in the handle array with `#close_window`
+    #
+    class CapybaraWindow < Base
+      private
+
+      def description
+        <<~DESCRIPTION
+          The method `#close_window` in Capybara::Selenium::Driver (Base), does not permit closing of the first window in the handle array
+
+          This was introduced over a decade ago and given the propensity for new windows to be opened in the course of testing,
+          this is a significant issue for users of Capybara and Selenium.
+
+          NB: WHEN USING THIS PATCH, NETWORK INTERCEPTION IS AFFECTED. DO NOT USE THIS PATCH IF YOU RELY ON NETWORK INTERCEPTION IN YOUR TESTS.
+
+          See https://github.com/teamcapybara/capybara/issues/2834 for more details.
+        DESCRIPTION
+      end
+
+      def perform
+        ::Capybara::Selenium::Driver.prepend WindowPatch
+      end
+    end
+
+    #
+    # @api private
+    #
+    module WindowPatch
+      def close_window(handle)
+        within_given_window(handle) do
+          browser.close
+        end
+      end
+    end
+  end
+end

data/lib/automation_helpers/patches/http_cookie.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module AutomationHelpers
+  module Patches
+    #
+    # Fix the issue where the `#expires=` writer method doesn't permit DateTime objects
+    #
+    class HTTPCookie < Base
+      private
+
+      def description
+        <<~DESCRIPTION
+          There is a bug/missing piece of functionality in the #expires= writer in HTTP::Cookie
+          Selenium cookies (And by default w3c cookies), come with a DateTime class for the expiry
+
+          See https://github.com/sparklemotion/http-cookie/pull/52 for more details about a potential extension.
+        DESCRIPTION
+      end
+
+      def perform
+        ::HTTP::Cookie.prepend HTTPCookiePatch
+      end
+    end
+
+    #
+    # @api private
+    #
+    module HTTPCookiePatch
+      # Permit DateTime objects to be cast in HTTP::Cookie
+      def expires=(datetime)
+        datetime = datetime.to_time if datetime.is_a?(DateTime)
+        super
+      end
+    end
+  end
+end

data/lib/automation_helpers/patches.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
 require 'automation_helpers/patches/base'
-require 'automation_helpers/patches/capybara'
+require 'automation_helpers/patches/capybara_safari'
+require 'automation_helpers/patches/capybara_window'
+require 'automation_helpers/patches/http_cookie'
 require 'automation_helpers/patches/selenium_logger'

data/lib/automation_helpers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AutomationHelpers
-  VERSION = '6.0'
+  VERSION = '7.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: automation_helpers
 version: !ruby/object:Gem::Version
-  version: '6.0'
+  version: '7.1'
 platform: ruby
 authors:
 - Luke Hill
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-06 00:00:00.000000000 Z
+date: 2026-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -40,7 +40,7 @@ dependencies:
         version: '7.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '11'
+        version: '13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -50,7 +50,7 @@ dependencies:
         version: '7.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '11'
+        version: '13'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -65,34 +65,48 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: http-cookie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.81.0
+        version: 1.88.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.81.0
+        version: 1.88.0
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -113,28 +127,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.8.0
+        version: 3.10.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.8.0
+        version: 3.10.2
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.18'
+        version: '4.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.18'
+        version: '4.22'
 description: Automation Patches / Extensions that allow you to extend your Ruby-based
   testing frameworks
 email:
@@ -161,11 +175,16 @@ files:
 - lib/automation_helpers/extensions/array.rb
 - lib/automation_helpers/extensions/capybara/node/element.rb
 - lib/automation_helpers/extensions/cucumber/core/test/case.rb
+- lib/automation_helpers/extensions/http-cookie/cookie.rb
+- lib/automation_helpers/extensions/http-cookie/cookie_jar.rb
+- lib/automation_helpers/extensions/selenium/webdriver/element.rb
 - lib/automation_helpers/extensions/selenium/webdriver/logs.rb
 - lib/automation_helpers/extensions/string.rb
 - lib/automation_helpers/patches.rb
 - lib/automation_helpers/patches/base.rb
-- lib/automation_helpers/patches/capybara.rb
+- lib/automation_helpers/patches/capybara_safari.rb
+- lib/automation_helpers/patches/capybara_window.rb
+- lib/automation_helpers/patches/http_cookie.rb
 - lib/automation_helpers/patches/selenium_logger.rb
 - lib/automation_helpers/version.rb
 homepage: https://www.github.com/site-prism/automation_helpers
@@ -183,14 +202,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 3.2.8
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Automation Helpers - Avoid writing the most common things in Ruby Automation