itms_automation 2.3 → 2.6.0

data/lib/itms_automation/methods/click_elements_methods.rb

@@ -0,0 +1,23 @@
+require_relative 'required_files'
+
+def click(element)
+  WAIT.until { find_object(element) }.click
+end
+
+def click_forcefully(element)
+  $driver.execute_script('arguments[0].click();', WAIT.until { find_object(element) })
+end
+
+def double_click(element)
+  found_element = WAIT.until { find_object(element) }
+  $driver.action.double_click(found_element).perform
+end
+
+
+def long_press( element, duration)
+  found_element = WAIT.until { find_object(element) }
+  parameters = { "element" => "#{found_element}", "duration" => "#{duration}" }
+  args = parameters.select { |k, v| [:element, :duration].include? k }
+  args = args_with_ele_ref(args)
+  chain_method(:longPress, args)
+end

data/lib/itms_automation/methods/configuration_methods.rb

@@ -0,0 +1,35 @@
+require_relative 'required_files'
+
+# method to print configuration
+def print_congifugartion
+  puts ''
+  puts "Date : #{Time.now.strftime("%d-%B-%Y")}"
+  puts "Time : #{Time.now.strftime("%I:%M:%S:%p")}"
+
+  if $platform == 'android' or $platform == 'ios'
+  	print_mobile_configuration
+  else
+  	print_desktop_configuration
+  end
+end
+
+# method to print desktop configuration
+def print_desktop_configuration
+  puts 'Platform : ' + Selenium::WebDriver::Platform.os.to_s.upcase
+  puts 'Browser : ' + $driver.capabilities.browser_name.to_s.upcase + " " + $driver.capabilities.version.to_s
+  puts ''
+end
+
+# method to print mobile configuration
+def print_mobile_configuration
+  puts "Platform : #{$platform.upcase}" 
+  puts "OS version : #{$os_version}" 
+  puts "Device : #{$device_name}" 
+
+  if $app_path.nil?
+  	puts 'Browser : ' + $driver.capabilities.browser_name.to_s.upcase + " " + $driver.capabilities.version.to_s
+  else
+  	puts "App Tested : #{$app_path}" 
+  end
+  puts ''
+end

data/lib/itms_automation/methods/error_handling_methods.rb

@@ -0,0 +1,93 @@
+# Error handling methods
+
+# Method to check browser type
+def validate_parameters(platform, browser_type, app_path)
+  if platform == 'desktop'
+    if !%w(firefox internet_explorer chrome safari opera chrome_headless remote).include? browser_type
+      print_error_desktop
+    end
+  elsif platform == 'android'
+      print_error_android browser_type, app_path
+  elsif platform == 'iOS'
+    puts "Not Implemented..."
+    # print_error_ios browser_type, app_path
+  else
+    print_invalid_platform
+  end
+end
+
+# print error for desktop
+def print_error_desktop
+  puts "\nInappropraite desktop browser : \"#{ENV['BROWSER']}\""
+  puts "\nUsage : cucumber BROWSER=browser_name"
+  puts "\nBrowser Supported  :\n"
+  puts "\n1.internet_explorer\n2.chrome\n3.firefox\n4.safari\n5.opera\n6.chrome_headless\n7.remote"
+  Process.exit(0)
+end
+
+# print error for android
+def print_error_android(browser_type, app_path)
+  if browser_type=='firefox' and app_path==nil
+    puts "\nOops... not mentioned \"Browser\" or \"App path\""
+    print_error_android_app
+    print_error_android_web
+    Process.exit(0)
+  elsif browser_type!='firefox' and !%w(native chrome).include? browser_type
+    puts "\nOops... not supported browser"
+    print_error_android_web
+    Process.exit(0)
+  end
+end
+
+# print error for android app
+def print_error_android_app
+  puts "\nTo run test on android app"
+  puts "\n  Usage : cucumber PLATFORM=android APP_PATH=path/to/app"
+end
+
+# print error for android web
+def print_error_android_web
+  puts "\nTo run test on android mobile web"
+  puts "\n  Usage : cucumber PLATFORM=android BROWSER=browser_name"
+  puts "\n  Supported browsers are \"chrome\" and \"native\""
+end
+
+# print error for ios
+def print_error_ios
+  if browser_type=='firefox' and app_path==nil
+    puts "\nOops... not mentioned \"Browser\" or \"App path\""
+    print_error_ios_app
+    print_error_ios_web
+    Process.exit(0)
+  elsif browser_type!='safari'
+    puts "\nOops... not supported browser"
+    print_error_ios_app_web
+    Process.exit(0)
+  end
+end
+
+# print error for ios app
+def print_error_ios_app
+  puts "\nTo run test on iOS App"
+  puts "\n  Usage : cucumber PLATFORM=iOS APP_PATH=path/to/app"
+end
+
+# print error for ios web
+def print_error_ios_web
+  puts "\nTo run test on iOS mobile web"
+  puts "\n  Usage : cucumber PLATFORM=iOS BROWSER=safari"
+end
+
+# print error if invalid platform
+def print_invalid_platform
+  puts "\nOops... Invalid Platform"
+  puts "\nSupported platform are \"android\" and \"iOS\"."
+  puts "\nTo run on Desktop no need to mention platform."
+  Process.exit(0)
+end
+
+def print_error_object_repository
+  puts "\nNo Object Repository found."
+  puts "\nPlease create file \"project_object.yml\" in path \"features/step_definitions/repositories/\""
+  Process.exit(0)
+end

data/lib/itms_automation/methods/input_methods.rb

@@ -0,0 +1,69 @@
+require_relative 'required_files'
+
+# method to enter text into textfield
+def enter_text(element, text)
+  foundElement = find_object(element)
+  WAIT.until { foundElement }.send_keys(text)
+end
+
+# method to clear text from textfield
+def clear_text(element)
+  foundElement = find_object(element)
+  WAIT.until { foundElement }.clear
+end
+
+# method to select option from dropdwon list
+def select_option_from_dropdown(element, by, option)
+  dropdown = WAIT.until { find_object(element) }
+  select_list = Selenium::WebDriver::Support::Select.new(dropdown)
+  select_list.select_by(:"#{by}", "#{option}")
+end
+
+# method to select all option from dropdwon list
+def select_all_option_from_multiselect_dropdown(element)
+  dropdown = WAIT.until { find_object(element) }
+  select_list = Selenium::WebDriver::Support::Select.new(dropdown)
+  select_list.select_all
+end
+
+# method to unselect all option from dropdwon list
+def unselect_all_option_from_multiselect_dropdown(element)
+  dropdown = WAIT.until { find_object(element) }
+  select_list = Selenium::WebDriver::Support::Select.new(dropdown)
+  select_list.deselect_all
+end
+
+# method to check checkbox
+def check_checkbox(element)
+  checkbox = WAIT.until { find_object(element) }
+  checkbox.click unless checkbox.selected?
+end
+
+# method to uncheck checkbox
+def uncheck_checkbox(element)
+  checkbox = WAIT.until { find_object(element) }
+
+  if checkbox.selected?
+    checkbox.click
+  end
+end
+
+# method to select radio button
+def toggle_checkbox(element)
+  WAIT.until { find_object(element) }.click
+end
+
+# method to select radio button
+def select_radio_button(element)
+  radio_button = WAIT.until { find_object(element) }
+  radio_button.click unless radio_button.selected?
+end
+
+# method to select option from radio button group
+def select_option_from_radio_button_group(element, by, option)
+  radio_button_group = WAIT.until { find_object(element) }
+
+  getter = ->(rb, by) { by == 'value' ? rb.attribute('value') : rb.text }
+  ele = radio_button_group.find { |rb| getter.call(rb, by) == option }
+  ele.click unless ele.selected?
+end

data/lib/itms_automation/methods/javascript_handling_methods.rb

@@ -0,0 +1,9 @@
+require_relative 'required_files'
+
+def handle_alert(decesion)
+  if decesion == 'accept'
+    $driver.switch_to.alert.accept
+  else
+   	$driver.switch_to.alert.dismiss
+  end
+end

data/lib/itms_automation/methods/misc_methods.rb

@@ -0,0 +1,63 @@
+
+# custome exception class
+class TestCaseFailed < Exception
+end
+
+# WAIT instance for explicit wait
+WAIT = Selenium::WebDriver::Wait.new(:timeout => 30)
+
+# method to validate locator
+def valid_locator_type? type
+  %w(id class css name xpath).include? type
+end
+
+def validate_locator type
+  raise "Invalid locator type - #{type}" unless valid_locator_type? type
+end
+
+# method to validate dropdown selector
+def valid_option_by? option_by
+  %w(text value index).include? option_by
+end
+
+def validate_option_by option_by
+  raise "Invalid option by - #{option_by}" unless valid_option_by? option_by
+end
+
+# Return android device name and android version using adb command
+def get_device_info
+  IO.popen('adb shell getprop ro.product.brand') { |f| $device = f.gets.chomp.upcase}
+  $device += ' '
+  IO.popen('adb shell getprop ro.product.model') { |f| $device += f.gets.chomp.upcase}
+  IO.popen('adb shell getprop ro.build.version.release') { |f| $os_version = f.gets.chomp.upcase}
+  return $device, $os_version
+end
+
+def find_object(string_object)
+  $OBJECT = load_object_repository
+  string_object = string_object.gsub(/"/, "'")
+  hash_object = $OBJECT[string_object]
+  if hash_object == nil
+    raise "Object not found - Object: #{string_object} is not found in Object Repository."
+  end
+  locator_type = hash_object.keys.first.to_s
+  locator_value = hash_object[locator_type]
+  validate_locator(locator_type)
+  $driver.find_element(:"#{locator_type}" => "#{locator_value}")
+end
+
+def load_object_repository
+  begin
+    loadYAMLfile("features/step_definitions/repositories/project_object.yml")
+  rescue => exception
+    print_error_object_repository
+  end
+end
+
+def loadYAMLfile(filename)
+  begin
+    return YAML.load_file(filename)
+  rescue Psych::SyntaxError => ex
+    raise "❌ SyntaxError when reading file: #{ex}"
+  end
+end

data/lib/itms_automation/methods/navigate_methods.rb

@@ -0,0 +1,123 @@
+require_relative 'required_files'
+
+# method to open link
+def navigate_to(link)
+  $driver.get link
+end
+
+# method to navigate back & forword
+def navigate(direction)
+  if direction == 'back'
+	  $driver.navigate.back
+  else
+    $driver.navigate.forward
+  end
+end
+
+# method to quite webdriver instance
+def close_driver
+  $driver.quit
+end
+
+# method to return key by os wise
+def get_key
+  os = Selenium::WebDriver::Platform.os
+  if os.to_s == 'windows'
+    return 'control'
+  elsif os.to_s == 'macosx'
+    return 'command'
+  else
+    raise 'Invalid OS'
+  end
+end
+
+# Method to zoom in/out page
+def zoom_in_out(in_out)
+  $driver.action.key_down(:"#{get_key}").send_keys(:"#{in_out}").key_up(:"#{get_key}").perform
+end
+
+# Method to zoom in/out web page until web element displyas
+def zoom_in_out_till_element_display(element, in_out)
+  while true
+    if WAIT.until { find_object(element) }.displayed?
+      break
+    else
+      $driver.action.key_down(:"#{get_key}").send_keys(:"#{in_out}").key_up(:"#{get_key}").perform
+    end
+  end
+end
+
+# Method to resize browser
+def resize_browser(width, heigth)
+  $driver.manage.window.resize_to(width, heigth)
+end
+
+# Method to maximize browser
+def maximize_browser
+  $driver.manage.window.maximize
+end
+
+# Method to refresh page
+def refresh_page
+  $driver.navigate.refresh
+end
+
+# Method to hover on element
+def hover_over_element(element)
+  element = WAIT.until { find_object(element) }
+  $driver.action.move_to(element).perform
+end
+
+# Method to scroll page to perticular element
+def scroll_to_element(element)
+  ele_scroll = WAIT.until { find_object(element) }
+  ele_scroll.location_once_scrolled_into_view
+end
+
+# method to scroll page to top or end
+def scroll_page(to)
+  if to == 'end'
+    $driver.execute_script('window.scrollTo(0,Math.max(document.documentElement.scrollHeight,document.body.scrollHeight,document.documentElement.clientHeight));')
+  elsif to == 'top'
+    $driver.execute_script('window.scrollTo(Math.max(document.documentElement.scrollHeight,document.body.scrollHeight,document.documentElement.clientHeight),0);')
+  else
+    raise "Exception : Invalid Direction (only scroll \"top\" or \"end\")"
+  end
+end
+
+$old_win = nil
+
+# Method to switch to new window
+
+def switch_to_new_window
+  $old_win = $driver.window_handle
+  $driver.switch_to.window($driver.window_handles[1])
+end
+
+
+# Method to switch to old window
+def switch_to_old_window
+  $driver.switch_to.window($old_win)
+end
+
+# Method to close new window
+def close_new_window
+  $driver.close
+end
+
+=begin
+def switch_to_new_window
+  win_handles = $driver.window_handles
+
+  puts $driver.title
+  puts win_handles.length
+
+  $driver.switch_to.window($driver.window_handles[1])
+  puts $driver.window_handles[1]
+  puts $driver.title
+
+  $driver.switch_to.window($driver.window_handles[2])
+  puts $driver.window_handles[2]
+  puts $driver.title
+end
+=end

data/lib/itms_automation/methods/progress_methods.rb

@@ -0,0 +1,15 @@
+require_relative 'required_files'
+
+def wait(time)
+  sleep time.to_i
+end
+
+def wait_for_element_to_display(element, duration)
+  wait = Selenium::WebDriver::Wait.new(:timeout => duration.to_i) # seconds
+  wait.until { find_object(element).displayed? }
+end
+
+def wait_for_element_to_enable(element, duration)
+  wait = Selenium::WebDriver::Wait.new(:timeout => duration.to_i) # seconds
+  wait.until { find_object(element).enabled? }
+end

data/lib/itms_automation/methods/required_files.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'selenium-webdriver'
+require 'open-uri'
+require 'rbconfig'
+require 'appium_lib_core'
+include RbConfig
+
+require_relative 'misc_methods'
+require_relative 'error_handling_methods'