watir_helper 0.1.2

data/README

@@ -0,0 +1,170 @@
+About this Utility:
+    
+This is a utility(watir_helper) developed for making Automation Testing faster, simpler and easier through WATIR.
+
+Features:-
+  
+1. No need to create an IE Instance.
+  
+2. Just include this gem and use it's parameterized functions some of which are given as follows:-
+
+     # goto_page("http://www.google.com")
+     
+     # set_texfield("name","q","Ruby")
+     
+     # click_button("name","btnG")
+     
+     # verify_text("Ruby")
+     
+     # close_browser()   
+    
+  Due to this feature Automation Testing task will be easier and faster because we have to just use the functions of this gem.
+  
+3. All the functions are available in the lib/watir_helper folder for different type of elements of a website.
+  
+4. Pop-up handling is easy using given parameterized functions in this gem.
+  
+5. To enable the Pop-up handling, execute the following steps on your command prompt :-
+    
+   - cd C:\ruby\lib\ruby\gems\1.8\gems\watir-1.6.2\lib\watir
+    
+   - regsvr32 AutoItX3.dll
+    
+   - You will get a pop-up of successful registration , press "OK" button on it.
+   
+   Now, You can easily handle pop-up's.
+  
+6. Can add functions into this gem as WATIR is an Open Source tool.
+  
+  
+Prerequisites:
+
+Install Ruby: http://ruby-lang.org
+    
+  First you need to install Ruby using the one-click installer for Windows. We
+   recommend Ruby 1.8.6. (Even if you are using modal dialogs.)
+
+
+
+Install Watir:
+   
+Watir is packaged as a gem, a Ruby library that can be installed over the
+   internet.
+
+   
+
+Note:
+ 
+ The latest version of Watir is 1.6.5 whose close function doesn't work fine if we handle pop-up's in our  scripts.But close function of Watir 1.6.2 works fine with pop-up handling.Watir 1.6.2 was released in November  2009. 
+ 
+ To install it, type this at command prompt:
+      
+  gem install watir (for latest version)
+  gem install watir
+
+ -v 1.6.2 (for version 1.6.2) 
+ 
+Install rspec:
+  
+ gem install rspec (This will download the latest version)
+  
+ gem install rspec -v 1.1.3 (This version is also needed because of some compatibility issue)
+
+
+
+Install rake:
+  
+ gem install rake 
+
+
+
+Install IE Devleoper Toolbar from the site
+ 
+  http://www.microsoft.com/downloads/details.aspx?familyid=e59c3964-672d-4511-bb3e-2d5e1db91038&displaylang=en
+
+How 
+   To Use:
+ This only works on Windows.Requires Internet Explorer 5.5 or newer.
+Typical Usage
+   
+     # include my utility(watir_helper)
+   
+        require 'watir_helper'
+   
+     # include the module inside it
+   
+        include WatirHelper
+   
+     # Go to the Google home page
+   
+        goto_page("http://www.google.com/")
+   
+     # print Title 
+   
+        puts get_title
+   
+     # print Url
+   
+        puts get_url
+   
+     # Flash the Google logo on the home page   
+   
+        flash_image("id","logo")
+   
+     # Check whether Google logo image exists or not
+   
+        puts exists_image("id","logo")
+   
+     # Set the search field to Ruby
+   
+        set_textfield("name","q","Ruby")
+   
+     # Highlight the Google Search button
+   
+        flash_button("value","Google Search")
+   
+     # Click the Google Search button
+   
+        click_button("value","Google Search")
+
+
+
+
+Pop Up's Support
+ :-   
+ Watir now optionally installs AutoIt - http://www.autoitscript.com/
+   
+ This is the prefered method for dealing wth pop ups, file requesters etc.
+
+ To enable the same, execute the following steps on your command prompt :-
+  
+   - cd C:\ruby\lib\ruby\gems\1.8\gems\watir-1.6.2\lib\watir
+  
+   - regsvr32 AutoItX3.dll
+  
+   - You will get a pop-up of successful registration , press "OK" button on it.
+ 
+  Now,You can easily handle pop-up's. 
+
+  
+ 
+ Note: The latest version of Watir is 1.6.5 whose close function doesn't work fine if we handle pop-up's in our        scripts.But close function of Watir 1.6.2 works fine with pop-up handling. 
+
+
+
+Contacts:
+    
+  The mailing list: http://groups.google.com/group/watir-general
+    
+  E-mail :- ankurgera@gmail.com
+
+
+            yashasree.barve@gmail.com 
+             
+Contributors:
+ Ankur Gera
+ 
+              Yashasree Barve
+   
+Thanks for your ideas and support
+.

data/lib/watir_helper/browser_helper.rb

@@ -0,0 +1,62 @@
+require 'watir_helper/common_helpers'
+
+module BrowserHelper
+
+#Go to a page.
+def goto_page(url)
+ $ie.goto(url)
+end
+
+#Go to the next page.
+def goto_next_page()
+ $ie.forward
+end
+
+#Go to the previous page.
+def goto_previous_page()
+ $ie.back
+end
+
+#Refresh the page.
+def refresh_the_page()
+  $ie.refresh
+end
+
+#Close the browser.
+def close_browser()
+  title=get_title()
+ $ai.WinKill(title)
+end
+
+#Get the title of the browser.
+def get_title()
+  $ie.title
+end
+
+#Get the url of the browser.
+def get_url()
+  $ie.url
+end
+
+#Attach an IE instance.
+def attach_an_IE_window(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie=Watir::IE.attach(property.intern,propertyvalue)
+end
+
+#Minimize the browser.
+def minimize_browser()
+  $ie.minimize
+end
+
+#Maximize the browser.
+def maximize_browser()
+  $ie.maximize
+end
+
+#Verify whether text is present or not.
+def verify_text(text)
+  $ie.text.include?(text)
+end
+
+end

data/lib/watir_helper/button_helper.rb

@@ -0,0 +1,42 @@
+require 'watir_helper/common_helpers'
+
+module ButtonHelper
+
+#Click a button.  
+def click_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.button(property.intern,propertyvalue).click
+end
+
+#Click a button ,after clicking which a pop-up will come.
+def click_button_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.button(property.intern,propertyvalue).click_no_wait
+end
+
+#Double Click a button.  
+def double_click_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.button(property.intern,propertyvalue).fire_event("ondblclick") 
+end
+
+#Double Click a button ,after clicking which a pop-up will come.  
+def double_click_button_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.button(property.intern,propertyvalue).fire_event_no_wait("ondblclick") 
+end
+
+#Highlight or Flash a button.  
+def flash_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.button(property.intern,propertyvalue).flash
+end
+
+#Check whether a button exists or not.
+def exists_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.button(property.intern,propertyvalue).exists?
+end
+
+end
+

data/lib/watir_helper/checkbox_helper.rb

@@ -0,0 +1,35 @@
+require 'watir_helper/common_helpers'
+
+module CheckBoxHelper
+
+#Click a checkbox.   
+def click_checkbox(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.checkbox(property.intern,propertyvalue).set
+end
+
+#Clear a checkbox.   
+def clear_checkbox(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.checkbox(property.intern,propertyvalue).clear
+end
+
+#Highlight or Flash a checkbox.   
+def flash_checkbox(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.checkbox(property.intern,propertyvalue).flash
+end
+
+#Check whether a checkbox exists or not.
+def exists_checkbox(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.checkbox(property.intern,propertyvalue).exists?
+end
+
+#Check whether a checkbox is checked/set or not.
+def is_checked_checkbox(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.checkbox(property.intern,propertyvalue).checked?
+end
+
+end

data/lib/watir_helper/common_helpers.rb

@@ -0,0 +1,9 @@
+require 'watir'
+require 'rubygems'
+
+
+#Create a new instance of IE. 
+$ie=Watir::IE.new
+#Initialize variable "settext" with the value nil.
+$settext=nil
+

data/lib/watir_helper/div_helper.rb

@@ -0,0 +1,41 @@
+require 'watir_helper/common_helpers'
+
+module DivHelper
+
+#Click a div.
+def click_div(property,propertyvalue)
+   propertyvalue=/#{propertyvalue}/
+  $ie.div(property.intern,propertyvalue).click
+end
+
+#Click a div, after clicking which a pop-up will come.
+def click_div_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.div(property.intern,propertyvalue).click_no_wait
+end
+
+#Double Click a div.
+def double_click_div(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.div(property.intern,propertyvalue).fire_event("ondblclick")
+end
+
+#Double Click a div, after clicking which a pop-up will come.
+def double_click_div_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.div(property.intern,propertyvalue).fire_event_no_wait("ondblclick")
+end
+
+#Highlight or Flash a div.
+def flash_div(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.div(property.intern,propertyvalue).flash
+end
+
+#Check whether a div exists or not.
+def exists_div(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.div(property.intern,propertyvalue).exists?
+end
+
+end

data/lib/watir_helper/frame_helper.rb

@@ -0,0 +1,92 @@
+require 'watir_helper/common_helpers'
+
+module FrameHelper
+
+#Click a link inside a frame.  
+def click_link_inside_frame(frame_prop,frame_prop_val,link_prop,link_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  link_prop_val=/#{link_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).link(link_prop.intern,link_prop_val).click
+end
+
+#Click a button inside a frame.  
+def click_button_inside_frame(frame_prop,frame_prop_val,button_prop,button_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  button_prop_val=/#{button_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).button(button_prop.intern,button_prop_val).click
+end
+
+#Click an image inside a frame.  
+def click_image_inside_frame(frame_prop,frame_prop_val,image_prop,image_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  image_prop_val=/#{image_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).image(image_prop.intern,image_prop_val).click
+end
+
+#Click a checkbox inside a frame.  
+def click_checkbox_inside_frame(frame_prop,frame_prop_val,checkbox_prop,checkbox_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  checkbox_prop_val=/#{checkbox_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).checkbox(checkbox_prop.intern,checkbox_prop_val).click
+end
+
+#Click a radio button inside a frame.  
+def click_radio_button_inside_frame(frame_prop,frame_prop_val,radio_prop,radio_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  radio_prop_val=/#{radio_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).radio(radio_prop.intern,radio_prop_val).click
+end
+
+#Select from a select list inside a frame.  
+def select_from_select_list_inside_frame(frame_prop,frame_prop_val,select_list_prop,select_list_prop_val,select_value)
+  frame_prop_val=/#{frame_prop_val}/
+  select_list_prop_val=/#{select_list_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).select_list(select_list_prop.intern,select_list_prop_val).select(select_value)
+end
+
+#Highlight or Flash a link inside a frame.  
+def flash_link_inside_frame(frame_prop,frame_prop_val,link_prop,link_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  link_prop_val=/#{link_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).link(link_prop.intern,link_prop_val).flash
+end
+
+#Highlight or Flash a button inside a frame.  
+def flash_button_inside_frame(frame_prop,frame_prop_val,button_prop,button_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  button_prop_val=/#{button_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).button(button_prop.intern,button_prop_val).flash
+end
+
+#Highlight or Flash an image inside a frame.  
+def flash_image_inside_frame(frame_prop,frame_prop_val,image_prop,image_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  image_prop_val=/#{image_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).image(image_prop.intern,image_prop_val).flash
+end
+
+#Highlight or Flash a checkbox inside a frame.  
+def flash_checkbox_inside_frame(frame_prop,frame_prop_val,checkbox_prop,checkbox_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  checkbox_prop_val=/#{checkbox_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).checkbox(checkbox_prop.intern,checkbox_prop_val).flash
+end
+
+#Highlight or Flash a radio button inside a frame.  
+def flash_radio_button_inside_frame(frame_prop,frame_prop_val,radio_prop,radio_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  radio_prop_val=/#{radio_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).radio(radio_prop.intern,radio_prop_val).flash
+end
+
+#Highlight or Flash a select list inside a frame.  
+def flash_select_list_inside_frame(frame_prop,frame_prop_val,select_list_prop,select_list_prop_val)
+  frame_prop_val=/#{frame_prop_val}/
+  select_list_prop_val=/#{select_list_prop_val}/
+  $ie.frame(frame_prop.intern,frame_prop_val).select_list(select_list_prop.intern,select_list_prop_val).flash
+end
+
+end
+
+
+

data/lib/watir_helper/image_helper.rb

@@ -0,0 +1,41 @@
+require 'watir_helper/common_helpers'
+
+module ImageHelper
+
+#Click an image.    
+def click_image(property,propertyvalue)
+   propertyvalue=/#{propertyvalue}/
+  $ie.image(property.intern,propertyvalue).click
+end
+
+#Click an image ,after clicking which a pop-up will come.
+def click_image_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.image(property.intern,propertyvalue).click_no_wait
+end
+
+#Double Click an image.  
+def double_click_image(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.image(property.intern,propertyvalue).fire_event("ondblclick") 
+end
+
+#Double Click an image ,after clicking which a pop-up will come.  
+def double_click_image_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.image(property.intern,propertyvalue).fire_event_no_wait("ondblclick") 
+end
+
+#Highlight or Flash an image.  
+def flash_image(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.image(property.intern,propertyvalue).flash
+end
+
+#Check whether an image exists or not.
+def exists_image(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.image(property.intern,propertyvalue).exists?
+end
+
+end

data/lib/watir_helper/include_all_helpers.rb

@@ -0,0 +1,51 @@
+require 'watir_helper/button_helper'
+include ButtonHelper
+require 'watir_helper/checkbox_helper'
+include CheckBoxHelper
+require 'watir_helper/frame_helper'
+include FrameHelper
+require 'watir_helper/image_helper'
+include ImageHelper
+require 'watir_helper/link_helper'
+include LinkHelper
+
+#Pop Up's Support
+#   Watir now optionally installs AutoIt - http://www.autoitscript.com/
+#   This is the prefered method for dealing wth pop ups, file requesters etc. 
+# To enable the same, execute the following steps on your command prompt
+#  - cd C:\ruby\lib\ruby\gems\1.8\gems\watir-1.6.2\lib\watir
+#  - regsvr32 AutoItX3.dll
+#  - You will get a pop-up of successful registration , press "OK" button on it.
+# Now,You can easily handle pop-up's.
+require 'watir_helper/popup_handling_helper'
+include PopupHelper
+
+require 'watir_helper/radio_button_helper'
+include RadioButtonHelper
+require 'watir_helper/select_list_helper'
+include SelectListHelper
+require 'watir_helper/textfield_helper'
+include TextFieldHelper
+require 'watir_helper/validations_helper'
+include ValidationsHelper
+require 'watir_helper/browser_helper'
+include BrowserHelper
+require 'watir_helper/login_helper'
+include LoginHelper
+require 'watir_helper/span_helper'
+include SpanHelper
+require 'watir_helper/table_helper'
+include TableHelper
+require 'watir_helper/div_helper'
+include DivHelper
+
+
+
+
+
+
+
+
+
+
+

data/lib/watir_helper/link_helper.rb

@@ -0,0 +1,29 @@
+require 'watir_helper/common_helpers'
+
+module LinkHelper
+
+#Click a link.    
+def click_link(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.link(property.intern,propertyvalue).click
+end
+
+#Click a link ,after clicking which a pop-up will come.
+def click_link_with_popup(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.link(property.intern,propertyvalue).click_no_wait
+end
+
+#Highlight or Flash a link.  
+def flash_link(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.link(property.intern,propertyvalue).flash
+end
+
+#Check whether a link exists or not.
+def exists_link(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.link(property.intern,propertyvalue).exists?
+end
+
+end

data/lib/watir_helper/login_helper.rb

@@ -0,0 +1,32 @@
+require 'watir_helper/common_helpers'
+
+module LoginHelper
+
+#Login using button into an application.
+def login_using_button(user_prop,user_prop_value,username,pass_prop,pass_prop_value,password,btn_prop,btn_prop_value)
+  btn_prop=/#{btn_prop}/
+  btn_prop_value=/#{btn_prop_value}/
+ $ie.text_field(user_prop.intern,user_prop_value).set(username)
+ $ie.text_field(pass_prop.intern,pass_prop_value).set(password)
+ $ie.button(btn_prop.intern,btn_prop_value).click
+end
+
+#Login using link into an application.
+def login_using_link(user_prop,user_prop_value,username,pass_prop,pass_prop_value,password,link_prop,link_prop_value)
+  link_prop=/#{link_prop}/
+  link_prop_value=/#{link_prop_value}/
+ $ie.text_field(user_prop.intern,user_prop_value).set(username)
+ $ie.text_field(pass_prop.intern,pass_prop_value).set(password)
+ $ie.link(link_prop.intern,link_prop_value).click
+end
+
+#Login using image into an application.
+def login_using_image(user_prop,user_prop_value,username,pass_prop,pass_prop_value,password,img_prop,img_prop_value)
+  img_prop=/#{img_prop}/
+  img_prop_value=/#{img_prop_value}/
+ $ie.text_field(user_prop.intern,user_prop_value).set(username)
+ $ie.text_field(pass_prop.intern,pass_prop_value).set(password)
+ $ie.image(img_prop.intern,img_prop_value).click
+end
+
+end

data/lib/watir_helper/popup_handling_helper.rb

@@ -0,0 +1,102 @@
+require 'win32ole'
+
+#Pop Up's Support
+#   Watir now optionally installs AutoIt - http://www.autoitscript.com/
+#   This is the prefered method for dealing wth pop ups, file requesters etc. 
+# To enable the same, execute the following steps on your command prompt
+#  - cd C:\ruby\lib\ruby\gems\1.8\gems\watir-1.6.2\lib\watir
+#  - regsvr32 AutoItX3.dll
+#  - You will get a pop-up of successful registration , press "OK" button on it.
+# Now,You can easily handle pop-up's.
+
+# Note:
+#   The latest version of Watir is 1.6.5 whose close function doesn't work fine if we  
+#   handle pop-up's in our scripts.But close function of Watir 1.6.2 works fine with
+#   pop-up handling. 
+
+#Create an OLE connection for handling pop-up's.
+$ai=WIN32OLE.new("AutoItX3.Control")
+
+#******************************************************
+#Pop-up handling methods
+#******************************************************
+
+module PopupHelper
+
+#Javascript pop-up's.  
+
+#Click on a button on a pop-up.  
+def click_a_button_on_a_popup(title,click_element_id)
+$ai.WinWait(title,"",30)
+$ai.WinActivate(title)
+$ai.ControlClick(title,"",click_element_id)   
+end
+  
+#Click on "OK" button on a javascript pop-up.  
+def click_ok_on_javascript_popup(title)
+click_a_button_on_a_popup(title,"","OK")
+end
+
+#Click on "Cancel" button on a javascript pop-up.  
+def click_cancel_on_javascript_popup(title)
+click_a_button_on_a_popup(title,"","Cancel")
+end
+
+#Click on "Yes" button on a javascript pop-up.  
+def click_yes_on_javascript_popup(title)
+click_a_button_on_a_popup(title,"","&Yes")
+end
+
+#Click on "No" button on a javascript pop-up.  
+def click_no_on_javascript_popup(title)
+click_a_button_on_a_popup(title,"","&No")
+end
+
+#File Dialogs
+#Click on "Open" button on a file dialog pop-up.  
+def click_open_on_file_dialog_popup(title)
+click_a_button_on_a_popup(title,"&Open")
+end
+
+#Click on "Save" button on a file dialog pop-up.  
+def click_save_on_file_dialog_popup(title)
+click_a_button_on_a_popup(title,"&Save")
+end
+
+#Click on "Cancel" button on a file dialog pop-up.  
+def click_cancel_on_file_dialog_popup(title)
+click_a_button_on_a_popup(title,"Cancel")
+end
+
+#Save As
+#Click on a button on a Save As or Open pop-up.  
+def click_a_button_on_save_or_open_popup(title,file_path,click_element_id)
+$ai.WinWait(title,"",30)
+$ai.WinActivate(title)
+$ai.ControlSend(title,"","Edit1",file_path)
+$ai.ControlClick(title,"",click_element_id)
+end
+
+#Click on "Save" button on a Save As pop-up.  
+def click_save_on_save_as_popup(title,save_file_path)
+click_a_button_on_save_or_open_popup(title,save_file_path,"&Save")
+end
+
+#Click on "Cancel" button on a Save As pop-up.  
+def click_cancel_on_save_as_popup(title,save_file_path)
+click_a_button_on_save_or_open_popup(title,save_file_path,"Cancel")
+end
+
+#Open
+#Click on "Open" button on an Open pop-up.  
+def click_open_on_open_as_popup(title,open_file_path)
+click_a_button_on_save_or_open_popup(title,open_file_path,"&Open")
+end
+
+#Click on "Cancel" button on an Open pop-up.  
+def click_cancel_on_open_as_popup(title,open_file_path)
+click_a_button_on_save_or_open_popup(title,open_file_path,"Cancel")
+end
+
+end
+

data/lib/watir_helper/radio_button_helper.rb

@@ -0,0 +1,35 @@
+require 'watir_helper/common_helpers'
+
+module RadioButtonHelper
+
+#Click a radio button.    
+def click_radio_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.radio(property.intern,propertyvalue).set
+end
+
+#Clear a radio button.    
+def clear_radio_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.radio(property.intern,propertyvalue).clear
+end
+
+#Highlight or Flash a radio button.  
+def flash_radio_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.radio(property.intern,propertyvalue).flash
+end
+
+#Check whether a radio button exists or not.
+def exists_radio_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.radio(property.intern,propertyvalue).exists?
+end
+
+#Check whether a radio button is checked or not.
+def is_checked_radio_button(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+ $ie.radio(property.intern,propertyvalue).checked?
+end
+
+end

data/lib/watir_helper/select_list_helper.rb

@@ -0,0 +1,41 @@
+require 'watir_helper/common_helpers'
+
+module SelectListHelper
+
+#Select from a Select list.
+def select_from_select_list(property,propertyvalue,selected_value)
+ propertyvalue=/#{propertyvalue}/ 
+$ie.select_list(property.intern,propertyvalue).select(selected_value)
+end
+
+#Clear selection from a Select list.
+def clear_selection_from_select_list(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+$ie.select_list(property.intern,propertyvalue).clearSelection
+end
+
+#Get all contents of a Select list.
+def get_all_contents_of_select_list(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+$ie.select_list(property.intern,propertyvalue).getAllContents
+end
+
+#Highlight or Flash a Select list.  
+def flash_select_list(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+$ie.select_list(property.intern,propertyvalue).flash
+end
+
+#Check whether a Select list exists or not.
+def exists_select_list(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+$ie.select_list(property.intern,propertyvalue).exists?
+end
+
+#Check whether a particular value is selected from a Select list or not.
+def is_value_selected_from_select_list(property,propertyvalue,selected_value)
+  propertyvalue=/#{propertyvalue}/
+ $ie.select_list(property.intern,propertyvalue).selected?(selected_value)
+end
+
+end

data/lib/watir_helper/span_helper.rb

@@ -0,0 +1,17 @@
+require 'watir_helper/common_helpers'
+
+module SpanHelper
+
+#Highlight or Flash a span.
+def flash_span(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.span(property.intern,propertyvalue).flash
+end
+
+#Check whether a span exists or not.
+def exists_span(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.span(property.intern,propertyvalue).exists?
+end
+
+end

data/lib/watir_helper/table_helper.rb

@@ -0,0 +1,24 @@
+require 'watir_helper/common_helpers'
+
+module TableHelper
+
+#Highlight or Flash a table.
+def flash_table(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.table(property.intern,propertyvalue).flash
+end
+
+#Check whether a table exists or not.
+def exists_table(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.table(property.intern,propertyvalue).exists?
+end
+
+#Return the table contents.
+def return_table_contents(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.table(property.intern,propertyvalue).to_a
+end
+
+end
+

data/lib/watir_helper/textfield_helper.rb

@@ -0,0 +1,51 @@
+require 'watir_helper/common_helpers'
+
+module TextFieldHelper
+
+#Set a texfield with a text.   
+def set_textfield(property,propertyvalue,settextvalue)
+  $settext=settextvalue
+  $ie.text_field(property.intern,propertyvalue).set settextvalue
+end
+
+#Get the text from the textfield.
+def get_textfield()
+  if $settext.nil?
+    return nil
+  else
+    return $settext
+  end
+end
+
+#Clear a texfield.   
+def clear_textfield(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.text_field(property.intern,propertyvalue).clear
+end
+
+#Highlight or Flash a textfield.  
+def flash_textfield(property,propertyvalue)
+  propertyvalue=/#{propertyvalue}/
+  $ie.text_field(property.intern,propertyvalue).flash
+end
+
+#Check whether a textfield exists or not.
+def exists_textfield(property,propertyvalue) 
+  propertyvalue=/#{propertyvalue}/
+  $ie.text_field(property.intern,propertyvalue).exists?
+end
+
+#Check whether a textfield is blank or not.
+def is_blank_textfield()
+  return $settext.nil? ? true : false 
+end
+
+end
+
+
+
+
+
+
+
+

data/lib/watir_helper/validations_helper.rb

@@ -0,0 +1,144 @@
+require 'watir_helper/common_helpers'
+
+module ValidationsHelper
+
+#Check whether a character range is present in a textfield or not.  
+def validate_chars_range_contain_textfield(range_start,range_end) #for positive integers and chars range
+  if (range_start <= range_end) and (range_start.length==1) and (range_end.length==1) 
+   puts $settext.gsub(/[#{range_start}-#{range_end}]/,'*').index('*')? "Present" : "Not Present"  
+  else
+   puts "Error!!! :-Please input a valid range"
+  end
+end
+
+#Check whether a substring is present in a textfield or not.  
+def contains_sub_string(substring)
+ return $settext.sub(substring,'*').index('*') ? true : false    
+end
+
+#Check whether a date is in mmddyyyy format or not.  
+def validate_date_format_mmddyyyy(date)
+ if(date =~ /^(0[1-9]|1[012])[- \/.](0[1-9]|[12][0-9]|3[01])[- \/.](19|20)\d\d$/).nil?
+   puts "Invalid Date(mmddyyyy) Format"
+ else  
+   puts "Valid Date(mmddyyyy) Format"
+ end
+end
+
+#Check whether a date is in ddmmyyyy format or not.  
+def validate_date_format_ddmmyyyy(date)
+ if(date=~/^(0[1-9]|[12][0-9]|3[01])[- \/.](0[1-9]|1[012])[- \/.](19|20)\d\d$/).nil?
+   puts "Invalid Date(ddmmyyyy) Format"
+ else  
+   puts "Valid Date(ddmmyyyy) Format"
+ end
+end
+
+#Check whether the age entered is in the given range or not.  
+def is_age_in_the_range(range_start,range_end)
+ if ($settext.to_i>=range_start.to_i and $settext.to_i<=range_end.to_i)
+    return true
+ else
+    return false
+ end
+end
+
+#Check whether e-mail adress supplied is valid or not.  
+def validate_email_address(email_id)
+ if(email_id=~/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}$/).nil?
+  puts "Invalid E-mail id Format"
+ else  
+  puts "Valid E-mail id Format"
+ end
+end
+
+#Check whether the indian mobile number entered is valid or not.  
+def validate_indian_mobile_number(mobile_no)
+ if(mobile_no.to_i>0)
+   if(mobile_no.length==10)
+     if(mobile_no=~/^([9]{1})([023456789]{1})([0-9]{8})$/).nil?
+       puts "Wrong Mobile number format"
+     else
+       puts "Correct Mobile number format"
+     end
+   elsif(mobile_no.length<10)
+    puts "Error!!!! :- Mobile number length is less than 10 digit"
+   elsif(mobile_no.length>10)
+    puts "Error!!!! :- Mobile number length is more than 10 digit"
+   end
+ else
+   puts "Error!!!! :- Mobile number can't be negative"
+ end
+end
+ 
+#Check whether the indian landline number entered is valid or not.  
+def validate_indian_landline_number(landline_no)#like "020-30303030"
+ if(landline_no.length==12) #In India landline number should be of 10 digits including std code
+    #Here we will prefix "0" before std code and "-" between std code and the respective landline number
+    if(landline_no=~/^[0]{1}[1-9]{1}[0-9]{1,3}[\-]{1}[1-9]{1}[0-9]{5,7}$/).nil?
+      puts "Wrong Landline number format"
+    else
+      puts "Correct Landline number format"
+    end
+ else
+  puts "Error!!!! :- Wrong Landline number format"
+ end
+end
+
+#Check whether the value entered is an Integer or not.  
+def is_an_Integer(value)
+ value.is_a?(Integer) 
+end
+
+#Check whether the value entered is a Float or not.  
+def is_a_Float(value)
+ value.is_a?(Float) 
+end
+
+#Check whether the value entered is a String or not.  
+def is_a_String(value)
+ value.is_a?(String)
+end
+
+#Check whether the value entered is a Regular Expression or not.  
+def is_a_reg_exp(value)
+ value.is_a?(Regexp) 
+end
+
+
+#Check whether the value entered is a Character or not.  
+def is_a_char(value) #Like "3",'3',"a",'a'
+  value.length==1
+end
+
+#Check whether the value entered contains a string or not.  
+def contain_chars(char_set)
+ is_string_contains_character_set($settext,char_set) 
+end
+
+#Check whether a string contains a regular expression or not.  
+def is_string_contains_reg_exp_character_set(char_string,char_set) 
+  flag=0 #Here char_set is a regular expression of characters
+ #The format for regular expression of character set(or char_set) should be like /[$#!@^*&()~]/
+ if(char_string.sub(char_set,'**').index('**') ? true : false)==true
+    flag=1
+  end
+  flag==1 
+end
+
+#Check whether a string contains another string or not.  
+def is_string_contains_character_set(char_string,char_set) 
+  flag=0 #Here char_set is a string of characters 
+  char_set.each_byte do |char|
+   if(char_string.sub(char.chr.to_s,'**').index('**') ? true : false )==true
+     flag=1
+   end
+  end
+  flag==1
+end
+
+end
+
+
+
+

data/lib/watir_helper.rb

@@ -0,0 +1,9 @@
+require 'watir_helper/common_helpers'
+
+
+module WatirHelper 
+
+require 'watir_helper/include_all_helpers'
+
+end
+

data/test/testing_watir_helper.rb

@@ -0,0 +1,37 @@
+require 'watir_helper'
+include WatirHelper
+
+goto_page("http://www.google.com/")
+puts get_title
+puts get_url
+flash_div("id","hplogo")
+puts exists_div("id","hplogo")
+set_textfield("name","q","Ruby")
+flash_button("value","Google Search")
+click_button("value","Google Search")
+
+
+#Pop Up's Support
+#   Watir now optionally installs AutoIt - http://www.autoitscript.com/
+#   This is the prefered method for dealing wth pop ups, file requesters etc. 
+# To enable the same, execute the following steps on your command prompt
+#  - cd C:\ruby\lib\ruby\gems\1.8\gems\watir-1.6.2\lib\watir
+#  - regsvr32 AutoItX3.dll
+#  - You will get a pop-up of successful registration , press "OK" button on it.
+# Now,You can easily handle pop-up's.
+
+# Note:
+#   The latest version of Watir is 1.6.5 whose close function doesn't work fine if we  
+#   handle pop-up's in our scripts.But close function of Watir 1.6.2 works fine with
+#   pop-up handling. 
+
+#goto_page("http://www.autoitscript.com/autoit3/downloads.shtml")
+#click_image_with_popup("src","download_autoit")
+#click_save_on_file_dialog_popup("File Download - Security Warning")
+#click_save_on_save_as_popup("Save As","C:\AutoItV3.exe")
+#puts get_title
+#puts get_url
+
+close_browser()
+
+

data/test/testing_watir_helper_spec.rb

@@ -0,0 +1,25 @@
+require 'watir_helper'
+include WatirHelper
+
+describe "Scenario :- Google page test" do
+  
+  before(:all) do
+    goto_page("http://www.google.com/")
+  end
+  
+  it "Should verify whether we are on the Landing Page or not" do
+   puts get_title
+   puts get_url
+   flash_image("id","logo")
+   puts exists_image("id","logo")
+   set_textfield("name","q","Ruby")
+   flash_button("value","Google Search")
+   click_button("value","Google Search")
+  end
+  
+  after(:all) do
+   close_browser()
+  end
+  
+end
+

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: watir_helper
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+  prerelease: 
+platform: ruby
+authors:
+- Ankur Gera
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-16 00:00:00.000000000 -04:00
+default_executable: 
+dependencies: []
+description: 
+email: ankurgera@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README
+files:
+- lib/watir_helper/browser_helper.rb
+- lib/watir_helper/button_helper.rb
+- lib/watir_helper/checkbox_helper.rb
+- lib/watir_helper/common_helpers.rb
+- lib/watir_helper/div_helper.rb
+- lib/watir_helper/frame_helper.rb
+- lib/watir_helper/image_helper.rb
+- lib/watir_helper/include_all_helpers.rb
+- lib/watir_helper/link_helper.rb
+- lib/watir_helper/login_helper.rb
+- lib/watir_helper/popup_handling_helper.rb
+- lib/watir_helper/radio_button_helper.rb
+- lib/watir_helper/select_list_helper.rb
+- lib/watir_helper/span_helper.rb
+- lib/watir_helper/table_helper.rb
+- lib/watir_helper/textfield_helper.rb
+- lib/watir_helper/validations_helper.rb
+- lib/watir_helper.rb
+- test/testing_watir_helper.rb
+- test/testing_watir_helper_spec.rb
+- README
+has_rdoc: true
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: A utility for making Automation Testing faster, simpler and easier.
+test_files:
+- test/testing_watir_helper.rb
+- test/testing_watir_helper_spec.rb