testcentricity_mobile 4.1.6 → 4.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae8677f880d39fd72ae439f29c84d531c75ef52db5f0854005ed68bd04443e4a
-  data.tar.gz: 531df29401e26c9544f9fc65d0c16651879aafaf90682b2b2b6e1497b6dad839
+  metadata.gz: 4961bdc97a13ad7e08236fad109326f00a67a8d790a79257cb44691f1c435d61
+  data.tar.gz: 3b82d3cfb16db8d46264fb149ac8bf0d34866c437e5461e92f14b26697dfea09
 SHA512:
-  metadata.gz: 9c8d3586d71645951b4ffbfb1330f640ea4b5536b570394fe8d3d40fcd7ea29a4b2331bf8d933a672ff151ef7e4ac6a93ecafec9ad200af414ce68b7ef95ee81
-  data.tar.gz: f57743549f4439b9eeb0c922c522dc970e0ebda8ac21ad15c991f53bd86301198c7c780fab714471af34211fe214ace14bc5653ef71d01ac882b6d22e5252783
+  metadata.gz: 581d29d4727c72b30aa217a16cb91e542d05c183beba6f912788852b7dccebeb8ca3ea6d467298145509ea2efda4bc8115b31c8243dfbc6ac51bf2ad4da4baf4
+  data.tar.gz: 1a330c7e44dde5c2e727d02e47c4bf8d9048b6ccd2a6af0e129882533ce81564f8f9cccfc7ddedf6fc57175f96c3d5f6702332acfbcdca1430658c452ed5722e

data/CHANGELOG.md

@@ -2,6 +2,33 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.1.8] - 13-JAN-2026
+
+### Added
+* Added `activesupport` gem as a runtime dependency to prevent test failures if gem is not already installed.
+* 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.
+* Updated `appium_lib` gem to version 16.1.1.
+* Updated `appium_lib_core` gem to version 11.2.0.
+
+### Removed
+* Unused `DataObject` class has been removed.
+* Removed unused `DataSource.read_yaml_node_data` and `DataSource.read_json_node_data` methods.
+
+
+## [4.1.7] - 25-NOV-2025
+
+### Changed
+
+* Appium version 1.x is no longer supported.
+
+
 ## [4.1.6] - 04-OCT-2025
 
 ### Changed

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

@@ -95,12 +95,12 @@ A **Screen Object** is an object that represents a single screen in your AUT (Ap
 encapsulate the implementation details of a mobile app screen and expose an API that supports interaction with, and validation
 of the UI elements on the screen.
 
-**Screen Objects** makes it easier to maintain automated tests because changes to screen UI elements are updated in only
-one location - in the `ScreenObject` class definition. By adopting a **Screen Object Model**, Cucumber feature files and
-step definitions are no longer required to hold specific information about a screen's UI objects, thus minimizing maintenance
-requirements. If any element on, or property of a screen changes (text field attributes, button captions, element states,
-etc.), maintenance is performed in the `ScreenObject` class definition only, typically with no need to update the affected
-feature files, scenarios, or step definitions.
+**Screen Objects** makes it easier to maintain automated tests because changes to a screen's UI elements are updated in
+only one location - in the corresponding `ScreenObject` class definition. By adopting a **Screen Object Model**, Cucumber
+feature files and step definitions are no longer required to hold specific information about a screen's UI objects, thus
+minimizing maintenance requirements. If any element on, or property of a screen changes (text field attributes, button
+captions, element states, etc.), maintenance is performed in the corresponding `ScreenObject` class definition only, typically
+with no need to update the affected feature files, scenarios, or step definitions.
 
 
 ### Defining a ScreenObject
@@ -1200,10 +1200,6 @@ Refer to [this page](https://appium.io/docs/en/2.4/guides/caps/) for information
 to invoking Cucumber to run your features/scenarios on locally hosted iOS or Android simulators or physical devices. Refer
 to [**section 8.2.3 (Starting and Stopping Appium Server)**](#starting-and-stopping-appium-server) below.
 
-⚠️ If you are running locally hosted mobile tests on iOS or Android simulators or devices using version 1.x of the Appium
-server, the `APPIUM_SERVER_VERSION` environment variable must be set to `1` in order to ensure that the correct Appium server
-endpoint is used.
-
 #### Connecting to Locally Hosted iOS Simulators or Physical Devices
 
 You can run your automated tests on locally hosted iOS simulators or physically connected devices using Appium and XCode
@@ -1420,13 +1416,6 @@ starting your Cucumber test suite(s):
 
     run_appium: APPIUM_SERVER=run
 
-If you are running locally hosted mobile tests on iOS or Android simulators or devices using version 1.x of the Appium server,
-the `APPIUM_SERVER_VERSION` environment variable must be set to `1` in order to ensure that the correct Appium server endpoint
-is used. This can be set by adding the following to your `cucumber.yml` file and including `-p appium_1x` in your command line
-when starting your Cucumber test suite(s):
-
-    appium_1x: APPIUM_SERVER_VERSION=1
-
 Refer to [**section 8.4 (Using Configuration Specific Profiles in `cucumber.yml`)**](#using-configuration-specific-profiles-in-cucumber-yml) below.
 
 
@@ -1447,9 +1436,6 @@ body of an example group:
       $server.stop if Environ.driver == :appium && $server.running?
     end
 ```
-If you are running locally hosted mobile tests on iOS or Android simulators or devices using version 1.x of the Appium server,
-the `APPIUM_SERVER_VERSION` environment variable must be set to `1` in order to ensure that the correct Appium server endpoint
-is used.
 
 
 ###  Connecting to Remote Cloud Hosted iOS and Android Simulators or Physical Devices
@@ -1873,7 +1859,6 @@ with access to your version control system.
     # physical devices
     #==============
     run_appium: APPIUM_SERVER=run
-    appium_1x: APPIUM_SERVER_VERSION=1
 
 
     #==============
@@ -2025,7 +2010,7 @@ the `/features/support/<platform>/sections` folder, where `<platform>` is typica
 ---
 ## Copyright and License
 
-TestCentricity™ Framework is Copyright (c) 2014-2025, Tony Mrozinski.
+TestCentricity™ Framework is Copyright (c) 2014-2026, Tony Mrozinski.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/lib/testcentricity_mobile/app_core/appium_connect_helper.rb

@@ -390,13 +390,7 @@ module TestCentricity
 
     def self.appium_local_capabilities
       # specify endpoint url
-      if @endpoint.nil?
-        @endpoint = if ENV['APPIUM_SERVER_VERSION'] && ENV['APPIUM_SERVER_VERSION'].to_i == 1
-                      'http://127.0.0.1:4723/wd/hub'
-                    else
-                      'http://127.0.0.1:4723'
-                    end
-      end
+      @endpoint = 'http://127.0.0.1:4723' if @endpoint.nil?
       # define local Appium capabilities
       if @capabilities.nil?
         Environ.device_name = ENV['APP_DEVICE']

data/lib/testcentricity_mobile/app_core/screen_objects_helper.rb

@@ -51,6 +51,16 @@ module TestCentricity
       timeout = wait_time.nil? ? 2 : wait_time
       data.each do |data_field, data_param|
         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/lib/testcentricity_mobile/appium_server.rb

@@ -38,11 +38,7 @@ module TestCentricity
     # Check to see if Appium Server is running
     #
     def running?
-      endpoint = if ENV['APPIUM_SERVER_VERSION'] && ENV['APPIUM_SERVER_VERSION'].to_i == 1
-                   'http://0.0.0.0:4723/wd/hub/sessions'
-                 else
-                   'http://0.0.0.0:4723/sessions'
-                 end
+      endpoint = 'http://0.0.0.0:4723/sessions'
       response = false
       begin
         response = Net::HTTP.get_response(URI(endpoint))

data/lib/testcentricity_mobile/data_objects/data_objects_helper.rb

@@ -1,47 +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
-    attr_accessor :context
-    attr_accessor :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
-    attr_accessor :context
-
-    def initialize(data)
-      self.attributes = data unless data.nil?
-    end
 
     def self.current
       @current
@@ -53,48 +34,162 @@ module TestCentricity
   end
 
 
-# :nocov:
   class DataSource
     attr_accessor :file_path
-    attr_accessor :node
+    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_mobile/data_objects/environment.rb

@@ -23,8 +23,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)
@@ -42,27 +41,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']
@@ -71,6 +64,7 @@ module TestCentricity
     @language = ENV['LANGUAGE'] || 'English'
     @screen_shots = []
 
+    attr_accessor :current
     attr_accessor :test_environment
     attr_accessor :session_state
     attr_accessor :session_code
@@ -140,8 +134,14 @@ module TestCentricity
       @android_app_id   = data['ANDROID_APP_ID']
       @android_test_id  = data['ANDROID_TEST_ID']
       @deep_link_prefix = data['DEEP_LINK_PREFIX']
+    end
+
+    def self.current
+      @current
+    end
 
-      super
+    def self.current=(current)
+      @current = current
     end
 
     def self.new_app_session

data/lib/testcentricity_mobile/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityMobile
-  VERSION = '4.1.6'
+  VERSION = '4.1.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_mobile
 version: !ruby/object:Gem::Version
-  version: 4.1.6
+  version: 4.1.8
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-04 00:00:00.000000000 Z
+date: 2026-01-13 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.0
+        version: 10.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.1.0
+        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.36.0
+        version: 4.39.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.36.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