itms_automation 2.5 → 2.6.2

data/example/android/android_web/android_web_gmail_login/features/gmail_login.feature

@@ -0,0 +1,12 @@
+Feature: Gmail Login mobile web
+
+  Scenario: valid credentials login
+    Given I navigate to "http://www.gmail.com"
+    Then I wait for 5 sec
+    Then I enter "your_email" into input field having id "Email"
+    Then I enter "your_password" into input field having id "Passwd"
+    When I click on element having id "signIn"
+    And I wait for 10 sec
+    Then element having xpath "//*[@id='tltbt']/div[3]/div/div" should be present
+    And I wait for 5 sec
+    Then I close browser

data/example/android/android_web/android_web_gmail_login/features/my_first.feature

@@ -0,0 +1 @@
+

data/example/android/android_web/android_web_gmail_login/features/step_definitions/custom_steps.rb

@@ -0,0 +1,5 @@
+require 'itms_automation'
+
+# Do Not Remove This File
+# Add your custom steps here
+# $driver is instance of webdriver use this instance to write your custom code

data/example/android/android_web/android_web_gmail_login/features/support/env.rb

@@ -0,0 +1,51 @@
+require 'rubygems'
+require 'itms_automation'
+
+# Store command line arguments
+$browser_type = ENV['BROWSER'] || 'ff'
+$platform = ENV['PLATFORM'] || 'desktop'
+$os_version = ENV['OS_VERSION']
+$device_name = ENV['DEVICE_NAME']
+$udid = ENV['UDID']
+$app_path = ENV['APP_PATH']
+
+# check for valid parameters
+validate_parameters $platform, $browser_type, $app_path
+
+# If platform is android or ios create driver instance for mobile browser
+if $platform == 'android' or $platform == 'iOS'
+
+  if $browser_type == 'native'
+    $browser_type = "Browser"
+  end
+
+  if $platform == 'android'
+    $device_name, $os_version = get_device_info
+  end
+
+  desired_caps = {
+    caps:       {
+      platformName:  $platform,
+      browserName: $browser_type,
+      versionNumber: $os_version,
+      deviceName: $device_name,
+      udid: $udid,
+      app: ".//#{$app_path}"
+      },
+    }
+
+  begin
+    $driver = Appium::Driver.new(desired_caps).start_driver
+  rescue Exception => e
+    puts e.message
+    Process.exit(0)
+  end
+else # else create driver instance for desktop browser
+  begin
+    $driver = Selenium::WebDriver.for(:"#{$browser_type}")
+    $driver.manage().window().maximize()
+  rescue Exception => e
+    puts e.message
+    Process.exit(0)
+  end
+end

data/example/android/android_web/android_web_gmail_login/features/support/hooks.rb

@@ -0,0 +1,27 @@
+#Cucumber provides a number of hooks which allow us to run blocks at various points in the Cucumber test cycle
+
+Before do
+  # Do something before each scenario.
+end
+
+Before do |scenario|
+  # The +scenario+ argument is optional, but if you use it, you can get the title,
+  # description, or name (title + description) of the scenario that is about to be
+  # executed.
+end
+
+After do
+  # Do something after each scenario.
+end
+
+After do |scenario|
+  # Do something after each scenario.
+  # The +scenario+ argument is optional, but
+  # if you use it, you can inspect status with
+  # the #failed?, #passed? and #exception methods.
+
+  if(scenario.failed?)
+    #Do something if scenario fails.
+  end
+end
+

data/example/desktop web/desktop_web_gmail_login/features/gmail_login.feature

@@ -0,0 +1,9 @@
+Feature: Gmail_login
+
+	Scenario: Valid_gmail_login
+		Given I navigate to "http://www.gmail.com"
+		And I enter "abc@gmail.com" into input field having id "Email"
+		And I enter "!password*" into input field having id "Passwd"
+		When I click on element having id "signIn"
+		And I wait for 10 sec
+		Then I close browser

data/example/desktop web/desktop_web_gmail_login/features/gmail_multi_login.feature

@@ -0,0 +1,21 @@
+Feature: Gmail_login
+
+	Scenario: Open gmail
+		Given I navigate to "http://www.gmail.com"
+		
+	Scenario Outline: In-valid Login
+		Then I clear input field having id "Email"
+		And I enter <username> into input field having id "Email"
+		Then I clear input field having id "Passwd"
+		And I enter <password> into input field having id "Passwd"
+		When I click on element having id "signIn"
+		Then element having id "errormsg_0_Passwd" should be present
+	
+		Examples:
+			| username | password   |
+			|"test1"   |"password1" |
+			|"test2"   |"password2" |
+			|"test3"   |"password3" |
+
+	Scenario: close gmail
+		Then I close browser

data/example/desktop web/desktop_web_gmail_login/features/my_first.feature

@@ -0,0 +1 @@
+

data/example/desktop web/desktop_web_gmail_login/features/step_definitions/custom_steps.rb

@@ -0,0 +1,5 @@
+require 'itms_automation'
+
+# Do Not Remove This File
+# Add your custom steps here
+# $driver is instance of webdriver use this instance to write your custom code

data/example/desktop web/desktop_web_gmail_login/features/support/env.rb

@@ -0,0 +1,106 @@
+require 'rubygems'
+# require 'itms_automation'
+require_relative '../../../lib/itms_automation.rb'
+# require 'appium_lib'
+require 'appium_lib_core'
+# Store command line arguments
+$browser_type = ENV['BROWSER'] || 'firefox'
+$platform = ENV['PLATFORM'] || 'desktop'
+$os_version = ENV['OS_VERSION']
+$device_name = ENV['DEVICE_NAME']
+$udid = ENV['UDID']
+$app_path = ENV['APP_PATH']
+
+# check for valid parameters
+validate_parameters $platform, $browser_type, $app_path
+
+# If platform is android or ios create driver instance for mobile browser
+if $platform == 'android' or $platform == 'iOS'
+
+  if $browser_type == 'native'
+    $browser_type = "Browser"
+  end
+
+  if $platform == 'android'
+    $device_name, $os_version = get_device_info
+  end
+
+  # desired_caps = {
+  #   caps:       {
+  #     platformName: $platform,
+  #     browserName: $browser_type,
+  #     versionNumber: $os_version,
+  #     deviceName: $device_name,
+  #     udid: $udid,
+  #     app: ".//#{$app_path}"
+  #     }
+  #   }
+  #   appium_url = 'http://localhost:4723/wd/hub'
+  #   opts = {
+  #   desired_capabilities: { # or { caps: {....} }
+  #     platformName: :android,
+  #     deviceName: 'Android Simulator',
+  #     app: "WikipediaSample.apk"
+  #   },
+  #   appium_lib: {
+  #     wait: 30
+  #   }
+  # }
+
+  opts = {
+    desired_capabilities: { # or { caps: {....} }
+      platformName: $platform,
+      browserName: $browser_type,
+      deviceName: $device_name,
+      versionNumber: $os_version,
+      app: "WikipediaSample.apk"
+    },
+    appium_lib: {
+      wait: 30
+    }
+  }
+
+  begin
+    # $driver = Appium::Driver.new(desired_caps, url: appium_url).start_driver
+
+    # $driver = Selenium::WebDriver.for(:remote, :url => appium_url, :desired_capabilities => desired_caps)
+    @core = Appium::Core.for(opts) # create a core driver with `opts`
+    $driver = @core.start_driver
+
+  rescue Exception => e
+    puts e.message
+    Process.exit(0)
+  end
+else # else create driver instance for desktop browser
+  begin
+    $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']
+        Selenium::WebDriver.for(:remote, :url => ENV['SERVER_URL'], :desired_capabilities => caps)
+      end
+
+    else
+      Selenium::WebDriver.for(:firefox)
+    end
+    $driver.manage().window().maximize()
+    p "session_id: #{$driver.session_id}"
+  rescue Exception => e
+    puts e.message
+    Process.exit(0)
+  end
+end
+

data/example/desktop web/desktop_web_gmail_login/features/support/hooks.rb

@@ -0,0 +1,38 @@
+def validate_params_exist
+  raise "❌  ERROR: Missing param SERVER_URL." if ENV['SERVER_URL'].nil?
+  raise "❌  ERROR: Missing param BROWSER." if ENV['BROWSER'].nil?
+  if ENV['REPORT']
+    raise "❌  ERROR: Missing param TESTSUITE." if ENV['TESTSUITE'].nil?
+    raise "❌  ERROR: Missing param TESTCASE_REPORT_NAME." if ENV['TESTCASE_REPORT_NAME'].nil?
+    $report_path = "Reports/#{ENV['TESTSUITE']}"
+    $testcase_report_name = ENV['TESTCASE_REPORT_NAME']
+  end
+end
+
+at_exit do
+  # quite driver
+  $driver.close()
+  if ENV['REPORT']
+    begin
+      # validateReport
+      time = Time.now.getutc
+      ReportBuilder.configure do |config|
+        config.report_path = "#{$report_path}/#{$testcase_report_name}"
+        config.input_path = "#{$report_path}/#{$testcase_report_name}.json"
+        config.report_types = [:json, :html]
+        config.color = 'blue'
+        config.additional_info = {
+          'Browser' => $browser_type,
+          'Platform' => $platform ,
+          'OS Version' => $os_version,
+          'Report Generated' => time
+        }
+      end
+      options = { report_title: "INFODation - Test Management System" }
+      ReportBuilder.build_report options
+    rescue Exception => e
+      puts e.message
+      Process.exit( 0 )
+    end
+  end
+end

data/features-skeleton/Gemfile.lock

@@ -0,0 +1,63 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    appium_lib_core (3.10.1)
+      faye-websocket (~> 0.10.0)
+      selenium-webdriver (~> 3.14, >= 3.14.1)
+    backports (3.18.1)
+    builder (3.2.4)
+    childprocess (3.0.0)
+    cucumber (3.1.2)
+      builder (>= 2.1.2)
+      cucumber-core (~> 3.2.0)
+      cucumber-expressions (~> 6.0.1)
+      cucumber-wire (~> 0.0.1)
+      diff-lcs (~> 1.3)
+      gherkin (~> 5.1.0)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.1.2)
+    cucumber-core (3.2.1)
+      backports (>= 3.8.0)
+      cucumber-tag_expressions (~> 1.1.0)
+      gherkin (~> 5.0)
+    cucumber-expressions (6.0.1)
+    cucumber-tag_expressions (1.1.1)
+    cucumber-wire (0.0.1)
+    diff-lcs (1.4.4)
+    eventmachine (1.2.7)
+    faye-websocket (0.10.9)
+      eventmachine (>= 0.12.0)
+      websocket-driver (>= 0.5.1)
+    gherkin (5.1.0)
+    httparty (0.13.7)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    itms_automation (2.6.1)
+      appium_lib_core (~> 3.10.1, >= 3.10.1)
+      cucumber (~> 3.1.2, >= 3.1.2)
+      httparty (~> 0.13.7, >= 0.13.7)
+      report_builder (~> 1.8, >= 1.8)
+      selenium-webdriver (~> 3.14, >= 3.14.1)
+    json (1.8.6)
+    multi_json (1.14.1)
+    multi_test (0.1.2)
+    multi_xml (0.6.0)
+    report_builder (1.8)
+      json (>= 1.8.1)
+    rubyzip (2.3.0)
+    selenium-webdriver (3.142.7)
+      childprocess (>= 0.5, < 4.0)
+      rubyzip (>= 1.2.2)
+    websocket-driver (0.7.2)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  itms_automation
+  report_builder
+
+BUNDLED WITH
+   2.0.2

data/features-skeleton/README.md

@@ -0,0 +1,132 @@
+Welcome to itms_automation
+=================
+
+itms_automation : Automation Tesing Using Ruby
+
+itms_automation is a behavior driven development (BDD) approach to write automation test script to test Web and Android Apps.
+It enables you to write and execute automated acceptance/unit tests.
+It is cross-platform, open source and free.
+Automate your test cases with minimal coding.
+
+itms_automation Ruby API's
+============================
+
+If you are writing code for your custom steps you can use the following methods :
+
+Note : For some of the API paramtere values are fixed. Such values for paramaters are mentioned below.
+
+Navigation API's
+----------------
+
+	navigate_to("link")
+
+	navigate(direction)  # direction => "back" / "forward"
+
+	close_driver()
+
+
+Browser Interaction API's
+-------------------------
+
+	resize_browser(width, height)
+
+	scroll_page(to)	     # to => "top" / "end"
+
+	scroll_to_element(by, access_value)
+
+	zoom_in_out(in_out)  # in_out => "add" / "subtract"
+
+	zoom_in_out_till_element_display(by, in_out, access_value) # in_out => "add" / "subtract"
+
+
+Input API's
+------------
+
+	click(element)
+
+	double_click(element)
+
+	click_forcefully(element)
+
+	enter_text(element, text)
+
+	clear_text(element)
+
+	check_checkbox(element)
+
+	uncheck_checkbox(element)
+
+	toggle_checkbox(element)
+
+	select_radio_button(element)
+
+	get_page_title()
+
+	get_element_text(element)
+
+	get_element_attribute(element, attribute)
+
+	is_element_enabled(element)
+
+	is_element_displayed(element)
+
+	hover_over_element(element)
+
+	by => "locators type" ("id", "name", "class", "xpath", "css")
+
+	access_value => "locator value"
+
+
+Javascript Handling API
+-----------------------
+
+	handle_alert(decision) 		# decision => "accept" / "dismiss"
+
+	get_alert_text
+
+
+Progress API's
+--------------
+
+	wait(time_in_sec)
+
+	wait_for_element_to_display(element, duration)
+
+	wait_for_element_to_enable(element, duration)
+
+
+	by => "locators type" ("id", "name", "class", "xpath", "css")
+
+	access_value => "locator value"
+
+	duration => duration in seconds.
+
+
+Screenshot API
+--------------
+	take_screenshots
+
+
+Configuration API
+-----------------
+
+	print_congifugartion
+
+
+Usage: itms_automation <command-name> [parameters] [options]
+
+  <command-name> can be one of
+    help
+    gen
+    version
+
+  Commands:
+    help : prints more detailed help information.
+
+    gen  : creates a skeleton features dir. This is usually used once when
+           setting up selnium-cucumber to ensure that the features folder contains
+           the right step definitions and environment to run with cucumber.
+
+    version : prints the gem version
+
+    Options:  -v, --verbose  Turns on verbose logging