selenium-cucumber 0.0.9 → 0.1.0

data/doc/installation.md

@@ -1,16 +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 `selenium-cucumber` gem by running
-
-- `gem install selenium-cucumber`
-
+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,82 +1,82 @@
-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
---------------
+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

@@ -68,9 +68,14 @@ Then(/^I should see alert text as "(.*?)"$/) do |actual_value|
      check_alert_text(actual_value)
 end
 
-#Step tp assert dropdown list
+#Step to 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
+end
+
+#Step to assert difference in images
+Then(/^actual image having (.+) "(.*?)" and expected image having (.+) "(.*?)" should be similar$/) do |actual_img_access_type, actual_img_access_name, excp_img_access_type, excp_img_access_name|
+  does_images_similar?(actual_img_access_type, actual_img_access_name, excp_img_access_type, excp_img_access_name)
+end

data/lib/selenium-cucumber/click_elements_steps.rb

@@ -12,6 +12,13 @@ Then(/^I forcefully click on element having (.+) "(.*?)"$/) do |type, access_nam
 	click_forcefully(type, access_name)
 end
 
+# double click on web element
+
+Then(/^I double click on element having (.+) "(.*?)"$/) do |type, access_value|
+  	validate_locator type
+  	double_click(type, access_value)
+end
+
 #steps to click on link
 
 Then(/^I click on link having text "(.*?)"$/) do |access_name|

data/lib/selenium-cucumber/methods/assertion_methods.rb

@@ -13,7 +13,7 @@ def check_title(title)
 end
 
 #method to get element text
-def get_element_text(access_type,access_name)	
+def get_element_text(access_type,access_name)
 	return WAIT.until {$driver.find_element(:"#{access_type}" => "#{access_name}")}.text
 end
 
@@ -22,11 +22,11 @@ def check_element_text(access_type, actual_value, access_name, test_case)
 	element_text = get_element_text(access_type,access_name)
 
 	if test_case
-		if(element_text!=actual_value)		
+		if(element_text!=actual_value)
 			raise TestCaseFailed ,"Text Not Matched"
 		end
 	else
-		if(element_text==actual_value)		
+		if(element_text==actual_value)
 			raise TestCaseFailed ,"Text Matched"
 		end
 	end
@@ -37,17 +37,17 @@ def is_element_enabled(access_type,access_name)
 	return WAIT.until{$driver.find_element(:"#{access_type}" => "#{access_name}")}.enabled?
 end
 
-#Element enabled checking 
+#Element enabled checking
 def check_element_enable(access_type, access_name, test_case)
-	
+
 	result=is_element_enabled(access_type,access_name)
 
 	if test_case
-		if(!result)		
+		if(!result)
 			raise TestCaseFailed ,"Element Not Enabled"
 		end
 	else
-		if(result)		
+		if(result)
 			raise TestCaseFailed ,"Element Enabled"
 		end
 	end
@@ -60,15 +60,15 @@ end
 
 #method to check attribute value
 def check_element_attribute(access_type, attribute_name, attribute_value, access_name, test_case)
-	
+
 	attr_val=get_element_attribute(access_type, access_name, attribute_name)
-	
+
 	if test_case
-		if(attr_val!=attribute_value)	
+		if(attr_val!=attribute_value)
 			raise TestCaseFailed ,"Attribute Value Not Matched"
 		end
 	else
-		if(attr_val==attribute_value)	
+		if(attr_val==attribute_value)
 			raise TestCaseFailed ,"Attribute Value Matched"
 		end
 	end
@@ -88,7 +88,7 @@ def check_element_presence(access_type, access_name, test_case)
 	else
 		begin
 			if is_element_displayed(access_type,access_name)
-				raise "Present"	
+				raise "Present"
 			end
 		rescue Exception => e
 			if e.message=="present"
@@ -101,7 +101,7 @@ end
 #method to assert checkbox check/uncheck
 def is_checkbox_checked(access_type, access_name, should_be_checked=true)
 	checkbox = WAIT.until{$driver.find_element(:"#{access_type}" => "#{access_name}")}
-	
+
 	if !checkbox.selected? && should_be_checked
 		raise TestCaseFailed ,"Checkbox is not checked"
   elsif checkbox.selected? && !should_be_checked
@@ -112,7 +112,7 @@ end
 #method to assert radio button selected/unselected
 def is_radio_button_selected(access_type, access_name, should_be_selected=true)
 	radio_button = WAIT.until{$driver.find_element(:"#{access_type}" => "#{access_name}")}
-  
+
   	if !radio_button.selected? && should_be_selected
 		raise TestCaseFailed ,"Radio Button not selected"
   	elsif radio_button.selected? && !should_be_selected
@@ -124,11 +124,11 @@ end
 #method to assert option from radio button group is selected/unselected
 def is_option_from_radio_button_group_selected(access_type, by, option, access_name, should_be_selected=true)
   radio_button_group = WAIT.until{$driver.find_elements(:"#{access_type}" => "#{access_name}")}
-  
-  getter = ->(rb, by) { by == 'value' ? rb.attribute('value') : rb.text }	
-  
+
+  getter = ->(rb, by) { by == 'value' ? rb.attribute('value') : rb.text }
+
   ele = radio_button_group.find { |rb| getter.call(rb, by) == option }
-  
+
   if !ele.selected? && should_be_selected
     raise TestCaseFailed ,'Radio button is not selected'
   elsif ele.selected? && !should_be_selected
@@ -151,18 +151,68 @@ end
 def is_option_from_dropdown_selected(access_type, by, option, access_name, should_be_selected=true)
 	dropdown = WAIT.until {$driver.find_element(:"#{access_type}" => "#{access_name}")}
   	select_list = Selenium::WebDriver::Support::Select.new(dropdown)
-  	
-  	puts select_list.first_selected_option.attribute("value")
 
   	if by=="text"
   		actual_value = select_list.first_selected_option.text
   	else
   		actual_value = select_list.first_selected_option.attribute("value")
   	end
-  	
+
   	if !actual_value==option && should_be_selected
-  		raise "Option Not Selected From Dropwdown"
+  		raise TestCaseFailed , "Option Not Selected From Dropwdown"
   	elsif actual_value==option && !should_be_selected
-  		raise "Option Selected From Dropwdown"
+  		raise TestCaseFailed , "Option Selected From Dropwdown"
   	end
-end
+end
+
+#Method to find difference between images
+def does_images_similar?(actual_img_access_type, actual_img_access_name, excp_img_access_type, excp_img_access_name)
+	if !compare_image(actual_img_access_type, actual_img_access_name, excp_img_access_type, excp_img_access_name)
+		raise TestCaseFailed , "Actual image is different from expected image" 
+	end
+end
+
+#Method to compare two images
+def compare_image(actual_img_access_type, actual_img_access_name, excp_img_access_type, excp_img_access_name)
+
+	if actual_img_access_type!="path"
+		actual_img_url = get_element_attribute(actual_img_access_type, actual_img_access_name, "src")
+	else
+		actual_img_url = actual_img_access_name
+	end
+
+	if excp_img_access_type!="path"
+		expected_img_url = get_element_attribute(excp_img_access_type, excp_img_access_name, "src")
+	else
+		expected_img_url = excp_img_access_name
+	end
+
+	images = [
+	  ChunkyPNG::Image.from_file(open(actual_img_url)),
+	  ChunkyPNG::Image.from_file(open(expected_img_url))
+	 ]
+
+	 diff = []
+
+	 images.first.height.times do |y|
+	  images.first.row(y).each_with_index do |pixel, x|
+	    diff << [x,y] unless pixel == images.last[x,y]
+	  end
+	 end
+
+	if diff.length != 0
+		puts "\npixels (total):     #{images.first.pixels.length}"
+		puts "pixels changed:     #{diff.length}"
+		puts "pixels changed (%): #{(diff.length.to_f / images.first.pixels.length) * 100}%"
+
+		x, y = diff.map{ |xy| xy[0] }, diff.map{ |xy| xy[1] }
+	    images.last.rect(x.min, y.min, x.max, y.max, ChunkyPNG::Color.rgb(0,255,0))
+	    curTime = Time.now.strftime('%Y%m%d%H%M%S%L')
+	    images.last.save("difference_#{curTime}.png")
+	    
+	    puts "\nDifference between images saved as : difference_#{curTime}.png\n"
+		return false
+	else
+		return true
+	end
+end