rwebspec 1.4.0

data/CHANGELOG

@@ -0,0 +1,300 @@
+CHANGELOG
+=========
+ 1.4.0
+  Renamed to rwebspec
+  1.9 compliance
+  TODO: support JRuby to run against Firefox and Celerity
+
+ 1.3.1
+   [Enhancement] better absolutize the hyperlinks in dumped page source
+   [Fixes] logic in allowing method
+ 
+  1.3
+   add new syntax for including pages
+   extend RWebSpec::UsingPages
+   pages :login_page, :receipt_page, :page_dir => 'c:/temp'
+
+  1.2.4
+  Generate new rdoc
+
+  1.2.3
+  New - support_unicode
+  More alias assert_select_label_not_present assert_option_not_present
+  New - click_button_with_name
+
+  1.2.2
+
+  save_current_page save to ITEST2 
+
+  1.2.1 (2009-04-02)
+  
+  Fixes - base_url is file://
+  New - set_hidden_field
+  New - allowing
+  New - try { } handles boolean values as well
+  Doc update
+
+  1.2
+  REVISIT all APIs  
+  - assertions
+     - assert_not (new)
+     - assert_text_field_value (new)
+	 - assert_text_present_in_table (renamed)
+     - assert_element_present (removed, use assert div(:id, "").exists?)
+  - driver.rb
+     - wait_until (new) 
+     - repeat_try_util (new)
+     - try (add more clear messages when block failed)
+  - add unit tests
+  - run unit test against the test page in Firefox Browser       
+  - major documentation update
+   
+  1.1.3
+   add open_existing_browser
+
+  1.1.2 (2009-03-13)
+  added goto_url
+
+  1.1.1
+  add open_browser.rb, check for firefox with jssh is running
+  added assert_exists, assert_not_exists
+
+  1.1
+  
+  Changed dependency (Assertions) for test-unit 2.0.2, ruby 1.9.1 ready
+  Extract popup.rb out
+  Added repeat_try in driver.rb
+  remove should_not_allow, should_allow. Important!!! don't define methods start with should_not_, should_  
+    
+  1.0.4
+  Added: WebBrowser.html WebBrowser.text
+  Added: random method in test_utils
+  Enhancemet: close_browser works even no browser started in the test
+  move open_browser to driver.rb
+  fixed include rwebspec causing stack too deep error
+  
+  1.0.3
+  - New set of samples (real life tests)
+
+  1.0.2
+  - add more unit tests
+  Fixes cell_with_id
+
+  1.0.1
+  [Enhancement] Normalize windows file path before setting upload
+  
+  1.0 (2008-11-25)
+  
+TODO:
+  Firefox: check the element is hidden or showing,
+     Checkfor driver.rb: ajax_call_complete_after_element_hidden
+     does not support outerHtml yet
+  Firefox: attach browser,
+     Unfortundately, Firewatir does not support attaching current window
+  Firefox Workaround: element_by_id
+
+  0.10.3
+  - added label_with_id, span_with_id, cell_with_id
+  - better fixes for enabled_popup
+
+  0.10.1 (2008-11-08)
+  - Upgrade to support Firewatir 1.6.2
+  - Work around Firefox reuse one window browser issue
+  - Exclude watir/contrib/enabled_popup, user can add themselves
+  
+  0.9.10 (2008-10-28)
+  [Feature] Better support reuse IE window for testing
+
+  0.9.9.1
+  [Feature] Support pausing in iTest2
+    
+== 0.9.9
+ [Fixes] add "area" method for running tests against Firefox
+ [Enhancement] Pass browser type and base_utl when calling attach_browser
+
+== 0.9.8
+ [New] 'assert_title' to check page title
+ [Fixes] Not same two same messages to iTest in a row
+ 
+== 0.9.7
+ [TODO] support should.contains?(JAMEs)
+ [WORKING] maybe yield to suport
+ - add prepare_to_click_button_in_popup() in driver.rb
+ - refactor web_tester.rb to use dynamicly create test cases
+ - rename web_tester.rb to web_browser.rb
+ - add alias visit (goto_page)
+ - WebBrowser.attach_browser return rWebUnit WebBrowser instance instead of Watir or Firefox
+ - expect_page(Class, argument) added to support one more additional argument
+
+== 0.9.6
+ - using global variable instead of environment variable passing between rwebspec and iTest
+ - add debug()
+
+== 0.9.5
+ - Add support for iTest to trace execution
+
+== 0.9.4 (2008-08-20)
+ - change test_context => context, avoid confusing Ruby test
+ - refactored driver.rb
+
+== 0.9.3
+ - add method failsafe {}
+
+== 0.9.2
+ - sleep 0.5 seconds after clicking popup window
+ - save current page
+ - (0.9.1.1) support rspec 1.1.4: at exit hook
+
+== 0.9.1 (2008-05-26)
+ - support storing page source during execution
+
+== 0.9 (2008-05-21)
+  - support new syntax
+       spec "" do
+		  scenario "1" do
+		  end
+
+		  story "2" do
+		  end
+       end
+
+== 0.8.9
+  - support Watir 1.5.4 zippy mode, set it as default
+
+== 0.8.8
+  - support iTest hiding browse option
+
+== 0.8.7
+  - support delay between operations (must be click_... type operation) for iTest2
+
+== 0.8.6
+  - Add dependency on activesupport 2.0.x, xml_simple to support 1.days.ago
+  - RSpec Helper, overwrite rspec patch
+
+== 0.8.5
+ - click button with image
+ - better handling new pop up window
+ - fixes links_with_text
+
+== 0.8.4
+ - better support for iTest
+ - for firefox support, don't do slow typing, just set text in textfield
+
+== 0.8.2
+ - fixed assert_link_not_present has .Text
+
+== 0.8.1
+ - fixed attach_browser issue
+
+== 0.8 (2008-01-18)
+ - change click_link to click_link_with_text, to for id click, use click_link_with_id
+ - change click_button to click_button_with_text, to for id click, use click_button_with_id
+
+== 0.7.2 (2007-12-31)
+ - Change dependency from Watir => Watir or FireWatir
+   Now can run on Mac or Linux
+ - Fixes: shall_not_allow syntax error
+
+== 0.7.1 (2007-12-24)
+ - Fixes error when firefox is not available
+
+== 0.7 (2007-12-18)
+ - support Firefox using FireWatir
+
+== 0.6.9
+ - add shall_not_allow
+ - more watir wrapper methods
+
+== 0.6.4 (2007-11-30)
+ - updated rwebspec 0.6.4
+ - support javascript window
+ - support watir td, tr...
+
+== 0.6.0 (2007-11-18)
+ - support watir convenient methods
+
+== 0.5.4 (2007-11-12)
+ - fixed element_by_id
+
+== 0.5.3 (2007-11-07)
+ - fixed ajax_wait_element with web_tester changes
+ - added wait_for_element
+
+== 0.5.2 (2007-09-27)
+ - added element_text
+
+== 0.5.1 (2007-09-21)
+ - add wrap of Watir methods, such as buttons, button(...)
+ - expose Watir low level methods to test/spec through Driver.rb
+ - removed old way using array and comparision to access individual control
+ - renamed html_title to page_title
+ - add method contains_text
+ - make faster checkbox operations
+ - make faster radio operations
+ - added radio operation in driver.rb
+ - renamed ajax_wait_for_element
+ - added some comments
+
+== 0.5.0
+ - Support Watir 1.5.2
+
+== 0.4.5
+  - support checkboxes with same name
+
+== 0.4.2
+
+New Features
+  - Drop support for java syntax methods
+  - remove assert helper methods in web_tester
+  - improve support for RSpecs
+
+== 0.4.0 (2007-05-29)
+
+New features
+  - Support RSpec
+
+== 0.3.1 (2007-04-18)
+
+Bug fix reelase
+
+== 0.3.0 (2007-02-16)
+
+New features
+  - Deprecated Java like method name, use ruby naming convention instead, beginAt => begin_at
+  - More ajax related calls: ajax_wait_for_element_show, ajax_wait_for_element_hide, assert_position_in_list
+
+== 0.2.0 (2006-11-28)
+
+New features:
+  - wait_ajax_udpate(elem_id, seconds) - use indicator image id to determine whether the ajax request is completed or not
+  - browser_opened?
+
+A number of general fixes and code improvements.
+
+== 0.1.1
+
+New jWebUnit API methods implemented:
+  assertOptionEquals(selectName, optionLabel)
+  assertOptionValueEquals(selectName, optionValue)
+  assertCheckboxNotSelected(checkBoxName)
+  assertCheckboxSelected(checkBoxName)
+  assertLinkPresentWithExactText(linkText)
+  assertLinkNotPresentWithExactText(linkText)
+  assertRadioOptionNotPresent(radioGroup, radioOption)
+  assertRadioOptionPresent(radioGroup, radioOption)
+  assertRadioOptionSelected(radioGroup, radioOption)
+  assertRadioOptionNotSelected(radioGroup, radioOption)
+  assertTextInTable(tableId, text)
+  assertTextNotInTable(tableId, text)
+
+API methods modified:
+  assertLinkPresentWithText(linkText):
+  assertLinkNotPresentWithText(linkText):
+
+New rWebUnit API :
+  clickRadioOption(radioGroup, radioOption): this method is protected in jWebUnit
+
+== 0.1.0
+
+* Initial release.
+* Most common web actions and assertions implemented.

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2006-2008 Zhimin Zhan, zhimin@zhimin.com
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README

@@ -0,0 +1,33 @@
+
+rWebUnit wraps the popular web testing framework WATIR with RSpec Syntax to provide better easy to read automated web test cases. By using iTest/Watir recorder, the rWebUnit test scripts can be recorded in Firefox. iTest2 makes editing/executing test cases with ease. 
+
+Sample rWebUnit Test:
+
+require 'rwebspec'
+
+spec "Locate a Suncorp Branch" do
+  include RWebSpec::RSpecHelper
+
+  before(:all) do
+    open_browser_with("http://suncorp.com.au/")
+  end
+
+  before(:each) do
+    goto_page("/locator")
+  end
+
+  after(:all) do
+    close_browser
+  end
+
+  scenario "Find by extended trading hours" do
+    checkbox(:id, "OpenExtendedTradingHoursSerivceId").click # using Watir directly
+    enter_text("Postcode_Locator__Postcode", "4061") 
+    click_button_with_image("search_button.gif")
+    page_source.should include("Queen St Mall")  
+  end
+end
+
+
+iTest2 Homepage: http://www.itest2.com
+  

data/Rakefile

@@ -0,0 +1,94 @@
+require 'rubygems'
+require 'spec/rake/spectask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rdoc' # require rdoc 2
+gem 'darkfish-rdoc'
+# require 'darkfish-rdoc'
+
+$:.unshift(File.dirname(__FILE__) + "/lib")
+#require 'rwebspec'
+
+desc "Default task"
+task :default => [ :clean, :spec, :rdoc, :chm, :gem]
+
+desc "Clean generated files"
+task :clean do
+  rm_rf 'pkg'
+  rm_rf 'doc'
+  rm_rf 'chm'
+end
+
+desc 'Run all specs'
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_opts = ['--format', 'specdoc', '--colour']
+  # t.libs = ["lib", "server/lib" ]
+  t.spec_files = Dir['spec/**/*_spec.rb'].sort
+end
+
+# Generate the RDoc documentation
+# Rake::RDocTask.new { |rdoc|
+#   rdoc.rdoc_dir = 'doc'
+#   rdoc.title = 'rWebUnit'
+#   rdoc.template = "#{ENV['template']}.rb" if ENV['template']
+#   rdoc.rdoc_files.include('README')
+#   rdoc.rdoc_files.include('lib/rwebspec.rb')
+#   rdoc.rdoc_files.include('lib/rwebspec/*.rb')
+# }
+
+# using DarkFish - http://deveiate.org/projects/Darkfish-Rdoc/
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title = 'RWebSpec'
+  rdoc.rdoc_files.include('lib/rwebspec.rb')
+  rdoc.rdoc_files.include('lib/rwebspec/*.rb')
+    rdoc.options += [
+        '-SHN',
+        '-f', 'darkfish',  # This is the important bit
+      ]
+end
+
+Rake::RDocTask.new("chm") do |rdoc|
+  rdoc.rdoc_dir = 'chm'
+  rdoc.title = 'RWebSpec'
+  rdoc.rdoc_files.include('lib/rwebspec.rb')
+  rdoc.rdoc_files.include('lib/rwebspec/*.rb')
+    rdoc.options += [
+        '-SHN',
+        '-f', 'chm',  # This is the important bit
+      ]
+end
+
+
+spec = Gem::Specification.new do |s|
+  s.platform= Gem::Platform::RUBY
+  s.name = "rwebspec"
+  s.version = "1.4.0"
+  s.summary = "Executable functional specification for web applications in RSpec syntax and Watir"
+  # s.description = ""
+
+  s.author  = "Zhimin Zhan"
+  s.email   = "zhimin@agileway.net"
+  s.homepage= "http://github.com/zhimin/rwebspec/tree/master"
+  s.rubyforge_project = "rwebspec"
+
+  s.has_rdoc    = true
+  s.requirements << 'none'
+  s.require_path    = "lib"
+  s.autorequire     = "rwebspec"
+
+  s.files = [ "Rakefile", "README", "CHANGELOG", "MIT-LICENSE" ]
+  s.files = s.files + Dir.glob( "lib/**/*" )
+  s.files = s.files + Dir.glob( "test/**/*" )
+  s.files = s.files + Dir.glob( "sample/**/*")
+  s.files = s.files + Dir.glob( "docs/**/*" )
+  s.add_dependency(%q<rspec>, ["= 1.1.12"])
+  s.add_dependency("commonwatir", ">= 1.6.2")
+  s.add_dependency("test-unit", ">= 2.0.2")
+  #  s.add_dependency("watir", ">= 1.6.2")
+  #  s.add_dependency("firewatir", ">= 1.6.2")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+end

data/lib/rspec_extensions.rb

@@ -0,0 +1,51 @@
+module Spec
+  module Extensions
+    module Main
+
+      alias :spec :describe
+      alias :specification :describe
+      alias :test_suite :describe
+      alias :suite :describe
+
+    end
+  end
+end
+
+# For RSpec 1.1.12
+module Spec
+  module DSL
+    module Main
+
+      alias :spec :describe
+      alias :specification :describe
+      alias :test_suite :describe
+      alias :suite :describe
+
+    end
+  end
+end
+
+# ZZ patches to RSpec 1.1.4
+#  - add to_s method to example_group
+module Spec
+  module Example
+    class ExampleGroup
+      def to_s
+        @_defined_description
+      end
+    end
+  end
+end
+
+module Spec
+  module Example
+    module ExampleGroupMethods
+
+      alias_method :scenario, :it
+      alias_method :story, :it
+      alias_method :test_case, :it
+      alias_method :use_case, :it
+      alias_method :test, :it
+    end
+  end
+end