testcentricity_web 4.0.2 → 4.1.1

data/lib/testcentricity_web/web_elements/checkbox.rb

@@ -1,16 +1,29 @@
 module TestCentricity
   class CheckBox < UIElement
     attr_accessor :proxy
+    attr_accessor :label
 
-    def initialize(name, parent, locator, context, proxy = nil)
-      @name        = name
-      @parent      = parent
-      @locator     = locator
-      @context     = context
-      @alt_locator = nil
-      @proxy       = proxy
-      @type        = :checkbox
-      set_locator_type
+    def initialize(name, parent, locator, context)
+      super
+      @type = :checkbox
+      check_spec = {
+        proxy: nil,
+        label: nil
+      }
+      define_custom_elements(check_spec)
+    end
+
+    def define_custom_elements(element_spec)
+      element_spec.each do |element, value|
+        case element
+        when :proxy
+          @proxy = value
+        when :label
+          @label = value
+        else
+          raise "#{element} is not a recognized checkbox element"
+        end
+      end
     end
 
     # Does checkbox object exists?
@@ -54,7 +67,7 @@ module TestCentricity
     #   remember_me_checkbox.visible?
     #
     def visible?
-      @proxy.nil? ? super : @proxy.visible?
+      @proxy.nil? ? super : page.find(:css, @proxy).visible?
     end
 
     # Is checkbox disabled (not enabled)?
@@ -77,9 +90,17 @@ module TestCentricity
     #   remember_me_checkbox.get_value
     #
     def get_value
-      @proxy.nil? ? super : @proxy.get_value
+      if @label.nil?
+        @proxy.nil? ? super : page.find(:css, @proxy).text
+      else
+        page.find(:css, @label).text
+      end
     end
 
+    alias get_caption get_value
+    alias caption get_value
+    alias value get_value
+
     # Set the check state of a checkbox object.
     #
     # @param state [Boolean] true = checked / false = unchecked
@@ -98,7 +119,7 @@ module TestCentricity
           obj.set(state)
         end
       else
-        @proxy.click unless state == obj.checked?
+        page.find(:css, @proxy).click unless state == obj.checked?
       end
     end
 
@@ -126,25 +147,5 @@ module TestCentricity
           ExceptionQueue.enqueue_assert_equal(state, actual, "Expected checkbox #{object_ref_message}") :
           assert_equal(state, actual, "Expected checkbox #{object_ref_message} to be #{state} but found #{actual} instead")
     end
-
-    # Highlight a checkbox with a 3 pixel wide, red dashed border for the specified wait time.
-    # If wait time is zero, then the highlight will remain until the page is refreshed
-    #
-    # @param duration [Integer or Float] wait time in seconds
-    # @example
-    #   remember_me_checkbox.highlight(3)
-    #
-    def highlight(duration = 1)
-      @proxy.nil? ? super : @proxy.highlight(duration)
-    end
-
-    # Restore a highlighted checkbox's original style
-    #
-    # @example
-    #   remember_me_checkbox.unhighlight
-    #
-    def unhighlight
-      @proxy.nil? ? super : @proxy.unhighlight
-    end
   end
 end

data/lib/testcentricity_web/web_elements/radio.rb

@@ -1,16 +1,29 @@
 module TestCentricity
   class Radio < UIElement
     attr_accessor :proxy
+    attr_accessor :label
 
-    def initialize(name, parent, locator, context, proxy = nil)
-      @name        = name
-      @parent      = parent
-      @locator     = locator
-      @context     = context
-      @alt_locator = nil
-      @proxy       = proxy
-      @type        = :radio
-      set_locator_type
+    def initialize(name, parent, locator, context)
+      super
+      @type = :radio
+      radio_spec = {
+        proxy: nil,
+        label: nil
+      }
+      define_custom_elements(radio_spec)
+    end
+
+    def define_custom_elements(element_spec)
+      element_spec.each do |element, value|
+        case element
+        when :proxy
+          @proxy = value
+        when :label
+          @label = value
+        else
+          raise "#{element} is not a recognized radio element"
+        end
+      end
     end
 
     # Does radio button object exists?
@@ -43,7 +56,7 @@ module TestCentricity
     #   accept_terms_radio.visible?
     #
     def visible?
-      @proxy.nil? ? super : @proxy.visible?
+      @proxy.nil? ? super : page.find(:css, @proxy).visible?
     end
 
     # Is radio button disabled (not enabled)?
@@ -66,9 +79,17 @@ module TestCentricity
     #   accept_terms_radio.get_value
     #
     def get_value
-      @proxy.nil? ? super : @proxy.get_value
+      if @label.nil?
+        @proxy.nil? ? super : page.find(:css, @proxy).text
+      else
+        page.find(:css, @label).text
+      end
     end
 
+    alias get_caption get_value
+    alias caption get_value
+    alias value get_value
+
     # Set the select state of a radio button object.
     #
     # @param state [Boolean] true = selected / false = unselected
@@ -82,7 +103,7 @@ module TestCentricity
       if @proxy.nil?
         obj.set(state)
       else
-        @proxy.click unless state == obj.checked?
+        page.find(:css, @proxy).click unless state == obj.checked?
       end
     end
 
@@ -103,25 +124,5 @@ module TestCentricity
     def unselect
       set_selected_state(state = false)
     end
-
-    # Highlight a radio button with a 3 pixel wide, red dashed border for the specified wait time.
-    # If wait time is zero, then the highlight will remain until the page is refreshed
-    #
-    # @param duration [Integer or Float] wait time in seconds
-    # @example
-    #   accept_terms_radio.highlight(3)
-    #
-    def highlight(duration = 1)
-      @proxy.nil? ? super : @proxy.highlight(duration)
-    end
-
-    # Restore a highlighted radio button's original style
-    #
-    # @example
-    #   accept_terms_radio.unhighlight
-    #
-    def unhighlight
-      @proxy.nil? ? super : @proxy.unhighlight
-    end
   end
 end

data/lib/testcentricity_web/web_elements/select_list.rb

@@ -7,7 +7,6 @@ module TestCentricity
     attr_accessor :options_list
     attr_accessor :group_item
     attr_accessor :group_heading
-    attr_accessor :base_object
 
     def initialize(name, parent, locator, context)
       super
@@ -286,18 +285,5 @@ module TestCentricity
         trigger.click
       end
     end
-
-    def find_component(component, component_name)
-      begin
-        element = @base_object.find(:css, component, minimum: 0, wait: 1)
-      rescue
-        begin
-          element = page.find(:css, component, minimum: 0, wait: 5)
-        rescue
-          raise "List #{component_name} (#{component}) for selectlist named '#{@name}' (#{locator}) not found"
-        end
-      end
-      element
-    end
   end
 end

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -44,6 +44,7 @@ module TestCentricity
 
     attr_reader   :parent, :locator, :context, :type, :name
     attr_accessor :alt_locator, :locator_type, :original_style
+    attr_accessor :base_object
 
     XPATH_SELECTORS = ['//', '[@', '[contains(']
     CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
@@ -196,7 +197,7 @@ module TestCentricity
     #
     def exists?(visible = true)
       obj, = find_object(visible)
-      obj != nil
+      !obj.nil?
     end
 
     # Is UI object visible?
@@ -516,6 +517,8 @@ module TestCentricity
     end
 
     alias get_caption get_value
+    alias caption get_value
+    alias value get_value
 
     def verify_value(expected, enqueue = false)
       actual = get_value
@@ -1064,5 +1067,18 @@ module TestCentricity
         expected == actual
       end
     end
+
+    def find_component(component, component_name)
+      begin
+        element = @base_object.find(:css, component, minimum: 0, wait: 1)
+      rescue
+        begin
+          element = page.find(:css, component, minimum: 0, wait: 5)
+        rescue
+          raise "Component #{component_name} (#{component}) for #{@type} named '#{@name}' (#{locator}) not found"
+        end
+      end
+      element
+    end
   end
 end

data/lib/testcentricity_web.rb

@@ -1,4 +1,3 @@
-require 'capybara/rspec'
 require 'test/unit'
 require 'appium_lib'
 

data/testcentricity_web.gemspec

@@ -7,18 +7,17 @@ Gem::Specification.new do |spec|
   spec.name          = 'testcentricity_web'
   spec.version       = TestCentricityWeb::VERSION
   spec.platform      = Gem::Platform::RUBY
-  spec.required_ruby_version = '>= 2.3.0'
+  spec.required_ruby_version = '>= 2.7.5'
   spec.authors       = ['A.J. Mrozinski']
   spec.email         = ['testcentricity@gmail.com']
   spec.summary       = 'A Page Object and Data Object Model Framework for desktop and mobile web testing'
   spec.description   = '
     The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements
-    a Page Object Model DSL for use with Cucumber, Capybara, and Selenium-Webdriver. The gem provides support for running
+    a Page Object Model DSL for use with Cucumber, Capybara, and Selenium-Webdriver v4.x. The gem provides support for running
     automated tests against locally hosted desktop browsers, locally hosted emulated mobile browsers (iOS, Android, Windows
     Phone, Blackberry, Kindle Fire) running within a local instance of Chrome, mobile Safari browsers on iOS device simulators
-     or physical iOS devices (using Appium and XCode on OS X), mobile Chrome or Android browsers on Android Studio virtual
-    device emulators (using Appium and Android Studio on OS X), or cloud hosted desktop or mobile web browsers (using the
-    BrowserStack, Sauce Labs, CrossBrowserTesting, TestingBot, Gridlastic, or LambdaTest services).'
+    or physical iOS devices, mobile Chrome or Android browsers on Android Studio virtual device emulators, or cloud hosted
+    desktop or mobile web browsers (using the BrowserStack, Sauce Labs, TestingBot, or LambdaTest services).'
   spec.homepage      = ''
   spec.license       = 'BSD-3-Clause'
 
@@ -34,14 +33,14 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'appium_lib'
   spec.add_runtime_dependency 'browserstack-local'
   spec.add_runtime_dependency 'capybara', '>= 3.1', '< 4'
-  spec.add_runtime_dependency 'childprocess', '~> 0.5'
+  spec.add_runtime_dependency 'childprocess'
   spec.add_runtime_dependency 'chronic', '0.10.2'
   spec.add_runtime_dependency 'faker'
   spec.add_runtime_dependency 'i18n'
   spec.add_runtime_dependency 'os', '~> 1.0'
-  spec.add_runtime_dependency 'selenium-webdriver'
+  spec.add_runtime_dependency 'selenium-webdriver', '>= 4.0', '< 5'
   spec.add_runtime_dependency 'spreadsheet', '1.1.7'
   spec.add_runtime_dependency 'test-unit'
-  spec.add_runtime_dependency 'webdrivers', '~> 4.0'
+  spec.add_runtime_dependency 'webdrivers', '~> 5.0'
   spec.add_runtime_dependency 'virtus'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.0.2
+  version: 4.1.1
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-12-30 00:00:00.000000000 Z
+date: 2022-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -90,16 +90,16 @@ dependencies:
   name: childprocess
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: chronic
   requirement: !ruby/object:Gem::Requirement
@@ -162,14 +162,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
 - !ruby/object:Gem::Dependency
   name: spreadsheet
   requirement: !ruby/object:Gem::Requirement
@@ -204,14 +210,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: virtus
   requirement: !ruby/object:Gem::Requirement
@@ -229,12 +235,11 @@ dependencies:
 description: |2-
 
       The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements
-      a Page Object Model DSL for use with Cucumber, Capybara, and Selenium-Webdriver. The gem provides support for running
+      a Page Object Model DSL for use with Cucumber, Capybara, and Selenium-Webdriver v4.x. The gem provides support for running
       automated tests against locally hosted desktop browsers, locally hosted emulated mobile browsers (iOS, Android, Windows
       Phone, Blackberry, Kindle Fire) running within a local instance of Chrome, mobile Safari browsers on iOS device simulators
-       or physical iOS devices (using Appium and XCode on OS X), mobile Chrome or Android browsers on Android Studio virtual
-      device emulators (using Appium and Android Studio on OS X), or cloud hosted desktop or mobile web browsers (using the
-      BrowserStack, Sauce Labs, CrossBrowserTesting, TestingBot, Gridlastic, or LambdaTest services).
+      or physical iOS devices, mobile Chrome or Android browsers on Android Studio virtual device emulators, or cloud hosted
+      desktop or mobile web browsers (using the BrowserStack, Sauce Labs, TestingBot, or LambdaTest services).
 email:
 - testcentricity@gmail.com
 executables: []
@@ -302,7 +307,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.7.5
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -310,7 +315,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Capybara, Selenium-WebDriver
-rubygems_version: 3.0.9
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: A Page Object and Data Object Model Framework for desktop and mobile web