selenium-cucumber 0.0.8 → 0.0.9

data/doc/installation.md

@@ -1,13 +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.8.7" (or higher).
-
-If you are on Windows you can get Ruby from [RubyInstaller.org](http://rubyinstaller.org/)
-
-### Installation
-
-Install `selenium-cucumber` by running
-
-- `gem install selenium-cucumber`
-- You might have to run `sudo gem install selenium-cucumber` if you do not have the right permissions.
+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 `selenium-cucumber` gem by running
+
+- `gem install selenium-cucumber`
+

data/doc/selenium-cucumber-API.md

@@ -1,79 +1,82 @@
-selenium-cucumber API
-=====================
-
-If you are writing code for your custom steps you can use following methods
-
-
-Navigation API's
-----------------
-
-	navigate_to(link)
-
-	navigate(direction)  # direction=back or direction=forword
-
-	close_driver()
-
-
-Browser Interaction API's
--------------------------
-
-	resize_browser(width,heigth)
-
-	scroll_to_element(by,access_value)
-
-	zoom_in_out(in_out) 
-
-	zoom_in_out_till_element_display(by, in_out, access_value)
-
-
-Input API's
-------------
-
-	click(by,access_value)
-
-	submit(by,access_value)
-
-	enter_text(by,text,access_value)
-
-	clear_text(by,access_value)
-
-	check_checkbox(by, access_value)
-
-	uncheck_checkbox(by, access_value)
-
-	toggle_checkbox(by, access_value)
-
-	select_radio_button(by, access_value)
-
-	get_page_title()
-
-	get_element_text(by,access_value)
-
-	get_element_attribute(by,access_value,attribute)
-
-	is_element_enabled(by,access_value)
-
-	is_element_displayed(by,access_value)
-
-	
-Javascript Handling API
------------------------
-
-	handle_alert(decesion) # accept or dismiss
-
-	get_alert_text
-
-	
-Progress API's
---------------
-
-	wait(time_in_sec)
-
-	wait_for_element_to_display(by,access_value,duration)
-
-	wait_for_element_to_enable(by,access_value,duration)
-
-
-Screenshot API
---------------
+selenium-cucumber API
+=====================
+
+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(by,access_value)
+
+	submit(by,access_value)
+
+	enter_text(by,text,access_value)
+
+	clear_text(by,access_value)
+
+	check_checkbox(by, access_value)
+
+	uncheck_checkbox(by, access_value)
+
+	toggle_checkbox(by, access_value)
+
+	select_radio_button(by, access_value)
+
+	get_page_title()
+
+	get_element_text(by,access_value)
+
+	get_element_attribute(by,access_value,attribute)
+
+	is_element_enabled(by,access_value)
+
+	is_element_displayed(by,access_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(by,access_value,duration)
+
+	wait_for_element_to_enable(by,access_value,duration)
+
+
+Screenshot API
+--------------
 	take_screenshots

data/doc/selenium-cucumber-help.md

@@ -1,18 +1,18 @@
-
-Usage: selenium-cucumber <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
+
+Usage: selenium-cucumber <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/features-skeleton/my_first.feature

@@ -1,5 +1,5 @@
-Feature: Login feature
-
-  Scenario: As a valid user I can log into my web app
-    When I press "Login"
-    Then I see "Welcome to coolest web app ever"
+Feature: Login feature
+
+  Scenario: As a valid user I can log into my web app
+    When I press "Login"
+    Then I see "Welcome to coolest web app ever"

data/features-skeleton/step_definitions/custom_steps.rb

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

data/features-skeleton/support/env.rb

@@ -1,38 +1,38 @@
-require 'rubygems'
-require 'selenium-webdriver'
-
-def print_error
-  puts "\nInappropraite browser \"#{ENV['BROWSER']}\""
-  puts "\nUsage : cucumber BROWSER=browser_name"
-  puts "\nbrowser_name can be one of following :"
-  puts "1.ie\n2.chrome\n3.ff\n4.safari\n5.opera" 
-  puts "\nNow using default browser \"Firefox\""
-end
-
-case ENV['BROWSER']
-  when 'ie'
-    browser_type = :ie
-  when 'ff'
-    browser_type = :ff
-  when 'chrome'
-    browser_type = :chrome
-  when 'opera'
-    browser_type = :opera
-  when 'safari'
-    browser_type = :safari
-  else
-    if ENV['BROWSER']
-      print_error
-    end
-    browser_type = :ff
-end
-
-
-begin
-    $driver = Selenium::WebDriver.for(browser_type)
-    $driver.manage().window().maximize()
-
-  rescue Exception => e
-    puts e.message
-end
-
+require 'rubygems'
+require 'selenium-webdriver'
+
+def print_error
+  puts "\nInappropraite browser \"#{ENV['BROWSER']}\""
+  puts "\nUsage : cucumber BROWSER=browser_name"
+  puts "\nbrowser_name can be one of following :"
+  puts "1.ie\n2.chrome\n3.ff\n4.safari\n5.opera" 
+  puts "\nNow using default browser \"Firefox\""
+end
+
+case ENV['BROWSER']
+  when 'ie'
+    browser_type = :ie
+  when 'ff'
+    browser_type = :ff
+  when 'chrome'
+    browser_type = :chrome
+  when 'opera'
+    browser_type = :opera
+  when 'safari'
+    browser_type = :safari
+  else
+    if ENV['BROWSER']
+      print_error
+    end
+    browser_type = :ff
+end
+
+
+begin
+    $driver = Selenium::WebDriver.for(browser_type)
+    $driver.manage().window().maximize()
+
+  rescue Exception => e
+    puts e.message
+end
+

data/features-skeleton/support/hooks.rb

@@ -1,34 +1,34 @@
-#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 |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
-
-#Tagged hooks
-
-Before('@Ex_tag1, @Ex_tag2') do
-  # This will only run before scenarios tagged
-  # with @cucumis OR @sativus.
-end
-
-AfterStep('@Ex_tag1, @Ex_tag2') do
-  # This will only run after steps within scenarios tagged
-  # with @cucumis AND @sativus.
+#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 |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
+
+#Tagged hooks
+
+Before('@Ex_tag1, @Ex_tag2') do
+  # This will only run before scenarios tagged
+  # with @cucumis OR @sativus.
+end
+
+AfterStep('@Ex_tag1, @Ex_tag2') do
+  # This will only run after steps within scenarios tagged
+  # with @cucumis AND @sativus.
 end

data/lib/selenium-cucumber.rb

@@ -1,2 +1,2 @@
-
-Dir[File.dirname(__FILE__) + '/selenium-cucumber/*.rb'].each {|file| require file }
+
+Dir[File.dirname(__FILE__) + '/selenium-cucumber/*.rb'].each {|file| require file }

data/lib/selenium-cucumber/assertion_steps.rb

@@ -13,9 +13,9 @@ Then(/^element having (.+) "([^\"]*)" should\s*((?:not)?)\s+have text as "(.*?)"
 end
 
 #Step to check attribute value
-Then(/^I should\s*((?:not)?)\s+see attribute "(.*?)" having value "(.*?)" for element having (.+) "(.*?)"$/) do |present, name , value , type, access_name|
+Then(/^element having (.+) "([^\"]*)" should\s*((?:not)?)\s+have attribute "(.*?)" with value "(.*?)"$/) do |type, access_name, present, attrb, value|
   validate_locator type
-  check_element_attribute(type, name, value, access_name, present.empty?)
+  check_element_attribute(type, attrb, value, access_name, present.empty?)
 end
 
 #Step to check element enabled or not
@@ -27,7 +27,7 @@ Then(/^element having (.+) "([^\"]*)" should\s*((?:not)?)\s+be (enabled|disabled
 end
 
 #Step to check element present or not
-Then(/^element having (.+) "([^\"]*)" should\s*((?:not)?)\s+be present"$/) do |type, access_name, present|
+Then(/^element having (.+) "(.*?)" should\s*((?:not)?)\s+be present$/) do |type, access_name, present|
   validate_locator type
   check_element_presence(type, access_name, present.empty?)
 end
@@ -42,7 +42,7 @@ end
 #steps to assert radio button checked or unchecked
 Then(/^radio button having (.+) "(.*?)" should be (selected|unselected)$/) do |type, access_name, state|
   validate_locator type
-  flag = state == "checked"
+  flag = state == "selected"
   is_radio_button_selected(type, access_name, flag)
 end
 
@@ -66,4 +66,11 @@ end
 
 Then(/^I should see alert text as "(.*?)"$/) do |actual_value|
      check_alert_text(actual_value)
+end
+
+#Step tp assert dropdown list
+Then(/^option "(.*?)" by (.+) from dropdown having (.+) "(.*?)" should be (selected|unselected)$/) do |option, by, type, access_name, state|
+  validate_locator type
+  flag = state == "selected"
+  is_option_from_dropdown_selected(type,by,option,access_name,state)
 end

data/lib/selenium-cucumber/input_steps.rb

@@ -1,73 +1,69 @@
 require_relative 'methods/input_methods'
 
 #enter text into input field steps
-
 Then(/^I enter "([^\"]*)" into input field having (.+) "([^\"]*)"$/) do |text, type, access_name|
 	validate_locator type
   enter_text(type,text,access_name)
 end
 
-
 #clear input field steps
-
 Then(/^I clear input field having (.+) "([^\"]*)"$/) do |type, access_name|
   validate_locator type
 	clear_text(type, access_name)
 end
 
-
-#select option by text from dropdown/multiselect
-
-Then(/^I select "(.*?)" option by (.+) from dropdown having (.+) "(.*?)"$/) do |option,option_by, type, access_name|
+#select option by text/value from dropdown/multiselect
+Then(/^I select "(.*?)" option by (.+) from\s*((?:multiselect)?)\sdropdown having (.+) "(.*?)"$/) do |option,option_by, present, type, access_name|
 	validate_locator type
   validate_option_by option_by
   select_option_from_dropdown(type, option_by,option,access_name)
 end
 
+#select option by index from dropdown/multiselect
+Then(/^I select (\d+) option by index from\s*((?:multiselect)?)\sdropdown having (.+) "(.*?)"$/) do |option, present, type, access_name|
+  validate_locator type
+  select_option_from_dropdown(type, "index", (option.to_i)-1, access_name)
+end
 
-#unselect option from dropdown list
-
-Then(/^I unselect options from dropdown having (.+) "(.*?)"$/) do |type,access_name|
-	validate_locator type
-  unselect_option_from_dropdown(type, access_name)
+#step to select option from mutliselect dropdown list
+Then(/^I select all options from multiselect dropdown having (.+) "(.*?)"$/) do |type, access_name|
+  validate_locator type
+  select_all_option_from_multiselect_dropdown(type, access_name)
 end
 
+#step to unselect option from mutliselect dropdown list
+Then(/^I unselect all options from multiselect dropdown having (.+) "(.*?)"$/)  do |type,access_name|
+  validate_locator type
+  unselect_all_option_from_multiselect_dropdown(type, access_name)
+end
 
 #check checkbox steps
-
-Then(/^I check checkbox having (.+) "(.*?)"$/) do |type, access_name|
+Then(/^I check the checkbox having (.+) "(.*?)"$/) do |type, access_name|
   validate_locator type
   check_checkbox(type, access_name)
 end
 
 #uncheck checkbox steps
-
-Then(/^I uncheck checkbox having (.+) "(.*?)"$/) do |type, access_name|
+Then(/^I uncheck the checkbox having (.+) "(.*?)"$/) do |type, access_name|
   validate_locator type
   uncheck_checkbox(type,access_name)
 end
 
-
 #Steps to toggle checkbox
-
 Then(/^I toggle checkbox having (.+) "(.*?)"$/) do |type, access_name|
   validate_locator type
   toggle_checkbox(type,access_name)
 end
 
-
-#radio button select step
-
+#step to select radio button
 Then(/^I select radio button having (.+) "(.*?)"$/) do |type,access_name|
   validate_locator type
   select_radio_button(type,access_name)
 end
 
-
 #steps to select option by text from radio button group 
-
 Then(/^I select "(.*?)" option by (.+) from radio button group having (.+) "(.*?)"$/) do |option,option_by, type, access_name|
   validate_locator type
   validate_option_by option_by
   select_option_from_radio_button_group(type,option_by,option,access_name)
-end
+end