testcentricity_mobile 4.0.5 → 4.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e8fb5fe845b780a179f42b55ae5b46af2e82f38e1a722df9510a3662de8dca5
-  data.tar.gz: 9bd6ba84e65f19b11daccf044d805f23a969ab17efbb6a40827a780ab127a96c
+  metadata.gz: fa7ae2f538647efddd759d3958b2def1c3dd73cb68772a23310397c49e23b556
+  data.tar.gz: 15a31c256250cbaa3670a467469e3386c0467883facb23026b662a383ac81722
 SHA512:
-  metadata.gz: 5cfa08ef930ec88fa2f5de32ef296e77107abeb153efad4660dea4564022a341a52c8e6d6c7a5136d5ec82432e705a635f3542ec05b46ccd50b344b7e7d6157f
-  data.tar.gz: 6ee2af57ed34c56f4240b98d9e680c1fbf32e98692a5664664ac8cad6161dede0be7eea9ee67401928efbf1a4fdf46cfa05313fd39ff38ff8373ec8da577d444
+  metadata.gz: 1b1b5323763138cce0d95a8b0b2dc142dfce8f39c4d45cacc13bfc5a7420d49d0b16a766108421dbc25d9c9043c22131257434347f7a44cac3839569337fcd3c
+  data.tar.gz: e1004a41f10e1983e94d2dd659aa0abd3543227ac6e831b931f20eafd21133fc456ee7bff85eddf869cddad92a58a2d3e2f85fbbb58bf1a956191d1ef6b12cdd

data/CHANGELOG.md

@@ -2,6 +2,29 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.0.7] - 05-MAY-2024
+
+### Added
+* Added support for radio buttons via the `AppRadio` UI element class and the following methods:
+  * `ScreenObject.radio`
+  * `ScreenObject.radios`
+  * `ScreenSection.radio`
+  * `ScreenSection.radios`
+* `ScreenObject.populate_data_fields` and `ScreenSection.populate_data_fields` methods now support radio buttons.
+
+### Changed
+
+* Updated `selenium-webdriver` gem to version 4.20.1.
+* Updated `appium_lib_core` gem to version 8.0.2.
+
+
+## [4.0.6] - 02-MAY-2024
+
+### Fixed
+
+* `ScreenSection.find_section` is now able to find `ScreenSection` objects embedded within other `ScreenSections`.
+
+
 ## [4.0.5] - 29-APR-2024
 
 ### Fixed

data/README.md

@@ -508,15 +508,16 @@ Supported `AppUIElement` elementTypes and their declarations have the following
 *Single element declarations:*
 ```ruby
     class SampleScreen < TestCentricity::ScreenObject
-      button     :button_name, { locator_strategy: locator_identifier }
-      textfield  :field_name, { locator_strategy: locator_identifier }
-      checkbox   :checkbox_name, { locator_strategy: locator_identifier }
-      label      :label_name, { locator_strategy: locator_identifier }
-      list       :list_name, { locator_strategy: locator_identifier }
-      image      :image_name, { locator_strategy: locator_identifier }
-      switch     :switch_name, { locator_strategy: locator_identifier }
-      element    :element_name, { locator_strategy: locator_identifier }
-      alert      :alert_name, { locator_strategy: locator_identifier }
+      button    :button_name, { locator_strategy: locator_identifier }
+      textfield :field_name, { locator_strategy: locator_identifier }
+      checkbox  :checkbox_name, { locator_strategy: locator_identifier }
+      radio     :radio_name, { locator_strategy: locator_identifier }
+      label     :label_name, { locator_strategy: locator_identifier }
+      list      :list_name, { locator_strategy: locator_identifier }
+      image     :image_name, { locator_strategy: locator_identifier }
+      switch    :switch_name, { locator_strategy: locator_identifier }
+      element   :element_name, { locator_strategy: locator_identifier }
+      alert     :alert_name, { locator_strategy: locator_identifier }
     end
 ```
 *Multiple element declarations:*
@@ -531,6 +532,8 @@ Supported `AppUIElement` elementTypes and their declarations have the following
       checkboxes check_1_name: { locator_strategy: locator_identifier },
                  check_2_name: { locator_strategy: locator_identifier },
                  check_X_name: { locator_strategy: locator_identifier }
+      radios     radio_1_name: { locator_strategy: locator_identifier },
+                 radio_X_name: { locator_strategy: locator_identifier }
       labels     label_1_name: { locator_strategy: locator_identifier },
                  label_X_name: { locator_strategy: locator_identifier }
       images     image_1_name: { locator_strategy: locator_identifier },
@@ -593,8 +596,8 @@ above) for each `AppUIElement` that needs to be interacted with.
 The `ScreenObject.populate_data_fields` and `ScreenSection.populate_data_fields` methods support the entry of test data
 into a collection of `AppUIElements`. The `populate_data_fields` method accepts a hash containing key/hash pairs of
 `AppUIElements` and their associated data to be entered. Data values must be in the form of a `String` for `textfield`
-controls. For `checkbox` controls, data must either be a `Boolean` or a `String` that evaluates to a `Boolean` value (Yes,
-No, 1, 0, true, false).
+controls. For `checkbox`, `radio`, and `switch` controls, data must either be a `Boolean` or a `String` that evaluates to
+a `Boolean` value ('Yes', 'No', '1', '0', 'true', 'false').
 
 The `populate_data_fields` method verifies that data attributes associated with each `AppUIElement` is not `nil` or `empty`
 before attempting to enter data into the `AppUIElement`.

data/lib/testcentricity_mobile/app_core/screen_object.rb

@@ -140,6 +140,30 @@ module TestCentricity
       end
     end
 
+    # Declare and instantiate a single radio button UI Element for this screen object.
+    #
+    # @param element_name [Symbol] name of radio button object (as a symbol)
+    # @param locator [Hash] { locator_strategy: locator_identifier }
+    # @example
+    #   radio :unicode_radio, { xpath: '//XCUIElementTypeRadioButton[@label="Unicode"]'}
+    #
+    def self.radio(element_name, locator)
+      define_screen_element(element_name, TestCentricity::AppElements::AppRadio, locator)
+    end
+
+    # Declare and instantiate a collection of radio buttons for this screen object.
+    #
+    # @param element_hash [Hash] names of radio buttons (as symbol) and locator Hash
+    # @example
+    #   radios unicode_radio: { xpath: '//XCUIElementTypeRadioButton[@label="Unicode"]'},
+    #          ascii_radio:   { xpath: '//XCUIElementTypeRadioButton[@label="ASCII"] }
+    #
+    def self.radios(element_hash)
+      element_hash.each do |element_name, locator|
+        radio(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a single label UI Element for this screen object.
     #
     # @param element_name [Symbol] name of label object (as a symbol)

data/lib/testcentricity_mobile/app_core/screen_objects_helper.rb

@@ -21,9 +21,9 @@ module TestCentricity
     end
 
     # Populate the specified UI elements on this screen or section object with the associated data from a Hash passed as
-    # an argument. Data values must be in the form of a String for textfield controls. For checkboxes and switches, data
-    # must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true, false). For screen section
-    # objects, data values must be a String, and the screen section object must have a set method defined.
+    # an argument. Data values must be in the form of a String for textfield controls. For checkboxes,radios, and switches,
+    # data must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true, false). For screen
+    # section objects, data values must be a String, and the screen section object must have a set method defined.
     #
     # The optional wait_time parameter is used to specify the time (in seconds) to wait for each UI element to become
     # visible before entering the associated data value. This option is useful in situations where entering data, or
@@ -59,6 +59,8 @@ module TestCentricity
             case data_field.get_object_type
             when :checkbox
               data_field.set_checkbox_state(data_param.to_bool)
+            when :radio
+              data_field.set_selected_state(data_param.to_bool)
             when :textfield
               data_field.clear
               data_field.set(data_param)

data/lib/testcentricity_mobile/app_core/screen_section.rb

@@ -20,14 +20,14 @@ module TestCentricity
     end
 
     def get_locator
-      if @locator.zero? && defined?(section_locator)
-        my_locator = section_locator
-      else
-        my_locator = @locator
-      end
+      my_locator = if @locator.zero? && defined?(section_locator)
+                     section_locator
+                   else
+                     @locator
+                   end
       locators = []
       if @context == :section && !@parent.nil?
-        locators.push(@parent.get_locator)
+        locators = @parent.get_locator
       end
 
       if @parent_list.nil?
@@ -206,6 +206,28 @@ module TestCentricity
       element_hash.each_pair { |element_name, locator| checkbox(element_name, locator) }
     end
 
+    # Declare and instantiate a single radio button UI Element for this screen section object.
+    #
+    # @param element_name [Symbol] name of radio button object (as a symbol)
+    # @param locator [Hash] { locator_strategy: locator_identifier }
+    # @example
+    #   radio :unicode_radio, { xpath: '//XCUIElementTypeRadioButton[@label="Unicode"]'}
+    #
+    def self.radio(element_name, locator)
+      define_section_element(element_name, TestCentricity::AppElements::AppRadio, locator)
+    end
+
+    # Declare and instantiate a collection of radio buttons for this screen section object.
+    #
+    # @param element_hash [Hash] names of radio buttons (as symbol) and locator Hash
+    # @example
+    #   radios unicode_radio: { xpath: '//XCUIElementTypeRadioButton[@label="Unicode"]'},
+    #          ascii_radio:   { xpath: '//XCUIElementTypeRadioButton[@label="ASCII"] }
+    #
+    def self.radios(element_hash)
+      element_hash.each_pair { |element_name, locator| radio(element_name, locator) }
+    end
+
     # Declare and instantiate a single label UI Element for this screen section object.
     #
     # @param element_name [Symbol] name of label object (as a symbol)
@@ -578,11 +600,10 @@ module TestCentricity
       locators.each do |loc|
         if obj.nil?
           obj = find_element(loc.keys[0], loc.values[0])
-          puts "Found object #{loc}" if ENV['DEBUG']
         else
           obj = obj.find_element(loc.keys[0], loc.values[0])
-          puts "Found object #{loc}" if ENV['DEBUG']
         end
+        puts "Found section object #{loc}" if ENV['DEBUG']
       end
       obj
     rescue

data/lib/testcentricity_mobile/app_elements/radio.rb

@@ -0,0 +1,56 @@
+module TestCentricity
+  module AppElements
+    class AppRadio < AppUIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :radio
+      end
+
+      # Is radio selected?
+      #
+      # @return [Boolean]
+      # @example
+      #   unicode_radio.selected?
+      #
+      def selected?
+        obj = element
+        object_not_found_exception(obj)
+        obj.selected?
+      end
+
+      # Set the selected state of a radio button object.
+      #
+      # @example
+      #   unicode_radio.select
+      #
+      def select
+        set_selected_state(true)
+      end
+
+      # Unselect a radio button object.
+      #
+      # @example
+      #   unicode_radio.unselect
+      #
+      def unselect
+        set_selected_state(false)
+      end
+
+      # Set the selected state of a radio button object.
+      #
+      # @param state [Boolean] true = selected / false = unselected
+      # @example
+      #   ascii_radio.set_selected_state(true)
+      #
+      def set_selected_state(state)
+        obj = element
+        object_not_found_exception(obj)
+        if state
+          obj.click unless obj.selected?
+        else
+          obj.click if obj.selected?
+        end
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityMobile
-  VERSION = '4.0.5'
+  VERSION = '4.0.7'
 end

data/lib/testcentricity_mobile.rb

@@ -19,6 +19,7 @@ require 'testcentricity_mobile/app_elements/app_element'
 require 'testcentricity_mobile/app_elements/button'
 require 'testcentricity_mobile/app_elements/checkbox'
 require 'testcentricity_mobile/app_elements/label'
+require 'testcentricity_mobile/app_elements/radio'
 require 'testcentricity_mobile/app_elements/switch'
 require 'testcentricity_mobile/app_elements/textfield'
 require 'testcentricity_mobile/app_elements/list'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_mobile
 version: !ruby/object:Gem::Version
-  version: 4.0.5
+  version: 4.0.7
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-28 00:00:00.000000000 Z
+date: 2024-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -212,14 +212,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.20.0
+        version: 4.20.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.20.0
+        version: 4.20.1
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -276,6 +276,7 @@ files:
 - lib/testcentricity_mobile/app_elements/image.rb
 - lib/testcentricity_mobile/app_elements/label.rb
 - lib/testcentricity_mobile/app_elements/list.rb
+- lib/testcentricity_mobile/app_elements/radio.rb
 - lib/testcentricity_mobile/app_elements/switch.rb
 - lib/testcentricity_mobile/app_elements/textfield.rb
 - lib/testcentricity_mobile/appium_server.rb