itms_automation 2.7.0 → 2.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dba9f35006766cde92ddcbe9b77d9943b86fbdbbdfdf13f2a8f59b73589aa5da
-  data.tar.gz: 87c8d32302284a4505a2e56eed6dfe74b863e308aceea85b6bdf1faf5374ca22
+  metadata.gz: '090afc5cfe29b875d3816ad9ca3e64c140c8b73a5fe2a7129d02b1641baa8d4f'
+  data.tar.gz: 9f36d46924317a25e1474668a4b22b19d487a155f2c24508310ee81230548196
 SHA512:
-  metadata.gz: 77f8c58293b04d7547413a99b7872822d3d0966cf9f42925431e4eeec87fd9415e2e2cb073102a8d52d12c89ad67030229ec1857b23c6cad4a5f65bc0b82bb99
-  data.tar.gz: d3decc37bd0b053305208cb5cffc559fb37048717d4e978995bd8033bf251cf094e341e32c90742c6d18f6b92dbc9f55082c6adbb7f0f628864fdbfb5763985a
+  metadata.gz: cf5d23c33daedaaa38c3e56cd689a8bb99ef720f8efe8ddfbdf6c0a686bf8749e208503b00e3ea1990608fd83d2c86f1159446d07314c02f159dcad892086989
+  data.tar.gz: 6b2052bc442d517c26186e412dacb3fb94f3b23c0aa21c24937686e1263ee9c3a07ecd21b139b49a5498a4787ea0ae8e12579e908acc86da530c2a1a5e5eca6a

data/features-skeleton/support/env.rb

@@ -7,28 +7,29 @@ require "webdrivers"
 $browser_type = ENV["BROWSER"] || "firefox"
 
 begin
+  $vars = {}
   $driver = case $browser_type
-  when "chrome"
-    Selenium::WebDriver.for(:chrome)
-  when "safari"
-    Selenium::WebDriver.for(:safari)
-  when "internet_explorer"
-    Selenium::WebDriver.for(:internet_explorer)
-  when "chrome_headless"
-    Selenium::WebDriver.for(:chrome, :desired_capabilities => Selenium::WebDriver::Remote::Capabilities.chrome(chromeOptions: { args: %w(headless) }))
-  when "remote"
-    if ENV['SERVER_URL'].nil? || ENV['REMOTE_BROWSER'].nil?
-      puts "\nMissing SERVER_URL : SERVER_URL=http//SERVER_URL:4444/wd/hub"
-      puts "\nMissing REMOTE_BROWSER: REMOTE_BROWSER=browser_name"
-      Process.exit(0)
-    else
-      caps = Selenium::WebDriver::Remote::Capabilities.new
-      caps["browserName"] = ENV["REMOTE_BROWSER"]
-      caps["enableVNC"] = true
-      caps["enableVideo"] = ENV["ENABLE_VIDEO"] == "true"
-      caps["resolution"] = ENV["resolution"] unless ENV["resolution"]
-      Selenium::WebDriver.for(:remote, :url => ENV["SERVER_URL"], :desired_capabilities => caps)
-  end
+    when "chrome"
+      Selenium::WebDriver.for(:chrome)
+    when "safari"
+      Selenium::WebDriver.for(:safari)
+    when "internet_explorer"
+      Selenium::WebDriver.for(:internet_explorer)
+    when "chrome_headless"
+      Selenium::WebDriver.for(:chrome, :desired_capabilities => Selenium::WebDriver::Remote::Capabilities.chrome(chromeOptions: { args: %w(headless) }))
+    when "remote"
+      if ENV['SERVER_URL'].nil? || ENV['REMOTE_BROWSER'].nil?
+        puts "\nMissing SERVER_URL : SERVER_URL=http//SERVER_URL:4444/wd/hub"
+        puts "\nMissing REMOTE_BROWSER: REMOTE_BROWSER=browser_name"
+        Process.exit(0)
+      else
+        caps = Selenium::WebDriver::Remote::Capabilities.new
+        caps["browserName"] = ENV["REMOTE_BROWSER"]
+        caps["enableVNC"] = false
+        caps["enableVideo"] = false
+        caps["resolution"] = ENV["resolution"] unless ENV["resolution"]
+        Selenium::WebDriver.for(:remote, :url => ENV["SERVER_URL"], :desired_capabilities => caps)
+      end
   else
     Selenium::WebDriver.for(:firefox)
   end

data/lib/itms_automation/methods/assertion_methods.rb

@@ -1,5 +1,6 @@
 require 'net/https'
 require_relative 'required_files'
+require 'rspec'
 
 # This file contains assertion methods which are called from assertion_steps.rb
 
@@ -9,59 +10,23 @@ def get_page_title
 end
 
 # Method to verify title
-# param 1 : String : expected title
-# param 2 : Boolean : test case [true or flase]
-def check_title(title, test_case)
-  page_title = get_page_title
-  if test_case
-    if page_title != "#{title}"
-      raise TestCaseFailed, "Page Title Not Matched, Actual Page Title : #{page_title}"
-    end
-  else
-    if page_title == "#{title}"
-      raise TestCaseFailed, "Page Title Matched, Actual Page Title:#{page_title}"
-    end
-  end
-end
-
-# Method to verify partial title
-# param 1 : String : partial title string
-# param 2 : Boolean : test case [true or flase]
-def check_partial_title(partial_text_title, test_case)
-  page_title = get_page_title
-  if test_case
-    if not page_title.include? "#{partial_text_title}"
-      raise TestCaseFailed, 'Partial Page Title Not Present'
-    end
-  else
-    if page_title.include? "#{partial_text_title}"
-      raise TestCaseFailed, 'Page Title Matched'
-    end
-  end
+# param 1: String : expected title
+def assert_title(title)
+  expect(get_page_title).to eq(title)
 end
 
 # Method to get element text
 # param : String
 def get_element_text(element)
-  WAIT.until { find_object(element) }.text
+  find_object(element).text
 end
 
 # Method to check element text
 # param 1 : String : Element
 # param 2 : String : Expected element text
-# param 3 : Boolean : test case [true or flase]
-def check_element_text(element, expected_value, test_case)
+def assert_text(element, expected_value)
   element_text = get_element_text(element)
-
-  if test_case
-    if element_text != expected_value
-      raise TestCaseFailed, "Text Not Matched. Actual Value :#{expected_value}"
-    end
-  else
-    if element_text == expected_value
-      raise TestCaseFailed, "Text Matched. Actual Value :#{expected_value}"
-    end
-  end
+  expect(element_text).to eq(expected_value)
 end
 
 # Method to check partial element text
@@ -101,13 +66,6 @@ def check_element_enable(element, test_case)
   end
 end
 
-# method to get attribute value
-# param 1 : String : Element
-# param 2 : String : atrribute name
-def get_element_attribute(element, attribute_name)
-  WAIT.until{ find_object(element) }.attribute("#{attribute_name}")
-end
-
 # method to check attribute value
 # param 1 : String : Element
 # param 2 : String : atrribute name
@@ -137,34 +95,26 @@ end
 # method to check element presence
 # param 1 : String : Element
 # param 2 : Boolean : test case [true or flase]
-def check_element_presence(element, test_case)
-  if test_case
-    if !is_element_displayed(element)
-      raise TestCaseFailed, 'Element Not Present'
-    end
-  else
-    begin
-      if is_element_displayed(element)
-        raise 'Present' # since it is negative test and we found element
-      end
-    rescue Exception => e
-      if e.message == 'Present' # only raise if it present
-        raise TestCaseFailed, 'Element Present'
-      end
-    end
-  end
+def assert_element_present(element)
+  found_element = find_object(element)
+  raise TestCaseFailed, 'Element Not Present' unless found_element.length > 0
 end
 
-# method to assert checkbox check/uncheck
+# method to assert checkbox check
 # param 1 : String : Element
-# param 2 : Boolean : test case [true or flase]
-def is_checkbox_checked(element, should_be_checked = true)
-  checkbox = WAIT.until{ find_object(element) }
+def assert_checked(element)
+  checkbox = find_object(element)
 
-  if !checkbox.selected? && should_be_checked
-    raise TestCaseFailed, 'Checkbox is not checked'
-  elsif checkbox.selected? && !should_be_checked
-    raise TestCaseFailed, 'Checkbox is checked'
+  if !checkbox.selected?
+    raise TestCaseFailed, "Checkbox is not checked"
+  end
+end
+
+def assert_not_checked(element)
+  checkbox = find_object(element)
+
+  if checkbox.selected?
+    raise TestCaseFailed, "Checkbox is checked"
   end
 end
 
@@ -202,10 +152,9 @@ def get_alert_text
 end
 
 # method to check javascript pop-up alert text
-def check_alert_text(text)
-  if get_alert_text != text
-    raise TestCaseFailed,  "Text on alert pop up not matched. Actual Value :#{get_alert_text}"
-  end
+def assert_alert(text)
+  alert_text = $driver.switch_to.alert.text
+  expect(alert_text).to eq(text)
 end
 
 def is_option_from_dropdown_selected(element, by, option, should_be_selected=true)

data/lib/itms_automation/methods/click_elements_methods.rb

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

data/lib/itms_automation/methods/condition_methods.rb

@@ -0,0 +1,13 @@
+require_relative 'required_files'
+
+def if(condition_script)
+  return $driver.execute_script(condition_script)
+end
+
+def else_if(condition_script)
+  return $driver.execute_script(condition_script)
+end
+
+def while(condition_script)
+  return $driver.execute_script(condition_script)
+end

data/lib/itms_automation/methods/configuration_methods.rb

@@ -22,14 +22,18 @@ end
 
 # method to print mobile configuration
 def print_mobile_configuration
-  puts "Platform : #{$platform.upcase}" 
-  puts "OS version : #{$os_version}" 
-  puts "Device : #{$device_name}" 
+  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}" 
+  	puts "App Tested : #{$app_path}"
   end
   puts ''
 end
+
+def echo(message)
+  puts(message)
+end

data/lib/itms_automation/methods/input_methods.rb

@@ -1,15 +1,21 @@
 require_relative 'required_files'
 
 # method to enter text into textfield
-def enter_text(element, text)
+def type(element, text)
   foundElement = find_object(element)
-  WAIT.until { foundElement }.send_keys(text)
+  foundElement.send_keys(text)
 end
 
-# method to clear text from textfield
-def clear_text(element)
+# method to send keys
+def send_keys(element, key)
+  keys_support = ["KEY_LEFT", "KEY_UP", "KEY_RIGHT", "KEY_DOWN", "KEY_PAGE_UP", "KEY_PAGE_DOWN", "KEY_BACKSPACE", "KEY_DELETE", "KEY_ENTER", "KEY_TAB"]
   foundElement = find_object(element)
-  WAIT.until { foundElement }.clear
+  if key
+    get_key = key.strip[/^\$\{(.*?)\}$/, 1]
+    raise TestCaseFailed, "${get_key} key is not supported. Supported keys: KEY_LEFT, KEY_UP, KEY_RIGHT, KEY_DOWN, KEY_PAGE_UP, KEY_PAGE_DOWN, KEY_BACKSPACE, KEY_DELETE, KEY_ENTER, KEY_TAB" unless keys_support.include?(get_key)
+    key_convert = get_key[/^KEY_(.*?)$/, 1].downcase.to_sym
+    foundElement.send_keys(key_convert)
+  end
 end
 
 # method to select option from dropdwon list
@@ -34,21 +40,18 @@ def unselect_all_option_from_multiselect_dropdown(element)
 end
 
 # method to check checkbox
-def check_checkbox(element)
-  checkbox = WAIT.until { find_object(element) }
+def check(element)
+  checkbox = 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
+def uncheck(element)
+  checkbox = find_object(element)
+  checkbox.click if checkbox.selected?
 end
 
-# method to select radio button
+# method to toggle checkbox checked
 def toggle_checkbox(element)
   WAIT.until { find_object(element) }.click
 end

data/lib/itms_automation/methods/javascript_handling_methods.rb

@@ -4,6 +4,6 @@ def handle_alert(decesion)
   if decesion == 'accept'
     $driver.switch_to.alert.accept
   else
-   	$driver.switch_to.alert.dismiss
+    $driver.switch_to.alert.dismiss
   end
 end

data/lib/itms_automation/methods/misc_methods.rb

@@ -59,6 +59,6 @@ def loadYAMLfile(filename)
   begin
     return YAML.load_file(filename)
   rescue Psych::SyntaxError => ex
-    raise "❌ SyntaxError when reading file: #{ex}"
+    raise "Syntax error when reading file: #{ex}"
   end
 end

data/lib/itms_automation/methods/navigate_methods.rb

@@ -1,21 +1,25 @@
 require_relative 'required_files'
 
 # method to open link
-def navigate_to(link)
+def open(link)
   $driver.get link
 end
 
 # method to navigate back & forward
 def navigate(direction)
   if direction == 'back'
-	  $driver.navigate.back
+    $driver.navigate.back
   else
     $driver.navigate.forward
   end
 end
 
+def close
+  $drive.close
+end
+
 # method to quite webdriver instance
-def close_driver
+def quit
   $driver.quit
 end
 
@@ -39,7 +43,7 @@ end
 # Method to zoom in/out web page until web element dislays
 def zoom_in_out_till_element_display(element, in_out)
   while true
-    if WAIT.until { find_object(element) }.displayed?
+    if find_object(element).displayed?
       break
     else
       $driver.action.key_down(:"#{get_key}").send_keys(:"#{in_out}").key_up(:"#{get_key}").perform
@@ -48,8 +52,10 @@ def zoom_in_out_till_element_display(element, in_out)
 end
 
 # Method to resize browser
-def resize_browser(width, heigth)
-  $driver.manage.window.resize_to(width, heigth)
+def set_window_size(resolution)
+  raise TestCaseFailed, 'Wrong format of resolution. (e.g., 1280x800)' unless resolution.match(/^\d+x\d+$/)
+  width, height = resolution.split("x")
+  $driver.manage.resize_to(width, heigth)
 end
 
 # Method to maximize browser
@@ -63,14 +69,50 @@ def refresh_page
 end
 
 # Method to hover on element
-def hover_over_element(element)
-  element = WAIT.until { find_object(element) }
-  $driver.action.move_to(element).perform
+def mouse_over(element)
+  element = find_object(element)
+  $driver.action.move_to_element(element).perform
+end
+
+# mouse_down
+def mouse_down(element)
+  element = find_object(element)
+  $driver.action.move_to_element(element).click_and_hold.perform
+end
+
+# mouse_down_at
+def mouse_down_at(element, location)
+  element = find_object(element)
+  $driver.action.move_to_element(element).click_and_hold.perform
+end
+
+# mouse_out
+def mouse_out
+  element = $driver.find_element(By.CSS_SELECTOR, 'body')
+  $driver.action.move_to_element(element, 0, 0).perform
+end
+
+#mouse_up
+def mouse_up(element)
+  element = find_object(element)
+  $driver.action.move_to_element(element).release.perform
+end
+
+#mouse_up_at
+def mouse_up_at
+  element = find_object(element)
+  $driver.action.move_to_element(element).release.perform
+end
+
+#mouse_move_at
+def mouse_move_at
+  element = find_object(element)
+  $driver.action.move_to_element(element).perform
 end
 
 # Method to scroll page to perticular element
 def scroll_to_element(element)
-  ele_scroll = WAIT.until { find_object(element) }
+  ele_scroll = find_object(element)
   ele_scroll.location_once_scrolled_into_view
 end
 
@@ -84,38 +126,3 @@ def scroll_page(to)
     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

@@ -1,6 +1,6 @@
 require_relative 'required_files'
 
-def wait(time)
+def pause(time)
   sleep time.to_i
 end
 

data/lib/itms_automation/version.rb

@@ -1,5 +1,5 @@
 module ITMS
   module Automation
-    VERSION = '2.7.0'
+    VERSION = '2.7.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: itms_automation
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  version: 2.7.1
 platform: ruby
 authors:
 - INFOdation
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-29 00:00:00.000000000 Z
+date: 2021-04-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber
@@ -110,6 +110,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
 description: Behavior driven development (BDD) approach to write automation test script
   to test Web and Android applications.
 email: anh.pham@infodation.vn
@@ -149,6 +169,7 @@ files:
 - lib/itms_automation/javascript_handling_steps.rb
 - lib/itms_automation/methods/assertion_methods.rb
 - lib/itms_automation/methods/click_elements_methods.rb
+- lib/itms_automation/methods/condition_methods.rb
 - lib/itms_automation/methods/configuration_methods.rb
 - lib/itms_automation/methods/error_handling_methods.rb
 - lib/itms_automation/methods/input_methods.rb