honey-do 0.5.0

data/test/select_list_test.rb

@@ -0,0 +1,155 @@
+require 'test_master'
+
+class TestSelectFeatures < Test::Unit::TestCase
+  
+  def test_select_from_droplist_by_visible_text
+    text_value = "Light Grey"
+
+    browser.set_form_values(:color => text_value)
+    assert_equal(text_value, browser.get_form_values[:color], "exact match")
+
+    reset_then_set(:color => "lIGhT gReY")
+    assert_equal(text_value, browser.get_form_values[:color], "case insensitive")
+  end
+
+  def test_select_from_droplist_by_value
+    option_value_property = "flat eggshell white"
+    option_text_property = "Off White"
+
+    browser.set_form_values(:color => option_value_property)
+    value_set_by_value_property = browser.get_form_values[:color]
+
+    reset_then_set(:color => option_text_property)
+    value_set_by_visible_text_label = browser.get_form_values[:color]
+
+    test_intent = "same item set by text or value"
+    assert_equal(value_set_by_value_property, value_set_by_visible_text_label, test_intent)
+    assert_equal(value_set_by_value_property, option_text_property, test_intent)
+
+    reset_then_set(:color => option_value_property.upcase)
+    assert_equal(option_text_property, browser.get_form_values[:color], "case insensitive")
+  end
+
+  # substring match - anchored to ^ (beginning of string); *, ? and + are just text (not wildcards)
+  def test_select_from_droplist_by_substring_match_on_visible_text
+    default_selection = browser.get_form_values[:color]
+
+    test_intent = "substring: anchored to beginning of string '^'"
+    browser.set_form_values(:color => "ligh")
+    assert_equal("Light Grey", browser.get_form_values[:color], test_intent)
+
+    assert_raise(RuntimeError, test_intent) do
+      reset_then_set_without_retry(:color => "ight Grey")
+    end
+    assert_equal(default_selection, browser.get_form_values[:color], test_intent)
+    
+    test_intent = "substring: no wildcards"
+    assert_raise(RuntimeError, test_intent) do
+      reset_then_set_without_retry(:color => "Light*")
+    end
+    assert_equal(default_selection, browser.get_form_values[:color], test_intent)
+  end
+
+  def test_select_from_droplist_by_substring_match_on_value
+    default_selection = browser.get_form_values[:color]
+
+    option_value_property = "flat eggshell white"
+    option_text_property = "Off White"
+
+    test_intent = "substring: anchored to beginning of string '^'"
+    browser.set_form_values(:color => "Flat Egg")
+    assert_equal(option_text_property, browser.get_form_values[:color], test_intent)
+
+    assert_raise(RuntimeError, test_intent) do
+      reset_then_set_without_retry(:color => "hell white")
+    end
+    assert_equal(default_selection, browser.get_form_values[:color], test_intent)
+    
+    test_intent = "substring: no wildcards"
+    assert_raise(RuntimeError, test_intent) do
+      reset_then_set_without_retry(:color => "flat egg*")
+    end
+    assert_equal(default_selection, browser.get_form_values[:color], test_intent)
+  end
+
+  def test_select_from_droplist_by_index
+    test_intent = "selection made by index"
+    default_selection = browser.get_form_values[:color]
+    
+    browser.set_form_values(:color => 2)
+    assert_equal("Orange", browser.get_form_values[:color], test_intent )
+      
+    browser.set_form_values(:color => 7)
+    assert_equal("Violet", browser.get_form_values[:color], test_intent)
+  
+    browser.set_form_values(:color => 0)
+    assert_equal(default_selection, browser.get_form_values[:color], test_intent)
+  end
+  
+  def test_select_from_multi_select_by_index
+    assert_nil(browser.get_form_values[:hobbies], "this multi-select has no default")
+
+    test_intent = "selection made by index"
+    
+    browser.set_form_values(:hobbies => 1)
+    assert_equal("Surfing the Web", browser.get_form_values[:hobbies], test_intent )
+      
+    reset_then_set(:hobbies => 3)
+    assert_equal("Annoying my friends", browser.get_form_values[:hobbies], test_intent)
+  
+    reset_then_set(:hobbies => 0)
+    assert_equal("Hacking JavaScript", browser.get_form_values[:hobbies], test_intent)
+  end
+
+  def test_select_multiple_from_multi_select
+    browser.set_form_values([[:hobbies, :last], [:hobbies, "Surfing"], [:hobbies, 0]]) 
+    
+    values_read_from_screen = browser.get_form_values
+    
+    assert_equal("Hacking JavaScript|Surfing the Web|Zipping around on my scooter", values_read_from_screen[:hobbies])
+
+    compound_values = values_read_from_screen.split_compound_values
+
+    assert_equal("Hacking JavaScript", compound_values[:hobbies])
+    assert_equal("Surfing the Web", compound_values[:hobbies_1])
+    assert_equal("Zipping around on my scooter", compound_values[:hobbies_2])
+  end
+
+  # <tt>last</tt> is a keyword for listboxes and droplists (<tt>select-multiple</tt> and <tt>select-one</tt>)
+  def test_select_last
+    browser.set_form_values(:color => "last", :hobbies => :last)
+    values_as_set = browser.get_form_values
+
+    assert_equal("Zinc", values_as_set[:color], "last item happens to be 'Zinc'")
+    assert_match("Zipping", values_as_set[:hobbies], "last item happens to be 'Zipping around on my scooter'")
+  end
+
+  # <tt>random</tt> is a keyword for listboxes and droplists (<tt>select-multiple</tt> and <tt>select-one</tt>)
+  def test_select_random_from_droplist_stays_in_range
+    assert_nothing_raised(RuntimeError, SeleniumCommandError) do
+      80.times {browser.set_form_values(:color => :random)}
+    end
+  end
+  
+  def test_select_random_from_multi_select_stays_in_range
+    assert_nothing_raised(RuntimeError, SeleniumCommandError) do
+      30.times {reset_then_set(:hobbies => "random")}
+    end
+  end
+
+  protected
+
+  def setup
+    super
+    browser.open("everything.html")
+  end
+  
+  # prepend :resetButton
+  def reset_then_set(input_hash)
+    browser.set_form_values(input_hash.to_a.unshift(:resetButton) )
+  end
+
+  def reset_then_set_without_retry(input_hash)
+    browser.set_form_values(input_hash.to_a.unshift(:resetButton), :retry_max => 0 )
+  end
+end

data/test/submit_test.rb

@@ -0,0 +1,82 @@
+require 'test_master'
+
+class TestSubmitForm < Test::Unit::TestCase
+
+  def test_submit_with_array_to_guarantee_order
+    form_input = [
+                  [:hobbies, "Drinking Coffee"],
+                  [:color, 3],
+                  [:extras, "card"],
+                  [:username, @method_name],
+                  [:browser, "ie"],
+                  [:event_reports_area, "Put the submit button at the end, or it may get clicked before all our other values are set."],
+                  :submitButton # name with no value can stand alone: no need to nest it in another array
+                  ] 
+                  
+    browser.set_form_values(form_input)
+    verify_page_loaded
+    
+    # we'll verify an interesting subset of what got submitted
+    expected_values = {:hobbies => "caffeine", :username => @method_name, :event_reports_area => form_input[5][1], :browser => "ie"}
+    verify_subset_of_values_persist_on_display_page(expected_values)
+  end
+  
+  # input as hash: we have no control of order, so we submit after having set all the values
+  def test_submit_with_button_name_in_separate_call
+    one_of_each = {:username => @method_name, 
+                   :password => "crypto",
+                   :extras => "printer", 
+                   :browser => 1,
+                   :hobbies => "Drinking Coffee", 
+                   :color => "gold",
+                   :event_reports_area => "blah blah yakkity yak " * 38, 
+                   :hackzall => true}
+
+    browser.set_form_values(one_of_each)
+    
+    submitted_values = browser.get_form_values
+    
+    assert_not_equal(one_of_each, submitted_values, "we didn't supply literal text for all of the fields")
+
+    browser.set_form_values(:submitButton)
+
+    verify_page_loaded
+    
+    # prepare expected values to exactly match POST request data (web servlet reports everything in the body of the POST request)
+    submitted_values[:submitButton] = "Submit"  # Normally we wouldn't care about the buttons but only 'data' fields.
+
+    submitted_values[:hobbies] = "caffeine"     # Reader 'browser.get_form_values()' deals in visible 'text' property, 
+    submitted_values[:color].downcase!          # not the value property of the element
+    
+    # Reader 'browser.get_form_values()' ignores hidden elements, but they do get posted
+    submitted_values[:justHiding] = "you can't see this unless you're looking at the source"
+
+    verify_all_values_persist_on_display_page(submitted_values)
+  end
+  
+  protected
+
+  def setup
+    super
+    browser.open("everything.html")
+  end
+
+  def verify_page_loaded
+    page_load_wait
+    assert(browser.is_element_present("id=form_values_table"), "display table is present on loaded page")
+    assert_match(/\/display/, browser.get_location, "url")  
+  end
+  
+  # the web servlet makes a page using the POSTED form names as cell (td) id's, so we have no extra mapping work to do
+  def verify_all_values_persist_on_display_page(expected)
+    assert_equal(expected, browser.get_cell_ids_and_text("form_values_table"), "what we submitted appears on display page")
+  end
+  
+  def verify_subset_of_values_persist_on_display_page(expected)
+    actual_display_values = browser.get_cell_ids_and_text #("form_values_table")  # only 1 table on the page, so we can accept the default of index == 0
+    expected.each do |key, value|
+      assert_equal(value, actual_display_values[key], "value of #{key}")
+    end
+  end
+
+end

data/test/test_master.rb

@@ -0,0 +1,18 @@
+unless $0.include?("/rake/")   # to run tests without rake
+  $LOAD_PATH.unshift( File.expand_path('../lib'), File.expand_path('../functional_testcase') ) 
+end  
+
+require 'honey_do'
+require 'functional_testcase'
+
+def page_load_wait
+  browser.wait_for_page_to_load(2000)
+end
+
+def reset
+  browser.set_form_values(:resetButton)
+end
+
+def verify_event_trace(expected, field_name)
+  assert_match(expected, browser.get_form_values[:event_reports_area], "'#{field_name}' events in the trace")
+end

data/test/textarea_test.rb

@@ -0,0 +1,92 @@
+require 'test_master'
+
+class TestTextareaInput < Test::Unit::TestCase
+
+  # escape them!
+  #   \\n
+  #   \\'
+  def test_newlines_and_apostrophes_in_input
+    #RuntimeError: ERROR: Threw an exception: unterminated string literal
+    assert_raise(RuntimeError) do
+      browser.set_form_values({:event_reports_area => "What should we do?\nI think we should get a puppy."},{ :retry_max => 0})
+    end
+
+    #RuntimeError: ERROR: Threw an exception: missing ) after argument list
+    assert_raise(RuntimeError) do
+      browser.set_form_values({:event_reports_area => "I'm sure they'd love a puppy!"}, { :retry_max => 0})
+    end
+
+    text_area_input = "What should we do?\\nI think we should get a puppy.\\nI\\'m sure they\\'d love a puppy!"
+    assert_nothing_raised(RuntimeError, SeleniumCommandError) do
+      browser.set_form_values(:event_reports_area => text_area_input)
+    end
+    
+    assert_equal(text_area_input.gsub("\\n","\n").gsub("\\'", "'"), get_textarea_value)
+  end
+
+  def test_commas_in_input
+    stanza_1_of_pearl = %Q{Perle, plesaunte to prynces paye
+To clanly clos in golde so clere,
+Oute of oryent, I hardyly saye,
+Ne proued I neuer her precious pere.
+So rounde, so reken in vche araye,
+So smal, so smothe her sydes were,
+Quere-so-euer I jugged gemmez gaye,
+I sette hyr sengeley in synglere.
+Allas!  I leste hyr in on erbere;
+Thurgh gresse to grounde hit fro me yot.
+I dewyne, fordolked of luf-daungere
+Of that pryuy perle wythouten spot.}
+
+    browser.set_form_values(:event_reports_area => stanza_1_of_pearl.gsub("\n","\\n"))
+    textarea_value = get_textarea_value
+
+    test_intent = "entire string put in, including commas and all clauses"
+    assert_equal(stanza_1_of_pearl, textarea_value, test_intent)
+    assert_equal(stanza_1_of_pearl.split(','), textarea_value.split(','), test_intent)
+    assert_equal(stanza_1_of_pearl.size, textarea_value.size, test_intent)
+  end
+
+  TRIPLE_COLON_STRING = "Who in their right mind would ever include::: in any kind of text input?:::That would be crazy!"
+  # ":::" is used to delimit fields (names or name/value pairs) in input to js <tt>Form_.prototype.set_values()</tt>
+  def test_triple_colon_is_input_delimiter_with_mulitiple_fields
+    triple_colon_is_input_delimiter(:event_reports_area => TRIPLE_COLON_STRING, :username => "Mr. Red Herring", :extras => "printer", :browser => "ff")
+  end
+  
+  def test_triple_colon_is_input_delimiter_with_single_field
+    triple_colon_is_input_delimiter(:event_reports_area => TRIPLE_COLON_STRING)
+  end
+
+  protected
+
+  def setup
+    super
+    browser.open("everything.html")
+  end
+  
+  # strip IE carriage return
+  def get_textarea_value
+    browser.get_form_values[:event_reports_area].gsub(/\r/,"")
+  end
+
+  def triple_colon_is_input_delimiter(input_values)
+    browser.set_form_values(input_values)
+
+    text_area_input = input_values[:event_reports_area]
+    value_as_set = browser.get_form_values[:event_reports_area]
+    
+    test_intent = "input string was truncated at first ':::' delimiter"
+    assert(value_as_set.size < text_area_input.size, test_intent)
+    assert_equal(value_as_set, text_area_input.split(':::')[0], test_intent)
+    assert_not_equal(value_as_set, text_area_input, test_intent)
+
+    # remove the delimiter
+    input_values[:event_reports_area] = text_area_input.gsub(/:::/, " a triple colon ")
+
+    browser.set_form_values(input_values)
+    value_as_set = browser.get_form_values[:event_reports_area]
+
+    assert_equal(value_as_set, input_values[:event_reports_area], "entire string put in, now that we have removed ':::'")
+  end
+
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: honey-do
+version: !ruby/object:Gem::Version 
+  version: 0.5.0
+platform: ruby
+authors: 
+- Tim Camper
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-26 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: Selenium
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.1
+    version: 
+description: collection driven, commandless form handling for Selenium
+email: twcamper@thoughtworks.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- COPYING
+- js/user-extensions.js
+- doc/INSTALLATION
+- doc/running_the_tests.rdoc
+- test/checkbox_test.rb
+- test/events_test.rb
+- test/fast_and_pretty_test.rb
+- test/file_upload_test.rb
+- test/general_form_test.rb
+- test/hidden_and_disabled_field_test.rb
+- test/radio_button_test.rb
+- test/select_list_test.rb
+- test/submit_test.rb
+- test/test_master.rb
+- test/textarea_test.rb
+- functional_testcase/functional_testcase.rb
+- demo/webrick-servlet.rb
+files: 
+- COPYING
+- README
+- Rakefile
+- lib/hash.rb
+- lib/honey_do.rb
+- lib/symbol.rb
+- test/checkbox_test.rb
+- test/events_test.rb
+- test/fast_and_pretty_test.rb
+- test/file_upload_test.rb
+- test/general_form_test.rb
+- test/hidden_and_disabled_field_test.rb
+- test/radio_button_test.rb
+- test/select_list_test.rb
+- test/submit_test.rb
+- test/test_master.rb
+- test/textarea_test.rb
+- demo/display
+- demo/display/webrick_servlet_needs_this_folder.txt
+- demo/page
+- demo/page/everything.html
+- demo/page/everything.js
+- demo/webrick-servlet.rb
+- functional_testcase/functional_testcase.rb
+- bin/start_selenium_proxy.bat
+- bin/start_selenium_proxy.sh
+- js/user-extensions.js
+- doc/INSTALLATION
+- doc/running_the_tests.rdoc
+has_rdoc: true
+homepage: http://honey-do.rubyforge.org/
+post_install_message: 
+rdoc_options: 
+- --all
+- --quiet
+- --line-numbers
+- --inline-source
+- --main
+- README
+- --title
+- "Honey-Do: Just give it a list!"
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.2
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: honey-do
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: collection driven, commandless form handling for Selenium
+test_files: []
+