vapir-ie 1.7.0.rc1

data/History.txt

@@ -0,0 +1,437 @@
+== Version 1.6.6 (in development)
+
+* Added close_all method to firefox. Closes http://jira.openqa.org/browse/WTR-222 (Angrez)
+* Fixed status method for firefox.  (Angrez)
+
+== Version 1.6.5
+
+Charley Baker was release manager for this release of Watir.
+
+=== New Features (Both IE and Firefox)
+
+* Browser.attach is now available.
+* Browser.options and Browser.set_options are now available.
+* Add support for definition lists, this adds these methods:
+  dd, dt, dl, dds, dts, dls. (Jarib)
+* Added support for "visible?" method to both IE and Firefox. Closes
+  http://jira.openqa.org/browse/WTR-262 (Tony)
+* Hidden#visible? should always return false. (Jarib)
+* New method execute_script.
+* Add ElementCollections#size as alias of length. (Jarib)
+* Some camelCase => snake_case renames (with aliasing). (Jarib)
+    Image#fileCreatedDate       => file_created_date
+    Image#fileSize              => file_size
+    Image#hasLoaded?            => loaded?
+    SelectList#getAllContents   => options
+    SelectList#getSelectedItems => selected_options
+    SelectList#clearSelection   => clear
+    SelectList#includes?        => include?
+    TextField#dragContentsTo    => drag_contents_to
+    Radio/Checkbox#isSet?       => set?
+* Patch for winclicker fix. http://jira.openqa.org/browse/WTR-279 (Derek Berner)
+* Add support for using a Regexp as the third argument (value) when locating 
+  checkboxes/radio buttons. (Jarib)
+* Add support for <strong> element. (Jarib)
+* Add support and tests for <em> element. (Jarib)
+* SelectList#select now supports Numeric arguments. (Jarib)
+* Additional inspect implementations for both IE and FF. 
+  Closes http://jira.openqa.org/browse/WTR-158 (Jarib)
+* Add ElementCollections#{first,last}. (Jarib)
+* Fixes for running on Ruby 1.9. (Jarib)
+  
+=== Firefox Improvements
+
+* SelectList#set is now defined for Firefox. Like with IE, it is an alias for
+  SelectList#select. Closes http://jira.openqa.org/browse/WTR-271 (Bret)
+* Element collections are now enumerable. This allows methods such as @select@
+  and @map@ to be used with methods such as @divs@ and @links@.
+* FireWatir.attach is now available, analogous to IE.attach. Includes http://jira.openqa.org/browse/WTR-296
+* Some Javascript errors that were being ignored, now raise Ruby exceptions.
+* Added event handler which resets the context of document 
+* Fix bug that occurred when new page was automatically loaded. (Angrez, 3ef8b6)
+  when page gets loaded automatically (Angrez)
+* Changed code to use document_var, body_var, window_var, browser_var instead of 
+  "document", "body", "window", "browser" variables. (Angrez)
+* Changed code to replace every quote (") in xpath query with (\") so that it 
+  doesn't give error while executing the xpath query (Angrez)
+* Fire onchange event for FireWatir file fields. Closes http://jira.openqa.org/browse/WTR-286. (Jarib)
+* Fixes for running and closing Firefox on Mac OS X http://jira.openqa.org/browse/WTR-272 (Jarib)
+* Added functionality to allow Watir::Browser.attach with no arguments to open 
+  a new firefox window rather than taking over the existing focused window (Rob Aldred)
+* Also modified some setup functions to correctly handle closed browsers, 
+  browserless windows and others (Rob Aldred)
+* Add test and implementation for Firefox#status http://jira.openqa.org/browse/WTR-250 (Jarib)
+* 2 problems fixed with .click (jubishop)
+  a) When chaining together element calls the @container becomes an 
+     HTMLElement, but there's no container_var defined for HTMLElement
+  b) When an <a tag has no href then element_type was returning nil.
+* Fix bug in Firefox#document. Change creating error class by eval in jssh 
+  socket to creating class with ruby. (Ethan)
+* Add support for Browser#frames. (Ethan)
+* Make the version dependencies for Watir and FireWatir be the same. (This change
+  will also be backported to 1.6.3.) (Bret)
+
+=== IE Improvements
+
+* Allow attach timeout to be accessed as an option. Thus:
+    IE.set_options :attach_timeout => 5.0
+  This was previously available as class method.
+* Fix for Autoit auto-registration. (Bret) 
+  * Fixes http://jira.openqa.org/browse/WTR-290, http://jira.openqa.org/browse/WTR-308, http://jira.openqa.org/browse/WTR-298
+* Fix for IE6, 7 and 8 file uploads. (Zeljko Filipin & Jarmo Pertman)
+* Replaced REXML with Nokogiri for xml parsing. Fixes http://jira.openqa.org/browse/WTR-19 (Aidy Lewis)
+* Option now supports :label attribute http://jira.openqa.org/browse/WTR-297
+* Patch for IE.close causing WIN32OLE errors http://jira.openqa.org/browse/WTR-304 (Tony)
+* Watir::IE.inspect issue fixed: http://jira.openqa.org/browse/WTR-180 (Jarib)
+* Fix for Browser#execute_script on IE7. (Jarib)
+* Removed ActiveSupport dependency. (Jarib)
+* Fix Browser#status so it works even when the status bar is not visible. (Bret)
+* Fix bug when using "each" with nested tables. 
+  http://jira.openqa.org/browse/WTR-324 (Alan Baird)
+* Now uses UTF-8 codepage by default http://jira.openqa.org/browse/WTR-219 (Jarib)
+
+=== Structure Improvements
+
+* Lots of rework of the FireWatir code, including removing duplication and 
+  dead code, renaming variables, and simplifying code. Also a few performance
+  improvements. (Bret & Charley)
+* Rename source file names for consistency.
+  
+=== Unit Tests
+
+* Add tests demonstrating known bugs.
+* Make the "window" tests run more reliably. (Bret)
+* Relocate unreliable tests. (Bret)
+* Tag tests that are known to fail on IE or Firefox.
+* Fixed one test that was failing on non-English platforms. (Jarib)
+* New Rake task (:test) runs all tests. (Jim Matthews)
+* Use ci_reporter to provide more detailed test results for watirbuild.com. 
+  Use xls transform to format results. (Jim Matthews)
+* Add WatirSpec submodule + load it in Rakefile if available. (Jarib)
+
+== Version 1.6.2 
+
+* Changed the method of setting Watir::Browser.default when the user does not
+  specify a browser option. This fixes the problem where it would be 'ie' on
+  Mac.
+
+* Fixed FireWatir's "text" method to return the same character's as Watir's
+  method. It had been returning extra spaces and other characters. 
+  Fix included contribution from Tony. Closes #266
+  
+* Fixed "activesupport" error. Users no longer need to have the latest version
+  installed.
+
+== Version 1.6.1
+
+* Fixed install/load errors reported by Marek J and Tony.
+
+== Version 1.6.0
+
+This release merges the Watir and FireWatir projects. It contains many 
+compatibility fixes,
+as well as a new browser-independent interface your tests can use to allow you
+to specify the browser at run time. 
+
+We have also updated our existing support for modal dialogs so that it now works
+with Ruby 1.8.6. Users who have been using Ruby 1.8.2 because of this will now
+need to upgrade to Ruby 1.8.6.
+
+This release also contains many other fixes. Details below.
+
+Watir and FireWatir are still distributed as separate gems. Installing the 
+Watir gem will automatically install FireWatir. Both gems now use common code
+contained in the "commonwatir" gem.
+
+This release is fully backwards compatible with previous versions of Watir and
+FireWatir. Your existing scripts should continue to run without change.
+
+=== Installation
+
+To install both Watir and FireWatir:
+
+  gem update --system
+  gem install watir
+  
+To only install FireWatir (e.g. on Mac or Linux)
+
+  gem update --system
+  gem install firewatir
+  
+To enable Firefox to work with Watir, you will also need to install the 
+JSSH plugin. See this page for details.
+http://wiki.openqa.org/display/WTR/FireWatir+Installation#FireWatirInstallation-3%29InstalltheJSSHFirefoxExtension
+
+=== New Features
+You can now replace references to Watir::IE.new (or FireWatir::Firefox.new)
+with Watir::Browser.new to allow you to
+specify which browser to run your tests against at run time. Details:
+http://wiki.openqa.org/display/WTR/Browser.new
+
+It takes two lines of code to allow Browser.new to support an additional Watir
+implementation. The two lines necessary for SafariWatir (on Mac) are provided.
+(See commonwatir/lib/watir/browsers.rb).
+
+In addition to 'browser', options supported by Browser.new (on IE only right now)
+are 'speed' and 'visible'.
+
+Unit tests no longer run from the gems. You will need to get the source if you
+want to run the unit tests. 
+
+=== Compatibility Fixes
+* FireWatir now raises Watir exceptions.
+* FireWatir now supports multiple attributes for most page elements.
+* Watir now supports multiple attributes for most page elements.
+* Added support to FireWatir for many more element types.
+* Added Radio#checked? and Checkbox#checked? methods to FireWatir.
+* Now firefox.radio().set will click a radio button (as does IE) even if it 
+  is already set. This is important if there is javascript attached to the
+  radio button.
+* TextField#set now respects the maxlength of the field. Previously, FireWatir
+  could overrun the limit. FireWatir::TextField.maxlength now works correctly.
+* Watir::SelectList#includes? and #selected now accept regexp arguments.
+  This functionality is still missing from FireWatir, but it is in Celerity.
+  From Jari Bakken. Fixes #261.
+* FireWatir::Element#disabled is fixed.
+* Added method Watir::Table#row_count_excluding_nested_tables. This works like
+  FireWatir::Table#row_count.
+* Watir#wait_until is now available to FireWatir.
+* Fixed versioning. With FireWatir 1.2.1, FireWatir::Firefox::VERSION
+  actually reported '1.1.1.'.
+* FireWatir will now automatically starts Firefox on Mac (as it did previously 
+  on Windows and Linux).
+
+=== IE Fixes
+* Fix for: form field named "submit" causes "submit" method to not work. 
+  Closes #223.
+* Calling ie.radio().set now scrolls the page to the control, as with other
+  controls. Thanks to Jonathan Kohl for the fix. Closes #172.
+* Fixed ie.speed, which was returning ":fast" when speed was actually ":zippy".
+* Fix for visible? method not being inherited correctly. From Alan Baird. 
+  Closes #253
+* Added ie.forms method. Thanks to Jarmo P.
+* Fix for "undefined method 'document'" error that was occuring when loading
+  pages with frames that were slow to load. Reported here: 
+  http://groups.google.com/group/watir-general/browse_thread/thread/ddde6251e30588c9
+* Fixed accessing checkboxes and radio buttons using :ole_object on IE.
+  Closes #217.
+
+=== Unit Test Improvements
+* Unit tests no longer can be run from a gem install. Rather, you need to run them
+  from a complete source tree.
+* New rake targets for Watir: test and cruise, each of which runs the core tests.
+* Numerous fixes and cleanup to the unit test suite.
+* The unit tests both both Watir and FireWatir now use the new Browser.new 
+  interface and can be run
+  against either implementation (Watir::IE or FireWatir::Firefox or others for
+  that matter). See this page for details.
+  http://wiki.openqa.org/display/WTR/Running+Unit+Tests+in+Development
+* Added tagging to unit tests. Tests which have known failures are now tagged
+  as ":fails_on_ie" or ":fails_on_firefox".
+* Added coverage modes for running unit tests. These are documented on the wiki
+  page cited above.
+* Updated tests that were still using obsolete Watir 1.0 interfaces.
+* Started merging the Watir test suites into commonwatir.
+* General test clean up.
+* Test failures due to not setting IE security settings will now issue
+  helpful error message telling you how to fix your IE security settings.
+
+=== Structural Changes
+* Moved library files into "lib" directories. Now Watir is like all the other
+  Ruby projects.
+* Moved FireWatir classes into the FireWatir module.
+* Removed examples. They are now on the wiki.
+* Simplified code by removing duplication and unused code.
+* The watir-console now works from the development tree.
+* Renamed IE.defaults to IE.options and IE.defaults= to IE.set_options.
+* Added top-level "rake gems" target. Only works on windows right now.
+
+
+== Watir 1.5.6
+
+To install this:
+
+  "gem update --system"
+  "gem install watir"
+
+Installer Fix
+
+This update fixes an installer problem in Watir 1.5.5 that affected some users. 
+If you installed 1.5.5 without error, there is no reason to get this update.
+
+== Watir 1.5.5.
+
+New Features
+
+* Multiple attributes can now be specified for these elements:
+  li, ul, map, area, h1, h2, h3, h4, h5, h6. (This was claimed to work earlier, 
+  but never did.)
+  http://jira.openqa.org/browse/WTR-196
+
+Bug Fixes
+
+* Statements such at ie.table().row() now work (no longer private). 
+  http://jira.openqa.org/browse/WTR-117
+* Fixed bug with images method when used with anything but ie. (Paul Rogers)
+  E.g. ie.div().images. http://jira.openqa.org/browse/WTR-211
+* Fixed intermittent bug with ie.file_field().set. (Tomislav Car)
+  http://jira.openqa.org/browse/WTR-210
+* When installing Watir 1.5.4 you could get extra, confusing
+  questions. This shouldn't happen anymore.
+  http://jira.openqa.org/browse/WTR-209
+* Improved error message when element is not found using multiple attributes.
+  http://jira.openqa.org/browse/WTR-181
+* Made examples and unit tests somewhat better examples: removed unnecessary
+  "include Watir" statements; started using "browser" instead of "$ie"; use
+  new methods 'goto_page' and 'uses_page' (this last improves performance of 
+  unit tests). 
+  http://jira.openqa.org/browse/WTR-159
+* Moved brittle unit test that was causing cascading failures; renamed another
+  that was causing a namespace collision.  
+  http://jira.openqa.org/browse/WTR-92
+
+== Version 1.5.4
+
+New Features
+
+* Add new speed, :zippy. This is like fast, but, in effect, it does a TextField#value= instead of a TextField#set. If you have specific text fields that you never want this to happen to, use ie.text_field(:how, what).requires_typing.set instead.
+  http://svn.openqa.org/fisheye/changelog/watir/?cs=1295
+* Add support for Chinese input as supplied by Vincent Xu. 
+  http://jira.openqa.org/browse/WTR-71.
+
+Bug Fixes
+
+* Add dependency on windows-pr 0.6.6, which seems to be necessary on Vista.
+* Fix for bug in IE.close_others provided by Paul Taylor.
+  http://jira.openqa.org/browse/WTR-194
+* Fix for error when using verify_equal with ci_reporter, provided by Marcog.
+  http://svn.openqa.org/fisheye/changelog/watir/?cs=1301
+
+== Version 1.5.3
+
+Bug fixes and minor cleanup.
+
+* Fix text areas bugs.
+* Fix warning messages caused by redefined constants.
+* Break out watir.rb into multiple files.
+* Fix [WTR-90] error when running tests when installing gem.
+  http://jira.openqa.org/browse/WTR-90
+* Fix tests.
+* Update documentation.
+
+Major Changes in 1.5.2
+    Support for IE's Modal Dialogs. 
+      showModalDialog() 
+    Any method can be used to specify an element (:text, :class, etc.). 
+      ie.button(:class,'Button Menu').click
+      ie.div(:text, 'Type').text_field(:class, 'TextInput-input').set('my value')
+      ie.button(:text, 'Save').click 
+    One can now use multiple attributes to specify an element.
+      ie.span(:class =>'Label', :text => 'Add new').click
+      
+Other Changes in 1.5.2
+    * Migrated IE.new_process from watir/contrib and improved its reliability. We now recommend IE.new_process over IE.new as a way to avoid numerous errors detailed in http://jira.openqa.org/browse/WTR-150.
+    * Added IE.start_process. This works like IE.start, but uses the new_process mechanism to start IE.
+    * Added IE.new_window and IE.start_window. This are synonyms for IE.new and IE.start.
+    * Added dependency on the win32-process gem.
+    * Added IE.each, which iterates through the various IE windows currently open.
+    * Updated WindowHelper and watir/dialog to work with IE7
+    * The wait method was completely rewritten. This should fix various errors seen in 1.5.1.1165 and 1.5.1.1158.
+    * Removed the "spinner".
+    * Fixed bug in Element#parent and updated unit test.
+    * HTML value attributes are checked as strings before converting, updated unit tests.
+    * Watir::wait_until clean up.
+    * Fix for winclicker when installed in directory with spaces.
+    * Rdoc changes and updates.
+    * A workaround for frame access errors in the wait command, swallowing access denied errors and rethrowing if other WIN32OLERuntimeErrors show up.
+    * Add support for "li" tag.
+    * Fix for bug in element_by_xpath. http://www.mail-archive.com/wtr-general@rubyforge.org/msg06742.html
+    * "Wait" method now is called recursively into nested frames. http://jira.openqa.org/browse/WTR-107
+    * Rdocs now only include the core Watir library (not contrib).
+    * Improve error reporting when IE#modal_dialog isn't found.
+    * Add method "ModalDialog#exists?"
+    * Add Watir::Win32.window_exists? method.
+    * Fix for winclicker setComboBoxTest and setTextBoxText http://jira.openqa.org/browse/WTR-124
+    * Improved Support for IE7
+        o Fix for IE7 on ie.exists? http://jira.openqa.org/browse/WTR-123
+        o Fix for IE7 with winclicker.
+        o Fix for check_for_http_error in IE7. http://jira.openqa.org/browse/WTR-141
+    *  Fix for IE7 on ie.exists? http://jira.openqa.org/browse/WTR-123
+    * Rubyw is now used in winclicker to bypass command line windows.
+    * Autoit is registered before being used.
+    * Watir now checks for the right version of Ruby before loading our customized Win32ole library.
+    * ie.file_field has been fixed and unit test updated.
+    * rdoc generation has been fixed.
+    * page checker has been moved from the default behavior into contrib/page_checker.rb
+    * Fix for intermittent crashes occuring when using Watir with Ruby version > 1.8.2.
+    * Fix for http://jira.openqa.org/browse/WTR-86
+        This fix prevents the Watir-modified win32ole.so library (compiled against 1.8.2) from being used.
+    * Added Element#parent
+    * Add new methods Element#after? and Element#before?
+    * Added support for relative specifiers. E.g.:
+        link = $ie.link(:class => 'addtocart', :after? => @headline)
+    * Removed NAVIGATION_CHECKER from Watir.rb, added to contrib. This fixes rdoc generation and stops the frame access exception being thrown in the default installation.
+    * Open-code calls to def_creator, for easier debugging and rdoc generation of factory methods.
+    * Winclicker fix for too many callbacks defined error.
+    * Patch for rspec API changes
+    * You can now reference an iframe using IE#frame(:id, 'whatever'). Jira 109
+    * Added 'map' and 'area' element support.
+    * Moved Watir::Assertions into new file watir/assertions.rb so they can be used outside test cases.
+    * Fix and unit test for Jira 114, related to tag in HTML source.
+    * Added SelectList#include? and SelectList#selected?
+    * Added Element#visible?
+    * Fixes all reported bugs with contains_text.
+    * New Watir::TestCase#verify method (and verify_equal and verify_match).
+    * The click_no_wait method now works in frames.
+    * Released new IE.new_process method to 'watir/contrib/ie-new-process'. This starts up a new IE process for each IE window, which is really how it should be done. To close these use IE#kill. Any one getting intermittent RPC errors when opening windows may want to use this instead.
+    * Several examples have been updated.
+    * Moved enabled_popup to a new contrib directory.
+    * Added several tests. 
+
+Changes in 1.4
+   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

data/LICENSE.txt

@@ -0,0 +1,41 @@
+The Vapir-IE library comes from a number of sources and authors, all released
+under the Modified BSD License:
+- Original contributions by Ethan:
+  Copyright: Ethan 2009-2010
+  License: Modified BSD license (full text below)
+
+- The Watir library from which Vapir-IE was forked:
+  Copyright: 
+    Copyright (c) 2004 - 2005, Paul Rogers and Bret Pettichord
+    Copyright (c) 2006 - 2008, Bret Pettichord
+  License: Modified BSD license (full text below)
+
+
+Full text of the Modified BSD License:
+  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.