automation_helpers 4.0.1 → 4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b76d24db41e2d9211d253fe3985f632bf3ac56c6f2053a0932622eff9fab3dd
-  data.tar.gz: 794c1192df35048a0e7f8d06b0a4043a3f7a207ad5ed00cf4039ebcd389c8219
+  metadata.gz: a45b85e5e998a666514c866da1cc6639fa113ebe88232a70ceb979c4a2877a03
+  data.tar.gz: d66c6284158e939d8d268126e8fd98833316ca2cfa4a29c3afbdd8002c1aa61a
 SHA512:
-  metadata.gz: 5eda215013852802b916764ff564844bb336f39d363fa241de875c1199f07e09b46860273741fead783abb068fefd8e734e10cd004c12720465b3719109313c5
-  data.tar.gz: f875ff9b0c007eb72f3282222ff9fff1276561c82d3f0061bb0644b8ded894e6b8d466e127b26094379030300f080a11577e8baf96de58c3b0bf07fa9c03b0e8
+  metadata.gz: 97f4e92ba3f4a1bc6629d07b94e60de3b9c722f27feb0700b8fbaf9953a4177302584ec8700245a942b3a9a114ca007e05f976f0ccb34d46a3e55a20b0486856
+  data.tar.gz: 6039a2641fe43f4f46ac5befd0987bd259391a2da6f59e1e553de76b58ab6ad8c01bccafb0a8ae49079036290da4de0d8571a8fb83549fa36530ab8902da3bcd

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

@@ -9,11 +9,9 @@ require 'automation_helpers/drivers/v4/options'
 module AutomationHelpers
   module Drivers
     module V4
-      #
-      # {AutomationHelpers::Drivers::V4::Browserstack}
       #
       # The Browserstack Driver that will connect to a hosted grid
-      # Requires a series of pre-set values to be passed in
+      # This requires a series of pre-set values to be passed in
       #
       class Browserstack
         attr_reader :browser, :browserstack_options, :device_options

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

@@ -6,10 +6,7 @@ module AutomationHelpers
   module Drivers
     module V4
       #
-      # {AutomationHelpers::Drivers::V4::Capabilities}
-      #
-      # The Capabilities object that will be used to instantiate whatever driver you
-      # are configuring
+      # The Capabilities object that will be used to instantiate whatever driver you are configuring
       #
       class Capabilities
         class << self

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

@@ -7,8 +7,6 @@ require 'automation_helpers/drivers/v4/options'
 module AutomationHelpers
   module Drivers
     module V4
-      #
-      # {AutomationHelpers::Drivers::V4::Local}
       #
       # The Local Driver that will spin up and run on your machine (Without connecting to any grid)
       #

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

@@ -5,8 +5,6 @@ require 'selenium/webdriver'
 module AutomationHelpers
   module Drivers
     module V4
-      #
-      # {AutomationHelpers::Drivers::V4::Options}
       #
       # The Options object that will be used to instantiate whatever driver you
       # are configuring

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

@@ -6,11 +6,9 @@ require 'automation_helpers/drivers/v4/options'
 module AutomationHelpers
   module Drivers
     module V4
-      #
-      # {AutomationHelpers::Drivers::V4::Remote}
       #
       # The Remote Driver that will connect to a dockerised self-hosted grid
-      # Expects the grid to be live and accepting node requests
+      # This expects the grid to be live **and** accepting node requests
       #
       class Remote
         attr_reader :browser

data/lib/automation_helpers/extensions/array.rb

@@ -2,11 +2,17 @@
 
 # Additional useful methods to extend the Array class with
 class Array
-  # @return [Boolean]
+  # @return [Array]
   #
-  # Test whether an array is wholly unique
-  def uniq?
-    uniq == self
+  # Generates an array of the english alphabet
+  # Accepts an input to determine what case of alphabet you want
+  def self.alphabet(type = :upper)
+    case type
+    when :upper; then ('A'..'Z').to_a
+    when :lower; then ('a'..'z').to_a
+    when :both;  then ('a'..'z').to_a + ('A'..'Z').to_a
+    else raise ArgumentError, 'Invalid alphabet type. Must be :upper (default), :lower or :both'
+    end
   end
 
   # @return [Array]
@@ -15,4 +21,11 @@ class Array
   def non_uniq
     tally.select { |_key, count| count > 1 }.map(&:first)
   end
+
+  # @return [Boolean]
+  #
+  # Test whether an array is wholly unique
+  def uniq?
+    uniq == self
+  end
 end

data/lib/automation_helpers/extensions/string.rb

@@ -4,7 +4,15 @@
 class String
   # @return [String]
   #
-  # Convert's a regular string name into it's pascalized format
+  # Generates a single random letter from an array of the english alphabet
+  # Accepts an input to determine what case of alphabet you want
+  def self.alphabet_char(type = :upper)
+    Array.alphabet(type).sample
+  end
+
+  # @return [String]
+  #
+  # Converts a regular string name into it's pascalized format
   # This can then be used to generate a ClassName
   def pascalize
     split('_').map(&:capitalize).join
@@ -12,7 +20,15 @@ class String
 
   # @return [String]
   #
-  # Convert's a regular string into a snake cased format
+  # Sanitize and convert every individual whitespace character to
+  # a regular space character (Does not sanitize newlines)
+  def sanitize_whitespace
+    gsub(/[ \t\r\f\u00A0]/, ' ')
+  end
+
+  # @return [String]
+  #
+  # Converts a regular string into a snake cased format
   # Will sanitize out some characters (Designed for titles)
   def snake_case
     gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
@@ -24,11 +40,10 @@ class String
       .downcase
   end
 
-  # @return [String]
+  # @return [Boolean]
   #
-  # Sanitize and convert every individual whitespace character to
-  # a regular space character (Does not sanitize newlines)
-  def sanitize_whitespace
-    gsub(/[ \t\r\f\u00A0]/, ' ')
+  # Cast any string to true or false
+  def to_bool
+    %w[yes on true].include?(downcase)
   end
 end

data/lib/automation_helpers/logger.rb

@@ -7,6 +7,9 @@ module AutomationHelpers
   # @api private
   #
   class Logger
+    #
+    # Generate the Logger used in the gem
+    #
     def self.create(output = $stdout)
       logger = ::Logger.new(output)
       logger.progname = 'Automation Helpers'

data/lib/automation_helpers/patches/base.rb

@@ -2,9 +2,12 @@
 
 module AutomationHelpers
   module Patches
+    #
+    # @api private
+    #
     class Base
       #
-      # api private (Not intended to be instantiated directly!)
+      # api private (Not intended to be instantiated directly! Use the child classes)
       #
       def patch!
         raise 'This is no longer supported' if prevent_usage?

data/lib/automation_helpers/patches/capybara.rb

@@ -2,6 +2,9 @@
 
 module AutomationHelpers
   module Patches
+    #
+    # Fix the issue where the `#text` method doesn't normalize whitespace (Only the matchers do)
+    #
     class Capybara < Base
       private
 
@@ -18,6 +21,9 @@ module AutomationHelpers
       end
     end
 
+    #
+    # @api private
+    #
     module SafariTextPatch
       def text(type = nil, normalize_ws: ::Capybara.default_normalize_ws)
         super(type, normalize_ws: normalize_ws)

data/lib/automation_helpers/patches/parallel_cucumber.rb

@@ -2,6 +2,9 @@
 
 module AutomationHelpers
   module Patches
+    #
+    # Fix the issue where the parser for parallel_tests doesn't permit the --retry flag (Or other flags at the end)
+    #
     class ParallelCucumber < Base
       private
 

data/lib/automation_helpers/patches/selenium_logger.rb

@@ -2,6 +2,10 @@
 
 module AutomationHelpers
   module Patches
+    #
+    # Fix the issue where the Selenium Logger isn't designed to parse characters that aren't standard ASCII
+    # (This is an issue in the parent Net-HTTP adapter that most loggers are built on)
+    #
     class SeleniumLogger < Base
       private
 

data/lib/automation_helpers/patches/selenium_manager.rb

@@ -2,6 +2,10 @@
 
 module AutomationHelpers
   module Patches
+    #
+    # Fix the issue where the `#convert_cookie` API private method in selenium-webdriver doesn't include the
+    # 'httpOnly' property in the returned cookie hash structure
+    #
     class SeleniumManager < Base
       private
 
@@ -29,6 +33,9 @@ module AutomationHelpers
       end
     end
 
+    #
+    # @api private
+    #
     module CookieConverter
       def convert_cookie(cookie)
         super(cookie)

data/lib/automation_helpers/patches/selenium_options.rb

@@ -2,6 +2,9 @@
 
 module AutomationHelpers
   module Patches
+    #
+    # Fix the issue where for some drivers selenium doesn't camelize the browser name key 'browserName' correctly
+    #
     class SeleniumOptions < Base
       def initialize(browser)
         @browser = browser
@@ -53,6 +56,9 @@ module AutomationHelpers
       end
     end
 
+    #
+    # @api private
+    #
     module CapabilitiesAsJsonFix
       private
 

data/lib/automation_helpers/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: automation_helpers
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: '4.1'
 platform: ruby
 authors:
 - Luke Hill
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-22 00:00:00.000000000 Z
+date: 2022-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -79,76 +79,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.11'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.35.0
+        version: 1.38.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.35.0
+        version: 1.38.0
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.14.3
+        version: 1.15.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.14.3
+        version: 1.15.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.11.1
+        version: 2.14.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.11.1
+        version: 2.14.2
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.0.0.beta2
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.0.0.beta2
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: webdrivers
   requirement: !ruby/object:Gem::Requirement