itms_automation 2.3 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 904e4a78575ac33d7dface663087ef82e4ab44ad5113847e6202f270a1b24810
-  data.tar.gz: 712af3032a9d31b2c87faa33b2160d813ad8b86e64c9a2295cc8a4e33cb5dde4
+  metadata.gz: e02d6e102acd4013bf31802636ca701aaadd1608bee6248aa09e5888b9c9cd7a
+  data.tar.gz: 0f1b6cc243aa17c47973df3a5ea3c6b1a29926a03bc9b45b7834d70cefef9ebb
 SHA512:
-  metadata.gz: '0458938e63e8abf1dcf8b08af8aa1558e16b880cde45e59f37721ec1d17ec943a47995287f7ecb6a5336f9c5d946b6db420ac896e37e72fac0c5f6bd5d2a755d'
-  data.tar.gz: c9d84f9eaaf65f3eac427bcd7eb582376dba266d26e7d3aa7522b224609e59138174e732b0d5e88dbd9a2badfb1a99dde45f150fe8a0cc10e0806aa65e6444c4
+  metadata.gz: 297c5058d791dca51294a6100cd8893b389621aa6e367ef4dd3a4008a0d2521ca95e494644e9f098824b73ea584c63cc0bff4e169c0042a30e13f9e9303ce85a
+  data.tar.gz: fb64697cd37e37bc7885abe33fe0d2be8be4eb4f6ec035331b613abe9d0ff14383c1eff0a54ab3c71f8ef0c6e3bdae3c109223bb3ccd24c1be2b54bc4f50a6f6

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