testcentricity_apps 4.1.0 → 4.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b4e82b184c5597d7aec89e022b126b08f005daa00519c60dfd2907edaeef661
-  data.tar.gz: 2035f556dcd2f033655c4edcf65d2ba1c7b2661cc920e052abef475178e5d681
+  metadata.gz: b9ac02a673f61d2ac2e77b8b24c00adfd27c73caa78ffb28e28279f311bcf838
+  data.tar.gz: 2bbf12bcfd0008f92dcd2a79d7a050cc6ff5fcc9dfee48b14a2e2162ec83f04f
 SHA512:
-  metadata.gz: 783f2dff9161ff6fa835a410ed4baa0e2ad67bd8ddc5fffebaad70f85f178d82a8edf1d0cb9995156a2f1783c3c5687de71359634d99f5f13312958f5e91a848
-  data.tar.gz: af7d790c29b515dd86af8201b1032ca6d1bc8e308453ea6c3b6ecc67d931e59e8b3d15cdca914f2cf937855827016e0f69f2ad4717a4f7733ebea3b15feffa29
+  metadata.gz: dbf72b0b195024e207159ed83d37086e9b1eac1d5946c93dc1950a768687bd9f12edd387c5373e52917c91a371754138b1577534a5a7c3c57b31c158ecfda974
+  data.tar.gz: 2890798258cb79be67cb85ebce8525504f5f19ae9378d323af2f037c578032dea5839e50bca178450895d4814e71c989c02f3635224ec5b9864f3859f9ffa26b

data/CHANGELOG.md

@@ -2,6 +2,32 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.1.1] - 03-FEB-2026
+
+
+### Added
+* Updated `ScreenObject.verify_ui_states` and `ScreenSection.verify_ui_states` methods to support verification of the following
+  `AppTable` properties:
+  * `rowcount`
+  * `columncount`
+  * `column_headers`
+  * `row`
+  * `column`
+  * `cell`
+* Added `DataSource.read_file` method capable of reading from `.yml`, `.json`, `.csv`, or `.xml` data files, and accepting
+  `options` hash for specifying hash key and value conversions to data being read prior to passing to `DataPresenter` objects.
+
+### Changed
+* Refactored `EnvironData.read` method to allow passing `options` hash for specifying hash key and value conversions to
+  data being read prior to passing to `DataPresenter` objects.
+* Refactored `ScreenObject.populate_data_fields` and `ScreenSection.populate_data_fields` methods to support passing a
+  `Symbol` for a UI element's name to support using `DataPresenter` object attributes to source data.
+
+### Removed
+* Unused `DataObject` class has been removed.
+* Removed unused `DataSource.read_yaml_node_data` and `DataSource.read_json_node_data` methods.
+
+
 ## [4.1.0] - 09-DEC-2025
 
 ### Added

data/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2025, Tony Mrozinski
+Copyright (c) 2014-2026, Tony Mrozinski
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -2395,7 +2395,7 @@ is typically `mac`, `ios`, or `android`.
 ---
 ## Copyright and License
 
-All TestCentricity™ Frameworks are Copyright (c) 2014-2025, A.J. Mrozinski.
+All TestCentricity™ Frameworks are Copyright (c) 2014-2026, A.J. Mrozinski.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/lib/testcentricity_apps/app_core/screen_objects_helper.rb

@@ -21,7 +21,7 @@ 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, radios and switches,
+    # 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.
     #
@@ -47,25 +47,34 @@ module TestCentricity
     #       security_code_field => UserData.current.cvv
     #     }
     #     populate_data_fields(fields)
-    #
     def populate_data_fields(data, wait_time = nil)
       timeout = wait_time.nil? ? 2 : wait_time
       data.each do |data_field, data_param|
-        next if data_param.blank?
-
-        # make sure the intended UI target element is visible before trying to set its value
-        data_field.scroll_into_view unless data_field.wait_until_visible(timeout, post_exception = false)
-        if data_param == '!DELETE'
-          data_field.clear
-        else
-          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
+        unless data_param.blank?
+          # if data_field is a Symbol, find the corresponding object reference
+          if data_field.is_a?(Symbol)
+            begin
+              obj = method(data_field)
+            rescue
+              puts "No corresponding data field found for #{data_field}" if ENV['DEBUG']
+              next
+            end
+            data_field = obj.call
+          end
+          # make sure the intended UI target element is visible before trying to set its value
+          data_field.scroll_into_view unless data_field.wait_until_visible(timeout, post_exception = false)
+          if data_param == '!DELETE'
             data_field.clear
-            data_field.set(data_param)
+          else
+            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)
+            end
           end
         end
       end
@@ -84,7 +93,7 @@ module TestCentricity
         object_states.each do |property, state|
           actual = case property
                    when :visible
-                     if auto_scroll && state && !Environ.is_macos?
+                     if auto_scroll && state
                        ui_object.scroll_into_view if ui_object.hidden?
                      end
                      ui_object.visible?
@@ -112,12 +121,6 @@ module TestCentricity
                      ui_object.read_only?
                    when :maxlength
                      ui_object.get_max_length
-                   when :rowcount
-                     ui_object.get_row_count
-                   when :columncount
-                     ui_object.get_column_count
-                   when :column_headers
-                     ui_object.get_header_columns
                    when :items
                      ui_object.get_list_items
                    when :itemcount
@@ -134,14 +137,16 @@ module TestCentricity
                      ui_object.count
                    when :buttons
                      ui_object.buttons
-                   when :identifier
-                     ui_object.identifier
-                   when :title
-                     ui_object.title
+                   when :rowcount
+                     ui_object.get_row_count
+                   when :columncount
+                     ui_object.get_column_count
+                   when :column_headers
+                     ui_object.get_header_columns
                    when :item_data
                      ui_object.get_item_data
                    else
-                     if property.is_a?(Hash)
+                   if property.is_a?(Hash)
                        property.map do |key, value|
                          case key
                          when :item
@@ -150,12 +155,12 @@ module TestCentricity
                            ui_object.get_item_enabled(value.to_i)
                          when :item_data
                            ui_object.get_item_data(value.to_i)
+                         when :cell
+                           ui_object.get_table_cell(value[0].to_i, value[1].to_i)
                          when :row
                            ui_object.get_table_row(value.to_i)
                          when :column
                            ui_object.get_table_column(value.to_i)
-                         when :cell
-                           ui_object.get_table_cell(value[0].to_i, value[1].to_i)
                          else
                            raise "#{key} is not a valid property key"
                          end
@@ -164,11 +169,7 @@ module TestCentricity
                        raise "#{property} is not a valid property"
                      end
                    end
-          error_msg = if ui_object.respond_to?(:get_name)
-                        "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
-                      else
-                        "Expected '#{screen_name}' screen object #{property} property to"
-                      end
+          error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
           ExceptionQueue.enqueue_comparison(ui_object, state, actual, error_msg)
         end
       end
@@ -189,8 +190,7 @@ module TestCentricity
     #   swipe_gesture(direction = :down, distance = 1)
     #
     def swipe_gesture(direction, distance = 0.5)
-      raise 'Scroll distance must be between 0 and 1' if distance.negative? || distance > 1
-
+      raise 'Scroll distance must be between 0 and 1' if (distance < 0 || distance > 1)
       size = window_size
       mid_pt = [(size.width * 0.5).to_i, (size.height * 0.5).to_i]
       top = (mid_pt[1] - ((size.height * distance) * 0.5)).to_i

data/lib/testcentricity_apps/data_objects/data_objects_helper.rb

@@ -1,44 +1,28 @@
-require 'yaml'
-require 'json'
-require 'virtus'
-require 'time'
+require 'active_support'
+require 'active_support/core_ext/hash'
 require 'chronic'
 require 'faker'
+require 'json'
+require 'rexml/document'
+require 'smarter_csv'
+require 'time'
+require 'virtus'
+require 'yaml'
 
 
 module TestCentricity
 
   PRIMARY_DATA_PATH ||= 'config/test_data/'
+  SECONDARY_DATA_PATH ||= 'config/data/'
   PRIMARY_DATA_FILE ||= "#{PRIMARY_DATA_PATH}data."
   YML_PRIMARY_DATA_FILE  ||= "#{PRIMARY_DATA_FILE}yml"
   JSON_PRIMARY_DATA_FILE ||= "#{PRIMARY_DATA_FILE}json"
 
 
-  class DataObject
-    attr_accessor :current, :context, :hash_table
-
-    def initialize(data)
-      @hash_table = data
-    end
-
-    def self.current
-      @current
-    end
-
-    def self.current=(current)
-      @current = current
-    end
-  end
-
-
   class DataPresenter
     include Virtus.model
 
-    attr_accessor :current, :context
-
-    def initialize(data)
-      self.attributes = data unless data.nil?
-    end
+    attr_accessor :current
 
     def self.current
       @current
@@ -50,47 +34,162 @@ module TestCentricity
   end
 
 
-# :nocov:
   class DataSource
-    attr_accessor :file_path, :node
+    attr_accessor :file_path
+    attr_accessor :file_extension
 
-    def read_yaml_node_data(file_name, node_name)
-      @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
-      @node = node_name
-      data = YAML.load_file(@file_path)
-      data[node_name]
+    def read_file(file_name, key = nil, node_name = nil, options = nil)
+      # check to see if full file path was specified
+      if File.exist?(file_name)
+        @file_path = file_name
+      else
+        # construct the full file path to the file to be read
+        @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
+        unless File.exist?(@file_path)
+          @file_path = "#{SECONDARY_DATA_PATH}#{file_name}"
+          raise "File #{file_name} not found in Primary or Secondary folders in config folder" unless File.exist?(@file_path)
+        end
+      end
+      # determine file type and read in data from file
+      @file_extension = File.extname(file_name)
+      data = case @file_extension
+             when '.yml'
+               YAML.load_file(@file_path)
+             when'.json'
+               JSON.parse(File.read(@file_path))
+             when '.xml'
+               xml_data = File.read(@file_path)
+               Hash.from_xml(xml_data)
+             when '.csv'
+               if options
+                 SmarterCSV.process(@file_path, options)
+               else
+                 SmarterCSV.process(@file_path)
+               end
+             else
+               raise "#{file_name} is not a supported file type"
+             end
+      # return data if sourced from a .csv file
+      return data if @file_extension == '.csv'
+
+      # read data from specified key and/or node
+      result = if key
+                 raise "Key #{key} not found" unless data.key?(key)
+
+                 if node_name
+                   raise "Node #{node_name} not found" unless data[key].key?(node_name)
+
+                   data[key][node_name]
+                 else
+                   data[key]
+                 end
+               else
+                 data
+               end
+      self.class.send(:process_data, result, options)
     end
 
-    def read_json_node_data(file_name, node_name)
-      @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
-      @node = node_name
-      raw_data = File.read(@file_path)
-      data = JSON.parse(raw_data)
-      data[node_name]
+    private
+
+    def self.process_data(data, options)
+      # calculate dynamic values if any are specified
+      if data.is_a?(Hash)
+        data.each do |key, value|
+          data[key] = calculate_dynamic_value(value) if value.to_s.start_with?('eval!')
+        end
+      end
+      return data unless options
+
+      # convert keys to symbols if :keys_as_symbols is true in options
+      if options.key?(:keys_as_symbols) && options[:keys_as_symbols]
+        data.transform_keys!(&:to_sym)
+      end
+      # convert values if :value_converters are specified in options
+      if options.key?(:value_converters)
+        map_values(data, options[:value_converters])
+      else
+        data
+      end
     end
 
-    private
+    def self.map_values(data, value_converters)
+      data.each_with_object({}) do |(k, v), new_hash|
+        converter = value_converters[k]
+        v = converter.convert(v) if converter
+        new_hash[k] = v
+      end
+    end
 
     def self.calculate_dynamic_value(value)
       test_value = value.split('!', 2)
       parameter = test_value[1].split('.', 2)
-      case parameter[0]
-      when 'Date'
-        result = eval("Chronic.parse('#{parameter[1]}')")
-      when 'FormattedDate', 'FormatDate'
-        date_time_params = parameter[1].split(' format! ', 2)
-        date_time = eval("Chronic.parse('#{date_time_params[0].strip}')")
-        result = date_time.to_s.format_date_time("#{date_time_params[1].strip}")
-      else
-        result = if Faker.constants.include?(parameter[0].to_sym)
+      result = case parameter[0]
+               when 'Date'
+                 Chronic.parse(parameter[1])
+               when 'FormattedDate', 'FormatDate'
+                 date_time_params = parameter[1].split(' format! ', 2)
+                 date_time = Chronic.parse(date_time_params[0].strip)
+                 date_time.to_s.format_date_time("#{date_time_params[1].strip}")
+               else
+                 if Faker.constants.include?(parameter[0].to_sym)
                    eval("Faker::#{parameter[0]}.#{parameter[1]}")
                  else
                    eval(test_value[1])
                  end
-      end
+               end
       result.to_s
     end
   end
-# :nocov:
 end
 
+
+# perform conversion of String to Boolean when reading data from .csv or .xml files
+class ToBoolean
+  def self.convert(value)
+    value.to_bool unless value.nil?
+  end
+end
+
+
+# perform conversion of Integer to String when reading data from .csv or .xml files
+class ToString
+  def self.convert(value)
+    if value.is_a? Integer
+      value.to_s
+    else
+      value
+    end
+  end
+end
+
+
+# perform conversion of String to Integer when reading data from .csv or .xml files
+class ToInteger
+  def self.convert(value)
+    if value.is_a? Integer
+      value
+    else
+      if value.is_int?
+        value.to_i
+      else
+        value
+      end
+    end
+  end
+end
+
+
+# perform conversion of String to Float when reading data from .csv or .xml files
+class ToFloat
+  def self.convert(value)
+    if value.is_a? Float
+      value
+    else
+      if value.is_float?
+        value.to_f
+      else
+        value
+      end
+    end
+  end
+end

data/lib/testcentricity_apps/data_objects/environment.rb

@@ -20,8 +20,7 @@ module TestCentricity
                read('Environments', environ_name)
              when :json
                # read generic test data from data.json file
-               raw_data = File.read(JSON_PRIMARY_DATA_FILE)
-               @generic_data = JSON.parse(raw_data)
+               @generic_data = JSON.parse(File.read(JSON_PRIMARY_DATA_FILE))
                # read environment specific test data
                data_file = "#{PRIMARY_DATA_PATH}#{environ_name}_data.json"
                @environ_specific_data = if File.exist?(data_file)
@@ -39,27 +38,21 @@ module TestCentricity
       Environ.current = @current
     end
 
-    def self.read(key_name, node_name)
-      if @environ_specific_data.key?(key_name) && @environ_specific_data[key_name].key?(node_name)
-        node_data = @environ_specific_data[key_name][node_name]
-      else
-        raise "No key named #{key_name} in generic and environment-specific data" unless @generic_data.key?(key_name)
-        raise "No node named #{node_name} in #{key_name} section of generic and environment-specific data" unless @generic_data[key_name].key?(node_name)
-
-        node_data = @generic_data[key_name][node_name]
-      end
+    def self.read(key_name, node_name, options = nil)
+      node_data = if @environ_specific_data.key?(key_name) && @environ_specific_data[key_name].key?(node_name)
+                    @environ_specific_data[key_name][node_name]
+                  else
+                    raise "No key named #{key_name} in generic and environment-specific data" unless @generic_data.key?(key_name)
+                    raise "No node named #{node_name} in #{key_name} section of generic and environment-specific data" unless @generic_data[key_name].key?(node_name)
 
-      if node_data.is_a?(Hash)
-        node_data.each do |key, value|
-          node_data[key] = calculate_dynamic_value(value) if value.to_s.start_with?('eval!')
-        end
-      end
-      node_data
+                    @generic_data[key_name][node_name]
+                  end
+      process_data(node_data, options)
     end
   end
 
 
-  class Environ < TestCentricity::DataObject
+  class Environ
     @session_id = Time.now.strftime('%d%H%M%S%L')
     @session_time_stamp = Time.now.strftime('%Y%m%d%H%M%S')
     @test_environment = ENV['TEST_ENVIRONMENT']
@@ -68,6 +61,7 @@ module TestCentricity
     @language = ENV['LANGUAGE'] || 'English'
     @screen_shots = []
 
+    attr_accessor :current
     attr_accessor :test_environment, :session_state, :session_code, :app_session_id, :os, :device, :device_name, :device_type, :device_os, :device_os_version, :device_orientation, :screen_size, :platform, :driver, :driver_name, :appium_driver, :tunneling, :locale, :language, :parallel, :process_num, :signed_in, :portal_status, :portal_context, :user_id, :password, :app_id, :api_key, :option1, :option2, :option3, :option4, :dns, :db_username, :db_password, :ios_app_path, :ios_ipa_path, :ios_bundle_id, :ios_test_id, :android_apk_path, :android_app_id, :android_test_id, :default_max_wait_time, :deep_link_prefix, :mac_bundle_id
 
     def initialize(data)
@@ -91,8 +85,14 @@ module TestCentricity
       @android_test_id  = data['ANDROID_TEST_ID']
       @deep_link_prefix = data['DEEP_LINK_PREFIX']
       @mac_bundle_id = data['MAC_BUNDLE_ID']
+    end
+
+    def self.current
+      @current
+    end
 
-      super
+    def self.current=(current)
+      @current = current
     end
 
     def self.new_app_session

data/lib/testcentricity_apps/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityApps
-  VERSION = '4.1.0'
+  VERSION = '4.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_apps
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 4.1.1
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-10 00:00:00.000000000 Z
+date: 2026-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.1.1
+        version: 10.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.1.1
+        version: 10.2.0
 - !ruby/object:Gem::Dependency
   name: parallel_tests
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.38.0
+        version: 4.39.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.38.0
+        version: 4.39.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -136,20 +136,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: appium_lib
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 16.1.0
+        version: 16.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 16.1.0
+        version: 16.1.1
 - !ruby/object:Gem::Dependency
   name: childprocess
   requirement: !ruby/object:Gem::Requirement
@@ -220,6 +234,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: smarter_csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement