testcentricity_apps 4.0.15 → 4.1.1

data/lib/testcentricity_apps/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_apps/data_objects/environment.rb

@@ -1,9 +1,6 @@
 module TestCentricity
   class EnvironData < TestCentricity::DataSource
-    attr_accessor	:current
-    attr_accessor :data_source_type
-    attr_accessor	:generic_data
-    attr_accessor	:environ_specific_data
+    attr_accessor :current, :data_source_type, :generic_data, :environ_specific_data
 
     def self.find_environ(environ_name, source_type = :yaml)
       raise 'No environment specified' if environ_name.nil?
@@ -23,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)
@@ -42,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']
@@ -71,56 +61,8 @@ module TestCentricity
     @language = ENV['LANGUAGE'] || 'English'
     @screen_shots = []
 
-    attr_accessor :test_environment
-    attr_accessor :session_state
-    attr_accessor :session_code
-    attr_accessor :app_session_id
-    attr_accessor :os
-    attr_accessor :device
-    attr_accessor :device_name
-    attr_accessor :device_type
-    attr_accessor :device_os
-    attr_accessor :device_os_version
-    attr_accessor :device_orientation
-    attr_accessor :screen_size
-    attr_accessor :platform
-    attr_accessor :driver
-    attr_accessor :driver_name
-    attr_accessor :appium_driver
-    attr_accessor :tunneling
-    attr_accessor :locale
-    attr_accessor :language
-
-    attr_accessor :parallel
-    attr_accessor :process_num
-
-    attr_accessor :signed_in
-    attr_accessor :portal_status
-    attr_accessor :portal_context
-
-    attr_accessor :user_id
-    attr_accessor :password
-    attr_accessor :app_id
-    attr_accessor :api_key
-    attr_accessor :option1
-    attr_accessor :option2
-    attr_accessor :option3
-    attr_accessor :option4
-    attr_accessor :dns
-    attr_accessor :db_username
-    attr_accessor :db_password
-
-    attr_accessor :ios_app_path
-    attr_accessor :ios_ipa_path
-    attr_accessor :ios_bundle_id
-    attr_accessor :ios_test_id
-    attr_accessor :android_apk_path
-    attr_accessor :android_app_id
-    attr_accessor :android_test_id
-    attr_accessor :default_max_wait_time
-    attr_accessor :deep_link_prefix
-
-    attr_accessor :mac_bundle_id
+    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)
       @user_id	     = data['USER_ID']
@@ -143,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/exception_queue_helper.rb

@@ -1,7 +1,6 @@
 module TestCentricity
   class ExceptionQueue
-    attr_accessor :error_queue
-    attr_accessor :active_ui_element
+    attr_accessor :error_queue, :active_ui_element
 
     def self.enqueue_assert_equal(expected, actual, error_message)
       is_equal = if expected.is_a?(String) && actual.is_a?(String)
@@ -9,17 +8,17 @@ module TestCentricity
                  else
                    expected == actual
                  end
-      unless is_equal
-        enqueue("#{error_message} to be\n  '#{expected}'\nbut found\n  '#{actual}'")
-        enqueue_screenshot
-      end
+      return if is_equal
+
+      enqueue("#{error_message} to be\n  '#{expected}'\nbut found\n  '#{actual}'")
+      enqueue_screenshot
     end
 
     def self.enqueue_assert_not_equal(expected, actual, error_message)
-      unless expected != actual
-        enqueue("#{error_message} to not be equal to '#{expected}'")
-        enqueue_screenshot
-      end
+      return if expected != actual
+
+      enqueue("#{error_message} to not be equal to '#{expected}'")
+      enqueue_screenshot
     end
 
     def self.enqueue_exception(error_message)

data/lib/testcentricity_apps/utility_helpers.rb

@@ -17,6 +17,7 @@ class String
   def to_bool
     return true if self == true || self =~ (/(true|t|yes|y|x|1)$/i)
     return false if self == false || self.blank? || self =~ (/(false|f|no|n|0)$/i)
+
     raise ArgumentError.new("invalid value for Boolean: \"#{self}\"")
   end
 

data/lib/testcentricity_apps/version.rb

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

data/lib/testcentricity_apps.rb

@@ -27,6 +27,7 @@ require 'testcentricity_apps/app_elements/menubar'
 require 'testcentricity_apps/app_elements/radio'
 require 'testcentricity_apps/app_elements/selectlist'
 require 'testcentricity_apps/app_elements/switch'
+require 'testcentricity_apps/app_elements/table'
 require 'testcentricity_apps/app_elements/textfield'
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_apps
 version: !ruby/object:Gem::Version
-  version: 4.0.15
+  version: 4.1.1
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-13 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: 9.2.0
+        version: 10.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 9.2.0
+        version: 10.2.0
 - !ruby/object:Gem::Dependency
   name: parallel_tests
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.13.0
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.39.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.39.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -122,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: 15.2.2
+        version: 16.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 15.2.2
+        version: 16.1.1
 - !ruby/object:Gem::Dependency
   name: childprocess
   requirement: !ruby/object:Gem::Requirement
@@ -207,19 +235,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: selenium-webdriver
+  name: smarter_csv
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.26.0
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.26.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -281,6 +309,7 @@ files:
 - lib/testcentricity_apps/app_elements/radio.rb
 - lib/testcentricity_apps/app_elements/selectlist.rb
 - lib/testcentricity_apps/app_elements/switch.rb
+- lib/testcentricity_apps/app_elements/table.rb
 - lib/testcentricity_apps/app_elements/textfield.rb
 - lib/testcentricity_apps/appium_server.rb
 - lib/testcentricity_apps/data_objects/data_objects_helper.rb
@@ -306,7 +335,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -314,7 +343,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Appium
-rubygems_version: 3.3.26
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A Screen Object Model Framework for MacOS desktop app and iOS and/or Android