watir 1.6.6.rc2 → 1.6.6

data/CHANGES

@@ -1,4 +1,4 @@
-== Version 1.6.6 - 2010/09/XX
+== Version 1.6.6 - 2010/10/2
 
 === IE improvements
 
@@ -25,9 +25,11 @@
 === Cleanup & Maintenance
 
 * Some rdoc cleanup (marekj)
+* README changes (Željko Filipin)
 * Removed Watir::Utils (Jarmo Pertman)
 * It is now possible to execute unit-tests within gems with `rake test` (Jarmo Pertman)
 * Don't output unnecessary information to stdout in FireWatir unit-tests (Željko Filipin)
+* Update the 3 gem projects to each use the common readme file (Bret)
 
 
 Whole Changelog is available at http://github.com/bret/watir/compare/v1.6.5...v1.6.6

data/README.rdoc

@@ -0,0 +1,101 @@
+= Watir
+
+Watir, pronounced water, is an open-source (BSD) family of Ruby libraries for automating web browsers. It supports your app no matter what technology it is developed in. They support Internet Explorer on Windows, Firefox and Chrome on Windows, Mac and Linux and Safari on Mac.
+
+Project Home:: http://watir.com
+Source Code:: http://github.com/bret/watir
+Support:: http://watir.com/support
+Gem:: https://rubygems.org/gems/watir
+Gem:: https://rubygems.org/gems/firewatir
+Gem:: https://rubygems.org/gems/commonwatir
+Gem:: https://rubygems.org/gems/safariwatir
+Gem:: https://rubygems.org/gems/watir-webdriver
+Gem:: https://rubygems.org/gems/celerity
+
+== Install
+
+You have to install Ruby and RubyGems first. To be able to drive Firefox you have to install Firefox add-on. Detailed installation instructions are at http://watir.com/installation
+
+=== Windows
+
+To install Internet Explorer and Firefox driver:
+
+  gem update --system
+  gem install watir
+
+=== Mac
+
+To install Firefox driver:
+
+  sudo gem update --system
+  sudo gem install firewatir
+
+To install Safari driver, you have to install Xcode first and then:
+
+  sudo gem install rb-appscript
+  sudo gem install safariwatir
+
+=== Linux
+
+To install Firefox driver:
+
+  sudo gem update --system
+  sudo gem install firewatir
+
+== Examples
+
+Some examples from http://watir.com/examples
+
+Including Watir gem to drive Internet Explorer on Windows
+
+  require 'watir'
+
+Including FireWatir gem to drive Firefox on Windows/Mac/Linux
+
+  require 'firewatir'
+
+Starting a new browser & and going to our site
+
+  browser = Watir::Browser.new
+  browser.goto("http://bit.ly/watir-example")
+
+Setting a text field
+
+  browser.text_field(:name => "entry.0.single").set "Watir"
+
+Setting a multi-line text box
+
+  browser.text_field(:name => "entry.1.single").set "I come here from Australia. \n The weather is great here."
+
+Setting and clearing a radio button
+
+  browser.radio(:value => "watir").set
+  browser.radio(:value => "watir".clear
+
+Setting and clearing check boxes
+
+  browser.checkbox(:value => "Ruby").set
+  browser.checkbox(:value => "Python").set
+  browser.checkbox(:value => "Python").clear
+
+Clicking a button
+
+  browser.button(:name => "logon").click
+
+Clearing, getting and selecting selection list values
+
+  browser.select_list(:name => "entry.6.single").clear
+  puts browser.select_list(:name => "entry.6.single").options
+  browser.select_list(:name => "entry.6.single").select "Chrome"
+
+Clicking a button
+
+  browser.button(:name => "submit").click
+
+Checking for text in a page
+
+  puts browser.text.include? "Your response has been recorded."
+
+Checking the title of a page
+
+  puts browser.title == "Thanks!"

data/VERSION

@@ -1 +1 @@
-1.6.6.rc2
+1.6.6

data/watir-rdoc.rb

@@ -1,7 +1,7 @@
 $WATIR_RDOC_OPTIONS = [] << 
       '--title' << 'Watir API Reference' <<
   		'--accessor' << 'def_wrap=R,def_wrap_guard=R,def_creator=R,def_creator_with_default=R' <<
-  		'--main' << 'Watir::IE' << 
+  		'--main' << 'README.rdoc' << 
   		'--exclude' << 'unittests|camel_case.rb'
-$WATIR_EXTRA_RDOC_FILES = ['lib/readme.rb', 'lib/changes.rb', 'lib/license.rb'] 		
+$WATIR_EXTRA_RDOC_FILES = ['README.rdoc']
 

data/watir.gemspec

@@ -1,7 +1,7 @@
 require 'watir-rdoc'
 
 $__watir_source_patterns = [
-    'CHANGES', 'rakefile.rb', 'VERSION', 'watir.gemspec', 'watir-rdoc.rb',
+    'CHANGES', 'rakefile.rb', 'VERSION', "README.rdoc", 'watir.gemspec', 'watir-rdoc.rb',
     'lib/watir/*.rb', 'lib/watir/AutoItX3.dll',
     'unittests/*.rb', 'unittests/html/*.html', 'unittests/html/images/*.*',
     'unittests/other/*.rb', 'unittests/testcase/*.rb', 'unittests/windows/*.rb',
@@ -42,6 +42,7 @@ spec = Gem::Specification.new do |s|
 
   s.has_rdoc = true
   s.rdoc_options += $WATIR_RDOC_OPTIONS
+  s.extra_rdoc_files = $WATIR_EXTRA_RDOC_FILES
   s.executables << 'watir-console'
 
 #  s.test_file  = 'unittests/core_tests.rb'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: watir
 version: !ruby/object:Gem::Version 
-  hash: 977940599
-  prerelease: true
+  hash: 3
+  prerelease: false
   segments: 
   - 1
   - 6
   - 6
-  - rc2
-  version: 1.6.6.rc2
+  version: 1.6.6
 platform: ruby
 authors: 
 - Bret Pettichord
@@ -16,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-30 00:00:00 -06:00
+date: 2010-10-02 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -59,13 +58,12 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        hash: 977940599
+        hash: 3
         segments: 
         - 1
         - 6
         - 6
-        - rc2
-        version: 1.6.6.rc2
+        version: 1.6.6
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
@@ -76,13 +74,12 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        hash: 977940599
+        hash: 3
         segments: 
         - 1
         - 6
         - 6
-        - rc2
-        version: 1.6.6.rc2
+        version: 1.6.6
   type: :runtime
   version_requirements: *id004
 - !ruby/object:Gem::Dependency 
@@ -105,12 +102,13 @@ executables:
 - watir-console
 extensions: []
 
-extra_rdoc_files: []
-
+extra_rdoc_files: 
+- README.rdoc
 files: 
 - CHANGES
 - rakefile.rb
 - VERSION
+- README.rdoc
 - watir.gemspec
 - watir-rdoc.rb
 - lib/watir/camel_case.rb
@@ -304,9 +302,6 @@ files:
 - lib/watir/contrib/enabled_popup.rb
 - lib/watir/contrib/ie-new-process.rb
 - lib/watir/contrib/page_checker.rb
-- lib/readme.rb
-- lib/changes.rb
-- lib/license.rb
 - bin/watir-console
 has_rdoc: true
 homepage: http://www.watir.com/
@@ -319,7 +314,7 @@ rdoc_options:
 - --accessor
 - def_wrap=R,def_wrap_guard=R,def_creator=R,def_creator_with_default=R
 - --main
-- Watir::IE
+- README.rdoc
 - --exclude
 - unittests|camel_case.rb
 require_paths: 
@@ -336,14 +331,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
-      hash: 25
+      hash: 3
       segments: 
-      - 1
-      - 3
-      - 1
-      version: 1.3.1
+      - 0
+      version: "0"
 requirements: 
 - Microsoft Windows running Internet Explorer 5.5 or later.
 rubyforge_project: Watir

data/lib/changes.rb

@@ -1,3 +0,0 @@
-=begin rdoc
-:include:../CHANGES   
-=end

data/lib/license.rb

@@ -1,38 +0,0 @@
-=begin rdoc
-
-License
-  ---------------------------------------------------------------------------
-  Copyright (c) 2004 - 2005, Paul Rogers and Bret Pettichord
-  Copyright (c) 2006 - 2008, 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
-

data/lib/readme.rb

@@ -1,140 +0,0 @@
-=begin rdoc
-
-This is Watir - Web Application Testing In Ruby    http://wtr.rubyforge.org
-
-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.
-
-   Watir 1.5 was released in September 2007. To install it, type this at a
-   command prompt:
-      gem install watir
-
-   Watir 1.4 was released in August 2005. If you are upgrading from it, see
-   these notes: http://wiki.openqa.org/display/WTR/Development+Builds
-
-How To Use:
-   This only works on Windows.
-   Requires Internet Explorer 5.5 or newer.
-   Check out the mail lists and the documentation for the workarounds.
-
-User Guide:    http://wiki.openqa.org/display/WTR/User+Guide
-
-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.
-
-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 named '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 
-
-  Identifying something using two or more identifying characteristics
-   # Html objects can also be identified via a combination of two of the above methods, 
-   # for example to click a span with a class name of 'Label', and whose text is 'Add new', one could say
-   ie.span(:class =>'Label', :text => 'Add new').click
-   # Or to find one object within another (for example the first text_field within a div of class 
-   # 'PasswordInput', where your password equals 'MyPassword'), one could say
-   ie.div(:class, 'PasswordInput').text_field(:index, 1).set('MyPassword')
-   
-  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.*
-   :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>
-   :class        used for an object that has a class attribute.
-   :text         used for links and other objects that contain text.
-   :xpath        finds the item using xpath query
-
-   * :id and :name are the quickest of these to process, and so should be used when possible to speed up scripts.
-
- 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
-  
- 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 optionally installs AutoIt - http://www.autoitscript.com/
-   This is the prefered method for dealing wth pop ups, file requesters etc. Support for Winclickers will be removed.
-
-Contacts:
-   Bret Pettichord (bret@pettichord.com)
-   Charley Baker (charley.baker@gmail.com)
-   Paul Rogers (paul.rogers@shaw.ca)
-   The mailing list: http://groups.google.com/group/watir-general
-
-Contributors:
-   Bret Pettichord
-   Paul Rogers
-   Jonathan Kohl
-   Chris Morris
-   Karlin Fox
-   Lorenzo Jorquera
-   Atilla Ozgur
-   Justin McCarthy
-   Chris McMahon
-   Elisabeth Hendrickson
-   Michael Kelly
-   Peter Chau
-   Danny Faught
-   Andy Sipe
-   John Lloyd-Jones
-   Chris Hedges
-   Park Heesob
-   Shashank Date
-   Jared Luxenberg
-   Alexey Verkhovsky
-   Tuyet Cong-Ton-Nu
-   Jeff Wood
-   Angrez Singh
-   Abhishek Goliya
-   Yaxin Wang
-   Michael Bolton
-   Paul Carvalho
-   Konstantin Sobolev
-   David Schmidt 
-   Dara Lillis
-   Charley Baker
-   Prema Arya
-   Xavier Noria
-   Jeff Fry
-   Zeljko Filipin
-   Paul Taylor - Bug fix 194
-   Vincent Xu - Chinese input support
-   Tomislav Car - Filefield fix (210)
-   Michael Hwee & Aidy Lewis - Multiple attribute support for FireWatir (233)
-   Alan Baird - Fix for visible? method (253)
-   Jari Bakken - Regexp support for includes? and selected? methods for select lists (261)
-
-Acknowledgements:
-   Chris Morris
-   Brian Marick
-   Jonathan Kohl
-   Penny Tonita
-   Janet Gregory
-   Andy Tinkham
-   Jacinda Scott (logo creator)
-
-   Thanks for your ideas and support!
-
-=end