testimonium 0.1.8.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ea1172299455bf2f567e668935e486f0083596cde9c18a712d8dfe05430c98a
-  data.tar.gz: 83a31af4c097b0190a8ed63dd836738481286446f3bd5438f60bfcb8777215cd
+  metadata.gz: 8d6661e3f0e21f8df37dd23a84fc92092445b8d9a6e256876b0661b3615206d7
+  data.tar.gz: e9c06ae626a5835604507cc18d0358b453b14ada9ae5a03b97ee0eaebe026df7
 SHA512:
-  metadata.gz: 541004e4b15ec3ef3f13dbd220ba43af9a93458c998dafad296c9110576e8fbfb2c4e63dcb9ac13acaa2add4ac9c49aea6889bd23e161acc236d9bd539d78a4b
-  data.tar.gz: acbc68065e3a4673f6d21c5bfcbb8e292804c235e46e706f24c3d3cb408d0721a98d1943fca0332aee396399ab407249d04cfa37bfc1787877b8e6ec38564deb
+  metadata.gz: 731ef578679790ce44444ec4cb9d01efe81d4ca95195b4e4b5b5cd500c8bea498ff8e63b94862c84d93671eb1ff70a4907c88f974669f53e13e462819eea5693
+  data.tar.gz: 27c500ed8845606215f33485c1d061eba4a6f5c98ab15b732b264cc16a9df6d6b3b032eddc6b8b90e9aa2a3dd4247bdd6fb513502aa537ab5debe35b3696431a

data/bin/testimonium

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'testimonium'
 

data/lib/testimonium.rb

@@ -4,8 +4,11 @@
 module Testimonium
   require 'testimonium/cli'
   require 'testimonium/version'
-  require 'testimonium/iosHelpFunctions'
-  require 'testimonium/tapFunctions'
-  require 'testimonium/validateFunctions'
-  require 'testimonium/findFunctions'
+  require 'testimonium/help_functions'
+  require 'testimonium/tap_functions'
+  require 'testimonium/validate_functions'
+  require 'testimonium/find_functions'
+  include Testimonium::Find
+  include Testimonium::Tap
+  include Testimonium::Validate
 end

data/lib/testimonium/cli.rb

@@ -37,9 +37,9 @@ module Testimonium
           when nil
             print_usage
           else
-            fail("Invalid command #{argument}.\nFor help use 'testimonium help'")
+            raise("Invalid command #{argument}.\nFor help use 'testimonium help'")
           end
-        rescue => e
+        rescue StandardError => e
           puts e.message.to_s
           exit 1
         end

data/lib/testimonium/cli/helpers.rb

@@ -4,7 +4,7 @@ module Testimonium
   module CLI
     # Contains helper functions for CLI scripts
     module Helpers
-      def print_usage(output = STDOUT)
+      def print_usage(output = $stdout)
         output.write <<~EOF
           testimonium [options] <command-name> [command specific options]
         EOF

data/lib/testimonium/find_functions.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Testimonium
+  # Find functions
+  module Find
+    # Find element by xpath
+    def find_element_by_xpath(path, timeout = 3, retries = 5)
+      element = nil
+      count = 0
+
+      retries.times do
+        sleep timeout
+        count += 1
+
+        begin
+          element = find_element(:xpath, path)
+        rescue Selenium::WebDriver::Error::NoSuchElementError
+        end
+
+        log("Found on attempt #{count}") if element
+        return element if element
+      end
+
+      log("Failed to find: '#{path}'. Number of attempts: #{count}")
+      false
+    end
+
+    # Find element by element id
+    def find_element_by_id(id_string, timeout = 2, retries = 5)
+      find_element_id(id_string, timeout, retries)
+    end
+
+    # Find element by text
+    def find_element_by_text(text_string, timeout = 2, retries = 5)
+      if device_android
+        return find_element_by_xpath("//*[@text='#{text_string}']", timeout, retries)
+      end
+      return find_text_ios(text_string, timeout, retries) if device_ios
+    end
+
+    # Android only: Needs app package name set as const. _ANDROID_PACKAGE_
+    def find_element_by_resourceid(id, timeout = 2, retries = 5)
+      if defined?(ANDROID_PACKAGE).nil?
+        log('ANDROID_PACKAGE variable is missing.')
+        raise Selenium::WebDriver::Error::NoSuchElementError
+      end
+
+      find_element_by_xpath("//*[@resource-id='#{ANDROID_PACKAGE}:id/#{id}']", timeout, retries)
+    end
+
+    # Needs app package name set as const. _ANDROID_PACKAGE_
+    def find_all_elements_by_id(id_string, timeout = 2, retries = 5)
+      list = nil
+
+      retries.times do
+        sleep timeout
+
+        begin
+          list = ids(id_string) if device_android
+          list = find_elements(:id, id_string) if device_ios
+        rescue Selenium::WebDriver::Error::NoSuchElementError
+        end
+
+        return list if list
+      end
+
+      false
+    end
+  end
+end

data/lib/testimonium/help_functions.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+def find_function(function_type, parameter, timeout_time = 2, retries = 5)
+  element = nil
+  count = 0
+
+  retries.times do
+    sleep timeout_time
+    count += 1
+
+    begin
+      element = id(parameter) if function_type.eql?('id')
+      element = text(parameter) if function_type.eql?('text')
+    rescue Selenium::WebDriver::Error::NoSuchElementError
+    end
+
+    log("Found: '#{parameter}' on attempt #{count}") if element
+    return element if element
+  end
+
+  log("Failed to find: '#{function_type} = #{parameter}'. Number of attempts: #{count}")
+  false
+end
+
+def find_text_ios(parameter, timeout = 2, retries = 5)
+  find_function('text', parameter, timeout, retries)
+end
+
+def find_element_id(parameter, timeout = 2, retries = 5)
+  find_function('id', parameter, timeout, retries)
+end
+
+def device_android
+  ENV['PLATFORM'] == 'android'
+end
+
+def device_ios
+  ENV['PLATFORM'] == 'ios'
+end

data/lib/testimonium/tap_functions.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Testimonium
+  # Tap functions
+  module Tap
+    # Tap element by element id
+    def tap_element_by_id(id_string, timeout = 2, retries = 5)
+      find_element_by_id(id_string, timeout, retries).click
+    end
+
+    # Tap element by text
+    def tap_element_by_text(text_string, timeout = 2, retries = 5)
+      find_element_by_text(text_string, timeout, retries).click if device_android
+      find_text_ios(text_string, timeout, retries).click if device_ios
+    end
+
+    # Tap element by xpath
+    def tap_element_by_xpath(path, timeout = 2, retries = 5)
+      find_element_by_xpath(path, timeout, retries).click
+    end
+
+    # Android only: Needs app package name set as const. _ANDROID_PACKAGE_
+    def tap_element_by_resourceid(id, timeout = 2, retries = 5)
+      if defined?(ANDROID_PACKAGE).nil?
+        log('ANDROID_PACKAGE variable is missing.')
+        raise Selenium::WebDriver::Error::NoSuchElementError
+      end
+
+      find_element_by_resourceid(id, timeout, retries).click
+    end
+  end
+end

data/lib/testimonium/validate_functions.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Testimonium
+  # Validate functions
+  module Validate
+    # Validate element by element id
+    def validate_element_by_id(id, timeout = 2, retries = 5)
+      unless find_element_by_id(id, timeout, retries)
+        raise Selenium::WebDriver::Error::NoSuchElementError
+      end
+    end
+
+    # Validate element by text
+    def validate_element_by_text(text, timeout = 5, retries = 5)
+      unless find_element_by_text(text, timeout, retries)
+        raise Selenium::WebDriver::Error::NoSuchElementError
+      end
+    end
+
+    # Validate element by xpath
+    def validate_element_by_xpath(path, timeout = 2, retries = 5)
+      unless find_element_by_xpath(path, timeout, retries)
+        raise Selenium::WebDriver::Error::NoSuchElementError
+      end
+    end
+
+    # Android only: Needs app package name set as const. _ANDROID_PACKAGE_
+    def validate_element_by_resourceid(id, timeout = 2, retries = 5)
+      unless find_element_by_resourceid(id, timeout, retries)
+        raise Selenium::WebDriver::Error::NoSuchElementError
+      end
+    end
+  end
+end

data/lib/testimonium/version.rb

@@ -2,5 +2,5 @@
 
 # Current version
 module Testimonium
-  VERSION = '0.1.8.2'
+  VERSION = '1.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: testimonium
 version: !ruby/object:Gem::Version
-  version: 0.1.8.2
+  version: 1.2.0
 platform: ruby
 authors:
 - M2mobi
@@ -56,10 +56,10 @@ files:
 - lib/testimonium/cli/helpers.rb
 - lib/testimonium/cli/run.rb
 - lib/testimonium/cli/templates/env.rb.template
-- lib/testimonium/findFunctions.rb
-- lib/testimonium/iosHelpFunctions.rb
-- lib/testimonium/tapFunctions.rb
-- lib/testimonium/validateFunctions.rb
+- lib/testimonium/find_functions.rb
+- lib/testimonium/help_functions.rb
+- lib/testimonium/tap_functions.rb
+- lib/testimonium/validate_functions.rb
 - lib/testimonium/version.rb
 homepage: 
 licenses:
@@ -73,7 +73,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -83,5 +83,5 @@ requirements: []
 rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
-summary: testimonium-0.1.8.2
+summary: testimonium-1.2.0
 test_files: []

data/lib/testimonium/findFunctions.rb

@@ -1,46 +0,0 @@
-############
-### Find ###
-############
-
-  # Find element by xpath
-  def find_element_by_xpath(path, timeout = 2, retries = 5)
-    element = nil
-
-    retries.times do
-      sleep timeout
-
-      begin
-        element = find_element(:xpath, path)
-        rescue Selenium::WebDriver::Error::NoSuchElementError
-      end
-
-      return element if element
-    end
-
-    false
-  end
-
-  # Find element by element resource-id (Android only)
-  # 
-  # Needs app package name set as const. _ANDROID_PACKAGE_
-  def find_element_by_resourceid(id, timeout = 2, retries = 5)
-    find_element_by_xpath("//*[@resource-id='#{ANDROID_PACKAGE}:id/#{ id }']", timeout, retries)
-  end
-
-  # Find element by element id
-  def find_element_by_id(idString, timeout = 2, retries = 5)
-    if ENV['PLATFORM'] == 'android'
-      find_element_by_xpath("//*[@id='#{ idString }']", timeout, retries)
-    elsif ENV['PLATFORM'] == 'ios'
-      find_id_ios(idString)
-    end
-  end
-
-  # Find element by text
-  def find_element_by_text(textString, timeout = 2, retries = 5)
-    if ENV['PLATFORM'] == 'android'
-      find_element_by_xpath("//*[@text='#{ textString }']", timeout, retries)
-    elsif ENV['PLATFORM'] == 'ios'
-      find_text_ios(textString)
-    end
-  end

data/lib/testimonium/iosHelpFunctions.rb

@@ -1,25 +0,0 @@
-def find_text_ios(parameter, timeout = 2, retries = 5)
-  findFunctionForIos('text', parameter)
-end
-
-def find_id_ios(parameter, timeout = 2, retries = 5)
-  findFunctionForIos('id', parameter)
-end
-
-def findFunctionForIos(functionType, parameter, timeout = 2, retries = 5)
-  element = nil
-
-  retries.times do
-    sleep timeout
-
-    begin
-      element = id(parameter) if functionType.eql?('id')
-      element = text(parameter) if functionType.eql?('text')
-      rescue Selenium::WebDriver::Error::NoSuchElementError
-    end
-
-    return element if element
-  end
-
-  false
-end

data/lib/testimonium/tapFunctions.rb

@@ -1,33 +0,0 @@
-############  
-### TAP ###
-############
-
-# Tap element by element id
-def tap_element_by_id(idString, timeout = 2, retries = 5)
-  if ENV['PLATFORM'] == 'android'
-    find_element_by_id(idString, timeout, retries).click
-  elsif ENV['PLATFORM'] == 'ios'
-    find_id_ios(idString).click
-  end
-end
-
-# Tap element by resource-id (Android only)
-# 
-# Needs app package name set as const. _ANDROID_PACKAGE_
-def tap_element_by_resourceid(id, timeout = 2, retries = 5)
-  find_element_by_resourceid(id, timeout, retries).click
-end
-
-# Tap element by text
-def tap_element_by_text(textString, timeout = 2, retries = 5)
-  if ENV['PLATFORM'] == 'android'
-    find_element_by_text(textString, timeout, retries).click
-  elsif ENV['PLATFORM'] == 'ios'
-    find_text_ios(textString).click
-  end
-end
-
-# Tap element by xpath
-def tap_element_by_xpath(path, timeout = 2, retries = 5)
-  find_element_by_xpath(path, timeout, retries).click
-end

data/lib/testimonium/validateFunctions.rb

@@ -1,39 +0,0 @@
-################ 
-### Validate ###
-################
-
-# Validate element by element id
-def validate_element_by_id(id, timeout = 2, retries = 5)
-  unless find_element_by_id(id, timeout, retries)
-    raise Selenium::WebDriver::Error::NoSuchElementError
-  end
-end
-
-# Validate element by resource-id (Android only)
-# 
-# Needs app package name set as const. _ANDROID_PACKAGE_
-def validate_element_by_resourceid(id, timeout = 2, retries = 5)
-  unless find_element_by_resourceid(id, timeout, retries)
-    raise Selenium::WebDriver::Error::NoSuchElementError
-  end
-end
-
-# Validate element by text
-def validate_element_by_text(text, timeout = 2, retries = 5)
-  if ENV['PLATFORM'] == 'android'
-    unless find_element_by_text(text, timeout, retries)
-      raise Selenium::WebDriver::Error::NoSuchElementError
-    end
-  elsif ENV['PLATFORM'] == 'ios'
-    unless find_text_ios(text, timeout, retries)
-      raise Selenium::WebDriver::Error::NoSuchElementError
-    end
-  end
-end
-
-# Validate element by xpath
-def validate_element_by_xpath(path, timeout = 2, retries = 5)
-  unless find_element_by_xpath(path, timeout, retries)
-    raise Selenium::WebDriver::Error::NoSuchElementError
-  end
-end