rwebunit 0.9.4 → 1.0.3

data/CHANGELOG

@@ -1,168 +1,228 @@
-CHANGELOG
-=========
-
-== 0.9.4
- - 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 rwebunit 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.
+CHANGELOG
+=========
+  1.0.3
+  -- add method: dubugging?
+  -- add utils method: this_dir, this_file
+  
+  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 rwebunit 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 rwebunit 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

@@ -1,4 +1,4 @@
-Copyright (c) 2006 Zhimin Zhan, zhimin@zhimin.com
+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

data/README

@@ -1,30 +1,33 @@
-rWebUnit is a ruby version of thoughtwork's open source jWebUnit, which 'facilitates creation of
-acceptance tests for web applications'.
-
-rWebUnit wraps the popular web testing framework: WATIR  (jWebUnit depends on HttpUnit).
-Because underlying technologies are different (HttpUnit simulates a browser, Watir drives IE), rWebUnit does
-not support full jWebUnit API.  
-
-For example, 
-  jWebUnit: checkCheckBox("name", "new_value") can set new value for a checkbox, but rWebUnit/Watir can't.
-On the other hand, HttpUnit has limited support of Javascript, You don't need to worry about it in Watir.
-
-Here are reasons you might want to try rWebUnit instead of using Watir directly.
-
-  * already familar with jWebUnit framework (arguably, more readable tests)
-  * want to use WebTest - Page framework to design your tests (look at sample\kongming_webtest.rb)
-  * want to use a high level of API beyond specific framework: WATIR
-  * utilize common test methods included in rWebUnit (like getToday ...)
-  
-TODO:
-====
-  * file upload (waiting for Watir 2.0?)
-  * script to convert jWebUnit -> rWebUnit, and vice versa.
-  
-FAQ:
-===
-1. How can I run rWebUnit tests without showing IE window?
-
-A: This is really a WATIR question. Append '-b' option your command.
-   Example: ruby hide_webtest.rb -b
+
+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 'rwebunit'
+
+spec "Locate a Suncorp Branch" do
+  include RWebUnit::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