itms_automation 2.2 → 2.5.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1066a38baafacc29d30b7f1c0f615b617f9f842a99fecc323457eec81309361
-  data.tar.gz: a8744479fc22f8b4e8063b90747857d807a8709b9a3c38e1116d9a18607a7d6f
+  metadata.gz: 03c38ca27fff8e41d5bc25a5f98019cbf4e4cc90f1be655b0264b2da1301a2f7
+  data.tar.gz: 6ef0427780ea0b6cfade74682e8d60529fa7194bea56b56546fd786034871bf1
 SHA512:
-  metadata.gz: 6e42a121f66d331393f8a3a62f9d6025b31a6613062120a53006b0bfbe1fd5f95e7acd6c364b36f6825cf8fab09b16ee9e256d1fdd7e1c1db715c65fc0cd1362
-  data.tar.gz: 7f3760b31ab2dda8f192e2f5f56f69b79b2f80dffc12dc99946257989021f50d4b7f7025d45169735007b5e5ef416a2684c9ada47659defb4fa4e22a7a34ac73
+  metadata.gz: 5e4d5042bb36effd440cda7b75e0ea9547a3b5039b6b360fe77d940113480fb82fa5bff6ed3719177c2489f8fd4d6d1e43c48db00562f766a5552b5a01025f69
+  data.tar.gz: 4ac9c825eb5584fece56a3106430de1991c439cdbf4040afe8028091dfb5d2555d8cc03caac65a323fc30b88df8ea66451ebacb8257407f5381b198f761ae5f3

data/bin/generate.rb

@@ -1,7 +1,6 @@
-
 def itms_automation_scaffold
   if File.exists?(@features_dir)
-    puts 'There is already cucumber directory. Please move existing cucumber directory to carry on '
+    puts "A features directory already exists. Stopping..."
     exit 1
   end
   msg("Question") do
@@ -13,41 +12,8 @@ def itms_automation_scaffold
 
   FileUtils.cp_r(@source_dir, @features_dir)
 
-  msg('Info') do
-    puts "iTMS Automation is creating 'cucumber' framework. Please have a look which files are being created\n"
-  end
-  msg('Gemfile') do
-    puts "iTMS Automation created Gemfile containing all required Gems\n"
-  end
-  msg('cucumber.yml') do
-    puts "iTMS Automation created cucumber.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/chrome_headless_options.yaml') do
-    puts "iTMS Automation created chrome_headless_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/firefox_headless_options.yaml') do
-    puts "iTMS Automation created firefox_headless_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/chrome_options.yaml') do
-    puts "iTMS Automation created chrome_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/firefox_options.yaml') do
-    puts "iTMS Automation created firefox_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/ie_options.yaml') do
-    puts "iTMS Automation created ie_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/remote_options.yaml') do
-    puts "iTMS Automation created remote_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('config/safari_options.yaml') do
-    puts "iTMS Automation created safari_options.yml file with profiles of all needed configurations\n"
-  end
-  msg('README.md') do
-    puts "iTMS Automation created README.md file with template usage\n"
-  end
-  msg('Info') do
-    puts "All Config files created. \n"
+  msg("Info") do
+    puts "features subdirectory created. \n"
   end
 
 end

data/bin/helper.rb

@@ -3,15 +3,31 @@ require 'json'
 require "rubygems"
 
 def msg(title, &block)
-  puts "\n" + '-' * 10 + title + '-' * 10
-  yield
-  puts '-' * 10 + '-------' + '-' * 10 + "\n"
-  sleep 1
+  puts "\n" + "-"*10 + title + "-"*10
+  block.call
+  puts "-"*10 + "-------" + "-"*10 + "\n"
+end
+
+def print_usage
+  puts <<EOF
+
+  Usage: itms_automation <command-name> [parameters] [options]
+
+  <command-name> can be one of
+    help
+      prints more detailed help information.
+    gen
+      generate a features folder structure.
+    version
+      prints the gem version
+
+  <options> can be
+     -v, --verbose   Turns on verbose logging
+EOF
 end
 
 def print_help
   puts <<EOF
-  Author: iTMS
 
   Usage: itms_automation <command-name> [parameters] [options]
 
@@ -19,19 +35,16 @@ def print_help
     help
     gen
     version
-    ls
 
     Commands:
       help : prints more detailed help information.
 
-      gen  : creates a features dir. This is usually used once when
-             setting up itms_automation to ensure that the features folder contains
+      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
 
-      ls: list all steps name of itms_automation framework
-
   <Options>
       -v, --verbose  Turns on verbose logging
 EOF

data/bin/itms_automation

@@ -1,32 +1,27 @@
 #!/usr/bin/env ruby
+
 require_relative 'helper.rb'
 require_relative 'generate.rb'
-require_relative 'documentation_generator.rb'
 require 'itms_automation/version'
 
-@features_dir = File.join(FileUtils.pwd, "project")
-@source_dir = File.join(File.dirname(__FILE__), '..', 'project')
-
-search_string = ARGV.shift
-case search_string
-  when /version/
-    puts ItmsAutomation::VERSION
-  when /gen/
-    itms_automation_scaffold
-  when /ls/
-    ORDERED_KINDS = %w[Given When Then]
-    heading = 'All itms_automation steps'
+@features_dir = File.join(FileUtils.pwd, "features")
+@support_dir = File.join(@features_dir, "support")
+@support_dir = File.join(@features_dir, "screenshots")
+@source_dir = File.join(File.dirname(__FILE__), '..', 'features-skeleton')
 
-# collect
-    steps_glob = File.expand_path('../../lib/itms_automation/*_steps.rb', __FILE__)
-    step_names = `cat #{steps_glob}`.split($/).select { |line| line =~ /^\s*(Given|When|Then)/ }
+if (ARGV.length == 0)
+  print_usage
+else
+  cmd = ARGV.shift
 
-# Output
-    puts "\e[4;34m\n# #{heading}\e[0m" # blue underline
-    puts step_names
-  else
-    print_help
+  if cmd == "help"
+      print_help
+  elsif cmd == "gen"
+      itms_automation_scaffold
+  elsif cmd == "version"
+    puts ITMS::Automation::VERSION
+    else
+      print_usage
+  end
 end
 
-
-

data/doc/installation.md

@@ -0,0 +1,16 @@
+Installation
+============
+### Prerequisites
+You need to have Ruby installed.
+Verify your installation by running ruby -v in a terminal - it should print "ruby 1.9.3" (or higher).
+
+You need to have DevKit installed.
+
+You can get Ruby and DevKit from [RubyInstaller.org](http://rubyinstaller.org/)
+
+### Installation
+
+Install `itms_automation` gem by running
+
+- `gem install itms_automation`
+

data/doc/itms-automation-API.md

@@ -0,0 +1,103 @@
+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

data/doc/itms-automation-help.md

@@ -0,0 +1,18 @@
+
+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

data/example/android/android_app/android_app_calculator/features/calculator.feature

@@ -0,0 +1,36 @@
+Feature: Verify Calculator functionalities
+ 
+  Scenario: Click on OK button 
+    Then I click on element having id "com.android2.calculator3:id/cling_dismiss"
+
+  Scenario: Addirion
+    Then I click on element having id "com.android2.calculator3:id/digit5"
+    Then I click on element having id "com.android2.calculator3:id/plus"
+    Then I click on element having id "com.android2.calculator3:id/digit9"
+    When I click on element having id "com.android2.calculator3:id/equal"
+    Then element having xpath "//android.widget.EditText[@index=0]" should have text as "14"
+
+
+  Scenario: Substraction
+    Then I click on element having id "com.android2.calculator3:id/digit9"
+    Then I click on element having id "com.android2.calculator3:id/minus"
+    Then I click on element having id "com.android2.calculator3:id/digit5"
+    When I click on element having id "com.android2.calculator3:id/equal"
+    Then element having xpath "//android.widget.EditText[@index=0]" should have text as "4"
+
+  Scenario: Multiplication
+    Then I click on element having id "com.android2.calculator3:id/digit9"
+    Then I click on element having id "com.android2.calculator3:id/mul"
+    Then I click on element having id "com.android2.calculator3:id/digit5"
+    When I click on element having id "com.android2.calculator3:id/equal"
+    Then element having xpath "//android.widget.EditText[@index=0]" should have text as "45"
+
+  Scenario: Division
+    Then I click on element having id "com.android2.calculator3:id/digit8"
+    Then I click on element having id "com.android2.calculator3:id/div"
+    Then I click on element having id "com.android2.calculator3:id/digit2"
+    When I click on element having id "com.android2.calculator3:id/equal"
+    Then element having xpath "//android.widget.EditText[@index=0]" should have text as "4"
+
+  Scenario: Clear output
+   Then I click on element having id "com.android2.calculator3:id/clear"

data/example/android/android_app/android_app_calculator/features/my_first.feature

@@ -0,0 +1,13 @@
+#Scenario: Division
+#    Then I click on element having id "com.android2.calculator3:id/digit8"
+#    Then I click on element having id "com.android2.calculator3:id/div"
+#    Then I click on element having id "com.android2.calculator3:id/digit4"
+#    When I click on element having id "com.android2.calculator3:id/equal"
+#    Then element having xpath "//android.widget.EditText[@index=0]" should have text as "2"
+
+#  Scenario: Multiplication
+#    Then I click on element having id "com.android2.calculator3:id/digit6"
+#    Then I click on element having id "com.android2.calculator3:id/mul"
+#    Then I click on element having id "com.android2.calculator3:id/digit5"
+#    When I click on element having id "com.android2.calculator3:id/equal"
+#    Then element having xpath "//android.widget.EditText[@index=0]" should have text as "30"

data/example/android/android_app/android_app_calculator/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_app/android_app_calculator/features/support/env.rb

@@ -0,0 +1,52 @@
+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}"
+      },
+      appium_lib: { server_url: 'http://localhost:4723/wd/hub' }
+    }
+
+  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_app/android_app_calculator/features/support/hooks.rb

@@ -0,0 +1,26 @@
+#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