watir 1.4.1

data/readme.rb

@@ -0,0 +1,211 @@
+=begin rdoc
+
+This is Watir - Web Application Testing In Ruby    http://wtr.rubyforge.org
+
+To Install:
+   Execute install.rb. 
+
+How To Use:
+   This only works on Windows. It has been tested on Windows 2000 and XP.
+   Best is to use Ruby 1.8.2-14 or later.
+   This has been developed and tested using Ruby 1.8.1-11, Ruby 1.8.1-12.
+   It will NOT work with Ruby 1.8.1-13. (This version of Ruby has a bad WIN32OLE library.)
+   Requires Internet Explorer 5.5 or newer.
+   Check out the mail lists and the documentation for the workarounds.
+   Install ruby from http://ruby-lang.org
+
+Unit Tests:
+   Run the unittests in a cmd shell. Go to the dir where you installed it and then type 'ruby unittests/core_tests.rb'.
+   See the user guide if you are having problems with security blocking.
+
+Changes in 1.4.1
+    (based on watir.rb revision 1.215)
+    removed annoying warning message that sometimes appeared
+    corrected Element#class_name references which has been misnamed Element#style
+    removed IE#capture_events (didn't really work)
+    added IE#bring_to_front and IE#front?
+    fixed failing frame tests
+    remove failing test for disabled images
+    better rdoc
+    
+Changes in 1.4.0
+    fix method name for accessing class name of P/Span/Div (change from style to class_name)
+    fix for bug 2152 (frame index in show_frames off by 1)
+    added alt as a property to image
+    added file_fields
+    fixed TextArea#to_s
+    moved reset button to buttons class
+    add IE#send_keys
+    frames can now be referenced using regexps and ids
+    added IE#minimize, IE#maximize, IE#restore
+    onChange and onBlur events now triggered by TextField#set
+    added default option to set for checkbox
+    added colspan method to tablecell
+    fix for bug reported by Scott P, wrong objects are sometimes found
+    fixed bug with radio/checkboxes doing multiple fireevents
+    fix for table, id and reg exp
+    wait for page load before returning from IE.attach
+    update to select_list -- new interface still in progress
+    added .show method to iterators
+    fix for flashing objects in table cells
+    added flash for forms
+    flash returns nil instead of the curious '10'
+    removed ScreenCapture module from IE class
+
+Changes in 1.3.1
+   Added P tag support
+   Bug fix for images and links in frames using each
+   Bug fixes for image#save
+
+Changes in 1.3
+   added new row_values and column_value methods to tables
+   added ability to save an image - ie.image(:index,1).save('c:\temp\mypic.gif')
+   new method, html that applies to objects, not just a page - ie.button(:index,1).html => <INPUT id=b2 title="this is button1" onclick="javascript:document.location='pass.html';" type=button value="Click Me" name=b1>
+   now throws a NavigationException on 404, 500 errors
+   iterators now mixin Enumerable
+   added support for labels
+   added support for frames by index
+   added screen_capture
+   added hidden field support, and iterator method
+   table cells, span and div now act as containers, so can do ie.div(:index,1).button(:index.2).click
+   added index to print out from show_xx methods. Link shows img src if an image is used
+   added onKeyUp and onKeyDown to text_fields#set
+   installer now installs AutoIt to deal with javascript popups, file uploads etc
+   the spinner is now off by default 
+   bug fix in text_fields iterator where it wasnt iterating through password or text ares. Added test for password fields
+   bug fix for flash for tables
+   bug fixes for images and links in cells
+
+Typical Usage
+   # include the controller 
+   require 'watir' 
+   # create an instance of the controller 
+   ie = Watir::IE.new  
+   # go to the page you want to test 
+   ie.goto("http://myserver/mypage") 
+   # to enter text into a text field - assuming the field is name "username" 
+   ie.text_field(:name, "username").set("Paul") 
+   # if there was a text field that had an id of "company_ID", you could set it to Ruby Co: 
+   ie.text_field(:id ,"company_ID").set("Ruby Co") 
+   # to click a button that has a caption of 'Cancel' 
+   ie.button(:value, "Cancel").click 
+   
+  The ways that are available to identify an html object depend upon the object type, but include
+   :id           used for an object that has an ID attribute -- this is the best way!
+   :name         used for an object that has a name attribute. 
+   :value        value of text fields, captions of buttons 
+   :index        finds the nth object of the specified type - eg button(:index , 2) finds the second button. This is 1 based. <br>
+   :beforeText   finds the object immeditaley before the specified text. Doesnt work if the text is in a table cell
+   :afterText    finds the object immeditaley after the specified text. Doesnt work if the text is in a table cell
+
+  The objects that are currently supported include
+   Button
+   Radio
+   CheckBox
+   TextField (Including TextArea and Password)
+   Hidden
+   SelectList
+   Label
+   Span
+   Div
+   P
+   Link
+   Table 
+   Image
+
+ These 2 web sites provide info on Internet Explorer and on the DOM as implemented by Internet Explorer
+ http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/webbrowser/webbrowser.asp
+ http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/overview/overview.asp
+
+ Command line options:
+
+  -b  (background)   Run Internet Explorer invisible
+  -f  (fast)         Run tests very fast
+  -x  (spinner)      Add a spinner that displays when pages are waiting to be loaded.
+  
+ Note that if you also use test/unit, you will need to require 'watir' first to avoid conflicts
+ with its command line switches.
+
+Javascript Pop Up Support
+   Watir now installs AutoIt - http://www.autoitscript.com/
+   This is the preffered method for dealing with pop ups, file requesters etc. Support for Winclickers will be removed.
+
+Contacts:
+   Paul Rogers (paul.rogers@shaw.ca)
+   Bret Pettichord (bret@pettichord.com)
+   The mailing list: http://rubyforge.org/mail/?group_id=104
+
+Contributors:
+   Bret Pettichord
+   Paul Rogers
+   Jonathan Kohl
+   Chris Morris
+   Karlin Fox
+   Lorenzo Jorquera
+   Atilla Ozgur
+   Justin McCarthy
+   Chris McMahon
+   Elisabeth Hendrickson
+   Michael Kelly (Indianapolis)
+   Peter Chau
+   Jacinda Scott
+   Danny Faught
+   Andy Sipe
+   John Lloyd-Jones
+   Chris Hedges
+   Park Heesob
+   Shashank Date
+   Jared Luxenberg
+   Alexey Verkhovsky
+   Tuyet Cong-Ton-Nu
+   Kingsley Hendrickse
+
+Acknowledgements:
+   Chris Morris
+   Brian Marick
+   Jonathan Kohl
+   Penny Tonita
+   Janet Gregory
+   Andy Tinkham
+
+   Thanks for your ideas and support!
+
+License
+  ---------------------------------------------------------------------------
+  Copyright (c) 2004-2005, Paul Rogers and Bret Pettichord
+  All rights reserved.
+  
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+  
+  1. Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+  
+  2. Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+  
+  3. Neither the names Paul Rogers, Bret Pettichord nor the names of contributors to
+  this software may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+  
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+  IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
+  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+  --------------------------------------------------------------------------
+  (based on BSD Open Source License)
+
+
+
+
+=end
+class ReadMe
+end

data/unittests/WindowLogonExample.rb

@@ -0,0 +1,30 @@
+
+	
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..') if $0 == __FILE__
+require 'unittests/setup'
+require 'watir/WindowHelper'
+
+class TC_Logon_Test < Test::Unit::TestCase
+    include Watir
+
+	def goto_windows_login_page()
+		$ie.goto('http://clio.lyris.com/')
+	end
+
+
+	def test_window_logon()
+		
+		a = Thread.new {
+			system('ruby WindowLogonExtra.rb')
+
+		 }
+		b = Thread.new { 
+		goto_windows_login_page()
+		}
+		a.join
+		b.join
+	end
+
+	
+
+end

data/unittests/WindowLogonExtra.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..') if $0 == __FILE__
+
+require 'watir/WindowHelper'
+
+
+helper = WindowHelper.new
+helper.logon('Connect to clio.lyris.com')

data/unittests/all_tests.rb

@@ -0,0 +1,10 @@
+TOPDIR = File.join(File.dirname(__FILE__), '..')
+$LOAD_PATH.unshift TOPDIR
+
+require 'unittests/setup.rb'
+
+Dir.chdir TOPDIR
+$all_tests.each {|x| require x}
+
+
+

data/unittests/all_tests_concurrent.rb

@@ -0,0 +1,57 @@
+# This is an UNFINISHED attempt to run the unit tests currently.
+# The work on the harness is complete. 
+# The problem remaining is that the tests are not thread-safe.
+# It's an open question whether getting this to work would actually save any execution time.
+
+TOPDIR = File.join(File.dirname(__FILE__), '..')
+$LOAD_PATH.unshift TOPDIR
+Dir.chdir TOPDIR
+#(Dir["unittests/*_test.rb"] - ["unittests/popups_test.rb"]).each {|x| require x}
+
+require 'unittests/buttons_test'
+require 'unittests/checkbox_test'
+
+require 'test/unit/testsuite'
+require 'thread'
+class ConcurrentTestSuite < Test::Unit::TestSuite
+
+      # Runs the tests and/or suites contained in this TestSuite.
+      def run(result, &progress_block)
+        yield(STARTED, name)
+        threads = []
+        @tests.each do |test|
+          threads << Thread.new do
+            test.run(result, &progress_block)
+          end
+        end
+        threads.each {|t| t.join}
+        yield(FINISHED, name)
+      end
+end
+
+# create a suite
+require 'test/unit/collector/objectspace'
+
+require 'test/unit/collector'
+include Test::Unit::Collector
+
+
+          @filters = []
+          suite = ConcurrentTestSuite.new('super suite')
+          sub_suites = []
+          ::ObjectSpace.each_object(Class) do |klass|
+            if(Test::Unit::TestCase > klass)
+              puts sub_suites, klass.suite
+              add_suite(sub_suites, klass.suite)
+            end
+          end
+          sort(sub_suites).each{|s| suite << s}
+
+
+        
+# select a runner
+require 'test/unit/ui/console/testrunner'
+Test::Unit::UI::Console::TestRunner.run(suite)
+
+
+# then subclass Test::Unit::TestSuite and override the run method to be multithreaded

data/unittests/attachToExistingWindow_test.rb

@@ -0,0 +1,40 @@
+# feature tests for attaching to existing IE windows
+# revision: $Revision: 1.8 $
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..') if $0 == __FILE__
+require 'unittests/setup'
+
+class TC_ExistingWindow< Test::Unit::TestCase
+    include Watir
+
+    def goto_page(page)
+      $ie.goto($htmlRoot + page)
+    end
+
+    def test_ExistingWindow
+       goto_page 'buttons1.html'
+       ie3=nil
+
+       assert_raises( NoMatchingWindowFoundException ) { ie3 = IE.attach(:title , "missing") }
+       assert_raises( NoMatchingWindowFoundException ) { ie3 = IE.attach(:title , /missing/) }
+
+       assert_raises( NoMatchingWindowFoundException ) { ie3 = IE.attach(:url , "missing") }
+       assert_raises( NoMatchingWindowFoundException ) { ie3 = IE.attach(:url , /missing/) }
+
+       ie3 = IE.attach(:title , /buttons/i )
+       assert_equal( "Test page for buttons" , ie3.title)
+       ie3=nil
+
+       ie3 = IE.attach(:title , "Test page for buttons" )
+       assert_equal( "Test page for buttons" , ie3.title)
+       ie3=nil
+
+       ie3 = IE.attach(:url, /buttons1.html/ )
+       assert_equal( "Test page for buttons" , ie3.title)
+       ie3=nil
+
+       #hard to test :url with explicit text
+    end
+
+end
+

data/unittests/buttons_test.rb

@@ -0,0 +1,131 @@
+# feature tests for Buttons
+# revision: $Revision: 1.32 $
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..') if $0 == __FILE__
+require 'unittests/setup'
+
+class TC_Buttons < Test::Unit::TestCase
+    include Watir
+    
+    def setup
+        $ie.goto($htmlRoot + "buttons1.html")
+    end
+    
+    def goto_frames_page()
+        $ie.goto($htmlRoot + "frame_buttons.html")
+    end
+    
+    def aatest_Spinner
+        s = Spinner.new
+        i = 0
+        while(i < 100)
+            sleep 0.05
+            print s.next
+            i+=1
+        end
+        s = nil
+    end
+    
+    def aaatest_Button_to_s
+        # i think the tests for to_s should be dropped. The output is not in a nice format to be tested, and the
+        # individual properties are tested in the test_properties method
+        
+        b4 = ['name              b4',
+        'type              button',
+        'id                b5',
+        'value             Disabled Button',
+        'disabled          true']
+        b1 = ['name              b1',
+        'type              button',
+        'id                b2',
+        'value             Click Me',
+        'disabled          false']
+        
+        assert_equal(b4, $ie.button(:name, "b4").to_s)
+        assert_equal(b1, $ie.button(:caption, "Click Me").to_s)
+        assert_equal(b1, $ie.button(:index, 1).to_s)
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").to_s   }  
+    end
+    
+    def test_properties
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").id   }  
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").name   }  
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").disabled   }  
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").type   }  
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").value   }  
+        
+        assert_equal("b1"  , $ie.button(:index, 1).name  ) 
+        assert_equal("b2"  , $ie.button(:index, 1).id  ) 
+        assert_equal("button"  , $ie.button(:index, 1).type  ) 
+        assert_equal("Click Me"  , $ie.button(:index, 1).value  ) 
+        assert_equal(false  , $ie.button(:index, 1).disabled  ) 
+        
+        assert_equal("b1"  , $ie.button(:id, "b2").name  ) 
+        assert_equal("b2"  , $ie.button(:id, "b2").id  ) 
+        assert_equal("button"  , $ie.button(:id, "b2").type  ) 
+        
+        assert_equal("b4"  , $ie.button(:index, 2).name  ) 
+        assert_equal("b5"  , $ie.button(:index, 2).id  ) 
+        assert_equal("button"  , $ie.button(:index, 2).type  ) 
+        assert_equal("Disabled Button"  , $ie.button(:index, 2).value  ) 
+        assert_equal(true  , $ie.button(:index, 2).disabled  ) 
+        
+        assert_equal( "" , $ie.button(:index, 2).title )
+        assert_equal( "this is button1" , $ie.button(:index, 1).title )
+    end
+    
+    
+    def test_button_using_default
+        # since most of the time, a button will be accessed based on its caption, there is a default way of accessing it....
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button( "Missing Caption").click   }  
+        
+        $ie.button("Click Me").click
+        assert($ie.contains_text("PASS") )
+    end
+    
+    def test_Button_click_only
+        $ie.button(:caption, "Click Me").click
+        assert($ie.contains_text("PASS") )
+    end
+    
+    def test_button_click
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:caption, "Missing Caption").click   }  
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:id, "missingID").click   }  
+        
+        assert_raises(ObjectDisabledException , "ObjectDisabledException was supposed to be thrown" ) {   $ie.button(:caption, "Disabled Button").click   }  
+        
+        $ie.button(:caption, "Click Me").click
+        assert($ie.contains_text("PASS") )
+    end
+    
+    def test_Button_Exists
+        assert($ie.button(:caption, "Click Me").exists?)   
+        assert($ie.button(:caption, "Submit").exists?)   
+        assert($ie.button(:name, "b1").exists?)   
+        assert($ie.button(:id, "b2").exists?)   
+        assert($ie.button(:caption, /sub/i).exists?)   
+        
+        assert_false($ie.button(:caption, "missingcaption").exists?)   
+        assert_false($ie.button(:name, "missingname").exists?)   
+        assert_false($ie.button(:id, "missingid").exists?)   
+        assert_false($ie.button(:caption, /missing/i).exists?)   
+    end
+    
+    def test_Button_Enabled
+        assert($ie.button(:caption, "Click Me").enabled?)   
+        assert_false($ie.button(:caption, "Disabled Button").enabled?)   
+        assert_false($ie.button(:name, "b4").enabled?)   
+        assert_false($ie.button(:id, "b5").enabled?)   
+        
+        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").enabled?  }  
+    end
+    
+    def test_frame
+        goto_frames_page()
+        
+        assert($ie.frame("buttonFrame").button(:caption, "Click Me").enabled?)   
+        assert_raises(  UnknownObjectException , "UnknownObjectException was supposed to be thrown ( no frame name supplied) " ) { $ie.button(:caption, "Disabled Button").enabled?}  
+    end
+    
+end
+