testcentricity_mobile 4.0.6 → 4.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e1afd0a24821f3a9f989076f77b8db1d62101e17a32e08e88d8b7e239f00d97
-  data.tar.gz: 137d9919f210bb16ca354a1d2933eb39952689635751981dcc5502ee1c888768
+  metadata.gz: fa7ae2f538647efddd759d3958b2def1c3dd73cb68772a23310397c49e23b556
+  data.tar.gz: 15a31c256250cbaa3670a467469e3386c0467883facb23026b662a383ac81722
 SHA512:
-  metadata.gz: 218154425c571a1b3d0beee6225a69e084306bb630f3e4afa0c089708b4b77ac10a76a03251f690a89da09f0f1cf03e54d92de68ba99348c0017823d7a76a164
-  data.tar.gz: 36db158541dbbc17e4caba7a8cca270ea2fa88bfd5ea1ac01bafb1798a249d77f6427560e01cf3fab16da652ab9a5229c962e3c1771f031d8022911a11ba36fc
+  metadata.gz: 1b1b5323763138cce0d95a8b0b2dc142dfce8f39c4d45cacc13bfc5a7420d49d0b16a766108421dbc25d9c9043c22131257434347f7a44cac3839569337fcd3c
+  data.tar.gz: e1004a41f10e1983e94d2dd659aa0abd3543227ac6e831b931f20eafd21133fc456ee7bff85eddf869cddad92a58a2d3e2f85fbbb58bf1a956191d1ef6b12cdd

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 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

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

@@ -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)

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.6'
+  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.6
+  version: 4.0.7
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-02 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