watir_helper 0.1.2 → 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OGJjMmEzZjY4ZGUzNGQ3ODlmNTNiNzE2OTJhMGQzNjZhM2Q2NDJmNg==
+  data.tar.gz: !binary |-
+    ZmQzNzU1YTkyYTkwMGFkZDY5YzQyZDA5ZjQxZDQ0OGI4Y2FkM2NhYg==
+SHA512:
+  metadata.gz: !binary |-
+    Y2U1ZjNlNDZiNGUzNDc3ZTljNDA0YjUwZjFkMTI4Mjc5MTY5NzkwMTA3OWZl
+    ZDE5NWI5ODU1MDE1ODM3M2Y2MmVmNTZjYjYwZDYwZjUyOGYyZGNiNDc0MGZj
+    YTczMzYxOWMzYTM2MDg0NDk1NmU5NzI0YWNiOTNiMzE3MTA0NTk=
+  data.tar.gz: !binary |-
+    OWU2Y2M5Y2FhMjE1MzZkZjZkMWUxMzlhODMyZTJlMDFlZDBmN2U3NjZhMjlj
+    OTYwMDBhYzU4NGQxMTJmNmY2ZDNhZDRkODJiZjk2MjBlZmQwNTkwNjY1MDUz
+    OWI1MWYxNjAzNDUzODBlYzgyMWY5NjQ3ZGM4NGIzNTkwYjFjZWI=

data/README

@@ -1,170 +1,118 @@
-About this Utility:
+About this gem:
     
-This is a utility(watir_helper) developed for making Automation Testing faster, simpler and easier through WATIR.
+This gem is developed for novice automation tester's to write automation scripts
+fast as it is very easy to use.
 
 Features:-
   
-1. No need to create an IE Instance.
+1. Freedom to choose the browser. Right now this gem is only tested with IE.
   
-2. Just include this gem and use it's parameterized functions some of which are given as follows:-
-
-     # goto_page("http://www.google.com")
+     # ie = set_browser("ie")
+  
+2. Method name's are simple and easy to remember. For e.g:
+  
+     # require 'watir_helper'
      
-     # set_texfield("name","q","Ruby")
+     # ie1 = set_browser("ie")
      
-     # click_button("name","btnG")
+     # goto_page(ie1, "http://www.google.com/")
+
+     # close_browser(ie1)
      
-     # verify_text("Ruby")
+     # ie2 = set_browser("ie")
+
+     # goto_page(ie2, "http://rubygems.com/")
      
-     # 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.
+     # close_browser(ie2)
+
+3. Data validations like email-id validation, date format(like mmddyyyy or ddmmyyyy) validation etc.
+   are also incorporated.
+
+4. For Pop-up handling, you have to just use one line named method's of this gem. It's that easy.
   
-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.
+   # click_ok_js_popup("File Download")
   
-6. Can add functions into this gem as WATIR is an Open Source tool.
+   
+   # click_save_saveas_popup("Save As", "C://Test_Data")
   
+
+5. You can add new features into this gem.
   
+
 Prerequisites:
 
-Install Ruby: http://ruby-lang.org
+Install Ruby: 
     
-  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.)
-
-
+  First you need to install Ruby using the one-click installer for Windows from
+  http://ruby-lang.org . 
 
 Install Watir:
    
-Watir is packaged as a gem, a Ruby library that can be installed over the
-   internet.
+  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:
  
- 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:
+Install rake :
   
- gem install rake 
-
+  gem install rake 
 
+Install IE Developer Toolbar from the site :
+ 
+  http://www.microsoft.com/en-in/download/details.aspx?id=18359
 
-Install IE Devleoper Toolbar from the site
+How To Use:
  
-  http://www.microsoft.com/downloads/details.aspx?familyid=e59c3964-672d-4511-bb3e-2d5e1db91038&displaylang=en
+  This only works on Windows. Requires Internet Explorer 5.5 or newer.
 
-How 
-   To Use:
- This only works on Windows.Requires Internet Explorer 5.5 or newer.
-Typical Usage
+  Typical Usage :
    
-     # include my utility(watir_helper)
+     # Include the gem 'watir_helper'
    
         require 'watir_helper'
+
+     # Set browser   
+        ie = set_browser("ie")
+
+     # Supply Google url to goto_page
    
-     # include the module inside it
-   
-        include WatirHelper
-   
-     # Go to the Google home page
-   
-        goto_page("http://www.google.com/")
+        goto_page(ie, "http://www.google.com/")
    
-     # print Title 
+     # Display title of the current browser page
    
-        puts get_title
+        puts get_title(ie)
    
-     # print Url
+     # Display url of the current browser page
    
-        puts get_url
+        puts get_url(ie)
    
      # Flash the Google logo on the home page   
    
-        flash_image("id","logo")
+        flash_image(ie, "id", "logo")
    
      # Check whether Google logo image exists or not
    
-        puts exists_image("id","logo")
+        puts exists_image?(ie, "id", "logo")
    
      # Set the search field to Ruby
    
-        set_textfield("name","q","Ruby")
+        set_textfield(ie, "name", "q", "Ruby")
    
      # Highlight the Google Search button
    
-        flash_button("value","Google Search")
+        flash_button(ie, "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. 
-
-
+        click_button(ie, "value", "Google Search")
 
 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.rb

@@ -1,9 +1,2 @@
-require 'watir_helper/common_helpers'
-
-
-module WatirHelper 
-
-require 'watir_helper/include_all_helpers'
-
-end
-
+require File.expand_path('watir_helper/common_helpers', File.dirname(__FILE__))
+require File.expand_path('watir_helper/include_other_helpers', File.dirname(__FILE__))

data/lib/watir_helper/browser_helper.rb

@@ -1,62 +1,74 @@
-require 'watir_helper/common_helpers'
+#******************************************************
+#Browser methods
+#******************************************************
+require File.expand_path('common_helpers', File.dirname(__FILE__))
 
 module BrowserHelper
 
+#Set a browser.
+#For e.g set_browser("ie")
+def set_browser(browser_name)
+  Watir::Browser.new browser_name.intern	
+end
+
 #Go to a page.
-def goto_page(url)
- $ie.goto(url)
+def goto_page(browser_handle, url)
+ browser_handle.goto(url)
 end
 
 #Go to the next page.
-def goto_next_page()
- $ie.forward
+def goto_next_page(browser_handle)
+ browser_handle.forward
 end
 
 #Go to the previous page.
-def goto_previous_page()
- $ie.back
+def goto_previous_page(browser_handle)
+ browser_handle.back
 end
 
 #Refresh the page.
-def refresh_the_page()
-  $ie.refresh
-end
-
-#Close the browser.
-def close_browser()
-  title=get_title()
- $ai.WinKill(title)
+def refresh_the_page(browser_handle)
+  browser_handle.refresh
 end
 
 #Get the title of the browser.
-def get_title()
-  $ie.title
+def get_title(browser_handle)
+  browser_handle.title
 end
 
 #Get the url of the browser.
-def get_url()
-  $ie.url
+def get_url(browser_handle)
+  browser_handle.url
 end
 
-#Attach an IE instance.
-def attach_an_IE_window(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
-  $ie=Watir::IE.attach(property.intern,propertyvalue)
+#Close the browser.
+def close_browser(browser_handle)
+  browser_handle.close
+end
+
+#Attach a browser window.
+def attach_browser(browser_handle, property, property_value)
+  browser_handle.attach(property.intern, /#{property_value}/)
+end
+
+#Close attached browser window.
+def close_attached_browser(browser_handle)
+  close_browser(browser_handle)
 end
 
 #Minimize the browser.
-def minimize_browser()
-  $ie.minimize
+def minimize_browser(browser_handle)
+  browser_handle.minimize
 end
 
 #Maximize the browser.
-def maximize_browser()
-  $ie.maximize
+def maximize_browser(browser_handle)
+  browser_handle.maximize
 end
 
 #Verify whether text is present or not.
-def verify_text(text)
-  $ie.text.include?(text)
+def verify_text?(browser_handle, text)
+  browser_handle.text.include?(text)
 end
 
-end
+end

data/lib/watir_helper/button_helper.rb

@@ -1,41 +1,38 @@
-require 'watir_helper/common_helpers'
+#******************************************************
+#Button methods
+#******************************************************
+require File.expand_path('common_helpers', File.dirname(__FILE__))
 
 module ButtonHelper
 
 #Click a button.  
-def click_button(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
-  $ie.button(property.intern,propertyvalue).click
+def click_button(browser_handle, property, property_value)
+  browser_handle.button(property.intern, /#{property_value}/).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
+def click_button_with_popup(browser_handle, property, property_value)
+  browser_handle.button(property.intern, /#{property_value}/).click_no_wait
 end
 
 #Double Click a button.  
-def double_click_button(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
- $ie.button(property.intern,propertyvalue).fire_event("ondblclick") 
+def double_click_button(browser_handle, property, property_value)
+  browser_handle.button(property.intern, /#{property_value}/).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") 
+#Double Click a button, after clicking it a pop-up will come.  
+def double_click_button_with_popup(browser_handle, property, property_value)
+  browser_handle.button(property.intern, /#{property_value}/).fire_event_no_wait("ondblclick")
 end
 
 #Highlight or Flash a button.  
-def flash_button(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
-  $ie.button(property.intern,propertyvalue).flash
+def flash_button(browser_handle, property, property_value)
+  browser_handle.button(property.intern, /#{property_value}/).flash
 end
 
 #Check whether a button exists or not.
-def exists_button(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
-  $ie.button(property.intern,propertyvalue).exists?
+def exists_button?(browser_handle, property, property_value)
+  browser_handle.button(property.intern, /#{property_value}/).exists?
 end
 
 end

data/lib/watir_helper/checkbox_helper.rb

@@ -1,35 +1,33 @@
-require 'watir_helper/common_helpers'
+#******************************************************
+#CheckBox methods
+#******************************************************
+require File.expand_path('common_helpers', File.dirname(__FILE__))
 
 module CheckBoxHelper
 
 #Click a checkbox.   
-def click_checkbox(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
- $ie.checkbox(property.intern,propertyvalue).set
+def click_checkbox(browser_handle, property, property_value)
+  browser_handle.checkbox(property.intern, /#{property_value}/).set
 end
 
 #Clear a checkbox.   
-def clear_checkbox(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
-  $ie.checkbox(property.intern,propertyvalue).clear
+def clear_checkbox(browser_handle, property, property_value)
+  browser_handle.checkbox(property.intern, /#{property_value}/).clear
 end
 
 #Highlight or Flash a checkbox.   
-def flash_checkbox(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
- $ie.checkbox(property.intern,propertyvalue).flash
+def flash_checkbox(browser_handle, property, property_value)
+  browser_handle.checkbox(property.intern, /#{property_value}/).flash
 end
 
 #Check whether a checkbox exists or not.
-def exists_checkbox(property,propertyvalue)
-  propertyvalue=/#{propertyvalue}/
- $ie.checkbox(property.intern,propertyvalue).exists?
+def exists_checkbox?(browser_handle, property, property_value)
+  browser_handle.checkbox(property.intern, /#{property_value}/).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?
+def is_checkbox_checked?(browser_handle, property, property_value)
+  browser_handle.checkbox(property.intern, /#{property_value}/).checked?
 end
 
 end