honey-do 0.5.0

data/COPYING

@@ -0,0 +1,11 @@
+Copyright (c) 2008 Tim Camper
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, 
+software distributed under the License is distributed on an "AS IS" BASIS, 
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+  
+See the License for the specific language governing permissions and limitations under the License.

data/README

@@ -0,0 +1,120 @@
+=Just Give it a List!  
+
+====Collection-driven, commandless Selenium
+HoneyDo is a small Ruby/Javascript library that supports collection-driven browser automation. 
+Currently implemented as a Selenium RC user extension, it provides a simple, consistent interface to any list of 1 or more HTML form elements.
+
+Basically, you set one or many values, click one or many controls, or read the whole form with a single call, always using the same sweet syntax.
+
+==When would I use this?
+
+====When you have lots of testing to do on:
+* many forms
+* large forms
+* complex forms
+* dynamic forms
+HoneyDo was born of the need to test a large, input-heavy app with over 350 Oracle tables at the backend and over 100 input screens in the front.
+The business domain and UI workflows are complex, so the tools for making the functional tests needed to be as lightweight and flexible as possible.
+Things like GUI maps and screen driver objects are heavyweight, rigid, and brittle:  the amount of maintenance they require keeps you from getting your tests right.
+
+====When data matters, but widgets don't
+In testing app functionality through the UI, it often doesn't make a difference if you _type_, _select_, _check_, or _click_: you just need to get values to the server.
+
+==Examples
+====With a SeleniumDriver . . .
+  browser = Selenium::SeleniumDriver.new('localhost', 44...
+====Click things
+  # submit your form
+  browser.set_form_values(:saveButton)  
+
+  # toggle a bunch of checkboxes and submit
+  browser.set_form_values( [:include_documents, :calculate_fee, :require_guarantor_address, :fasb_13_ok, :120_day_rule, :UPDATE] )  
+
+====Set things
+  browser.set_form_values(:user_name => "pprubens", :password => "hy!Bosch53xy")
+
+  browser.set_form_values(:state => "TN", :street_1 => "9113 Foo St.", :street_2 => "4D", :city => "Erlewine", :postal => 99999, :same_as_shipping => true)
+
+====Read things
+  default_values = browser.get_form_values("newProprietorshipForm")
+  assert_equal({:state => "AL", 
+                :typeOfBusiness => "Please Select", 
+                :taxjurisdiction => "Federal", 
+                :corporation => "on",
+                :submitButton => "Save", 
+                :cancel => "Cancel"}, default_values, "only default fields populated?")
+
+  visible_fields = browser.get_form_elements("newProprietorshipForm").split(',')
+  assert_equal(visible_fields.size - default_values.size, 17, "count of unset fields on initial page load")
+
+==How does it work?
+The key to HoneyDo#set_form_values is that each HTML <tt>form</tt> element knows its own type.  If we identify the element, the code knows what to do.
+
+For each element in our input list:
+====1 - find the element
+The <tt>form.elements</tt> collection is a JavaScript associative array, so we can use either its array index or its <tt>name</tt> attribute.  
+For a generic js example, these will all have the same effect if <tt>selectDealer</tt> is the 3rd element:
+  element = myForm.elements['selectDealer'];
+  element = myForm.elements[2];
+  element = myForm.elements['2'];
+  
+====2 - get its type
+  element.type
+====3 - set the value (or call <tt>click()</tt>)
+The +type+ could be:
+
+settable: <tt>(text, textarea, password)</tt>::  The +value+ attribute is set
+selectable: <tt>(select-one, select-mulitple)</tt>::  The +option+ index is found and the +selected+ attribute is set
+clickable:<tt>(button, submit, reset, radio)</tt>::  <tt>click()</tt> is called.
+checkbox: <tt>(checkbox)</tt>:: the +checked+ attribute is set or <tt>click()</tt> is called
+
+When <tt>element.type</tt> has no value, then +element+ is itself a collection of other elements, i.e., a group of checkboxes or radio buttons with the same +name+.
+In this case <tt>click()</tt> is called on the correct item in the goup.
+
+====4 - fire event handlers
+Any or all of these are fired, if present:
+  onclick()
+  onchange()
+  onblur()
+  
+====Ajax
+Nothing explicit is done to wait for Ajax calls.  On HoneyDo's home app, we find that in IE the built-in <tt>retry</tt> is enough to handle the occasional glitch.
+In Firefox, multiple call mode using the <tt>:one_field_at_a_time</tt> option is required, but does in fact work.  
+We've tried the <i>prototype.js</i> <tt>Ajax.activeRequestCount</tt> trick, but couldn't figure out how get a reference to the right <tt>Ajax</tt> instance.
+
+I make no guarantees about how this will work with _your_ Ajax calls, but I'd suggest trying <tt>:one_field_at_a_time => true</tt> for your Ajax pages and just leaving it alone otherwise.
+If you need an explicit _wait_ and have the solution, JavaScript <tt>Form_.prototype.set_value()</tt> would be the place to call it from.
+
+==Installation[link:files/doc/INSTALLATION.html]
+There's a manual step[link:files/doc/INSTALLATION.html].
+
+==The Implementation
+Selenium user extensions that aren't implemented as methods on the <tt>Selenium</tt> JavaScript prototype object might be odd.  
+However, some of these methods require pre- or post-processing in Ruby, so I couldn't think of any other way to do it.
+
+I'm always open to better solutions.  I'm more interested in propagating the list-driven technique wherever it's applicable than in preserving any particular encoding of it.
+
+Blessings upon whoever came up with <tt>SeleniumDriver.get_eval()</tt>!
+
+==The Tests[link:/classes/TestGeneralInputOptions.html] ...
+... are the *documentation*. They detail the features and limitations. 
+Run[link:/files/doc/running_the_tests_rdoc.html] them and read[link:/classes/TestGeneralInputOptions.html] them.
+
+====See running_the_tests[link:/files/doc/running_the_tests_rdoc.html]
+
+==Why be collection-driven?
+
+====More testing, less code
+As a functional test automator and automation lead, I want my scripts, scripters, and self to do more of the testing work that matters, 
+in less time, with less code to distract from finding bugs.
+
+At run time, scripts go faster[link:/classes/TestFastAndPretty.html] when all of the fields are set or read in one go, rather than with an individual Selenium call for each field.
+At development and maintenance time, the code is streamlined considerably by removing the usually unnecessary layer of "action" commands.  And the
+scripters' work goes faster when there is only one API to learn, as opposed to many different ones for all of the different widget types.
+
+====User emulation is waste
+Named actions (_click_, _select_, _toggle_, etc) that require us to identify the type of control being called and to specify the arguments to each command differently derive from
+the assumption that functional test automation implies or requires end-user emulation.  Emulating human users and testing app functionality are two
+different programming problems, and while user emulation is certainly possible it rarely adds anything but clutter, confusion, and complexity to the
+functional testing effort.  Unless there is an explicit testing need to make assertions about the mechanical details of interacting with widgets in
+type-specific ways, then we are better off without named actions.

data/Rakefile

@@ -0,0 +1,76 @@
+require 'rake/rdoctask'
+require 'rake/testtask'
+require 'rake/gempackagetask'
+require 'open-uri'
+
+desc "run all tests"
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'functional_testcase' << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+task :test => [:selenium, :webrick]
+
+desc "verify selenium is running"
+task :selenium do
+  error = nil
+  begin
+    open("http://localhost:4444")
+  rescue Exception => ex
+    error = ex.message
+  end
+  raise RuntimeError.new("SELENIUM IS NOT RUNNING:\n#{error}") if error !~ /403 /
+end
+
+desc "verify webrick demo server is running"
+task :webrick do
+  error = nil
+  begin
+    open("http://localhost:8000")
+  rescue Exception => ex
+    error = ex.message
+  end
+  raise RuntimeError.new("WEBRICK SERVER IS NOT RUNNING:\n#{error}") if error
+end
+
+RDOC_OPTS = ["--all" , "--quiet" , "--line-numbers" , "--inline-source", 
+             "--main", "README", 
+             "--title", "Honey-Do: Just give it a list!"]
+XTRA_RDOC = %w{README COPYING js/user-extensions.js doc/INSTALLATION doc/running_the_tests.rdoc}
+
+Rake::RDocTask.new do |rd|
+  rd.rdoc_dir = "doc/rdoc"
+  rd.rdoc_files.include("**/*.rb")
+  rd.rdoc_files.add(XTRA_RDOC)
+  rd.options = RDOC_OPTS
+end
+
+spec = Gem::Specification.new do |s|
+  s.name = 'honey-do'
+  s.version = '0.5.0'
+  s.rubyforge_project = s.name
+
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = XTRA_RDOC + FileList["test/*.rb", "functional_testcase/*.rb", "demo/**/*.rb"].to_a
+  s.rdoc_options += RDOC_OPTS
+  s.summary = "collection driven, commandless form handling for Selenium"
+  s.description = s.summary
+  s.author = "Tim Camper"
+  s.email = 'twcamper@thoughtworks.com'
+  s.homepage = 'http://honey-do.rubyforge.org/'
+
+  s.add_dependency('Selenium', '>= 1.0.1')
+  s.required_ruby_version = '>= 1.8.2'
+
+  s.files =  %w(COPYING README Rakefile) + 
+             FileList["lib/*.rb", "test/*.rb", "demo/**/*", "functional_testcase/*.rb", "bin/*"].to_a
+  
+  s.require_path = "lib"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.need_zip = true
+  p.need_tar = true
+  p.gem_spec = spec
+end

data/bin/start_selenium_proxy.bat

@@ -0,0 +1,4 @@
+@echo off
+REM SAMPLE windows command line
+REM your paths, Sel version and options may vary
+java -jar ..\..\selenium-remote-control-0.9.2\server\selenium-server.jar -multiWindow  -userExtensions ..\js\user-extensions.js

data/bin/start_selenium_proxy.sh

@@ -0,0 +1,3 @@
+# SAMPLE command line
+# your paths, Sel version and options may vary
+java -jar ../../selenium-remote-control-0.9.2/server/selenium-server-ff3.jar -multiWindow  -userExtensions ../js/user-extensions.js

data/demo/page/everything.html

@@ -0,0 +1,112 @@
+<html>
+<head>
+  <title>HoneyDo Demo Form: Just give it a list!</title>
+  <script language="JavaScript" src="everything.js"></script>
+</head>
+<body>
+    <!-- A one-of-everything HTML form:
+         after David Flanagan, Chapter 18 of "JavaScript: The Definitive Guide", O'Reilly, 5th edition
+     -->
+  <div align="center">
+  <form name="everything" method="POST" action="../display">
+    <table border="3" bgcolor="beige" cellspacing="1" cellpadding="4">
+      <tr>
+        <td colspan="4"><h4>All Possible Form Elements</h4></td>
+      </tr>
+      <tr>
+        <td>Username:<br>[1]<input type="text" name="username" size="15"></td>
+        <td>Password:<br>[2]<input type="password" name="password" size="15"></td>
+        <td rowspan="4">Input Events[3]<br>
+          <textarea name="event_reports_area" rows="20" cols="40"></textarea></td>
+        <td rowspan="4" align="center" valign="center">
+          [10]<input type="button" value="Clear" name="clearButton"><br>
+          [11]<input type="submit" value="Submit" name="submitButton"><br>
+          [12]<input type="reset" value="Reset" name="resetButton"><br>
+          [13]<input type="hidden" value="you can't see this unless you're looking at the source" name="justHiding"><br></td>
+      </tr>
+      <tr>
+        <td colspan="2">
+          Filename: [4]<input type="file" name="file" size="15"> </td>
+      </tr>
+      <tr>
+        <td><p>My Computer Peripherals:</p>
+          [5]<input type="checkbox" name="extras" value="burner">DVD Writer<br>
+          [5]<input type="checkbox" name="extras" value="printer">Printer<br>
+          [5]<input type="checkbox" name="extras" value="card">Card Reader<br>
+          <p>My Utilities:</p>
+          [6]<input type="checkbox" name="disk manager">Disk Manager<br>
+          [6]<input type="checkbox" name="hackzall">Firewall Drill Pro<br>
+          [6]<input type="checkbox" name="a-clock.exe">AtomSynch<br>
+          [6]<input type="checkbox" name="version control client">Sottoversione 1.4.3<br></td>
+        <td><p>My Web Browser:</p>
+          [7]<input type="radio" name="browser" value="ff">Firefox<br>
+          [7]<input type="radio" name="browser" value="ie">Internet Explorer<br>
+          [7]<input type="radio" name="browser" value="safari">Safari<br>
+          [7]<input type="radio" name="browser" value="opera">Opera<br>
+          [7]<input type="radio" name="browser" value="other browser">other<br></td>
+      </tr>
+      <tr>
+        <td>My Hobbies:[8]<br>
+          <select multiple="multiple" name="hobbies" size="5">
+            <option value="programming">Hacking JavaScript
+            <option value="surfing">Surfing the Web
+            <option value="caffeine">Drinking Coffee
+            <option value="annoying">Annoying my friends
+            <option value="zipping">Zipping around on my scooter
+          </select></td>
+        <td align="center" valign="center">My Favorite Color:<br>[9]
+          <select name="color">
+            <option value="0">
+            <option value="red">Red
+            <option value="orange">Orange
+            <option value="yellow">Yellow
+            <option value="green">Green
+            <option value="blue">Blue
+            <option value="indigo">Indigo
+            <option value="violet">Violet
+            <option value="black">Black
+            <option value="brown">Brown
+            <option value="white">White
+            <option value="grey">Grey
+            <option value="light grey">Light Grey
+            <option value="flat eggshell white">Off White
+            <option value="taupe">Taupe
+            <option value="beige">Beige
+            <option value="10256">Mauve
+            <option value="peach">Peach
+            <option value="purple">Purple
+            <option value="maroon">Maroon
+            <option value="fuchsia">Fuchsia
+            <option value="silver">Silver
+            <option value="gold">Gold
+            <option value="zinc">Zinc
+          </select></td>
+      </tr>
+    </table>
+  </form>
+  <table border="9" bgcolor="beige" cellspacing="1" cellpadding="4">
+    <tr>
+      <td colspan="7"><h4>Form Element Types</h4></td>
+    </tr>
+    <tr>
+      <td>[1] text</td> <td>[2] password</td> <td>[3] textarea</td>
+      <td>[4] file (upload)</td> <td>[5] checkbox (group)</td> <td colspan="2">[6] checkbox (independent)</td>
+    </tr>
+    <tr>
+      <td>[7] radio</td> <td>[8] select (multiple)</td>
+      <td>[9] select</td> <td>[10] button</td>
+      <td>[11] submit</td> <td>[12] reset</td><td>[13] hidden</td>
+    </tr>
+  </table>
+  <form name="events_button_form">
+    <table border="3" bgcolor="beige" cellspacing="1" cellpadding="4">
+    <tr><td> <h4>Turn on Event Handlers</h4></td></tr>
+    <tr><td>
+      <input type="button" value="Enable Handlers" name="enableEventsButton" onclick="addhandlers(document.everything)">
+     <input type="button" value="Disable Handlers" name="disableEventsButton" onclick="removehandlers(document.everything)">
+     </td>
+    </tr>
+    </table>
+  </form>
+  </div>
+</body>

data/demo/page/everything.js

@@ -0,0 +1,55 @@
+/*  
+    functions for "A one-of-everything HTML form":
+    from David Flanagan, Chapter 18 of "JavaScript: The Definitive Guide", O'Reilly, 5th edition
+*/
+
+// This generic function appends details of an event to the big Textarea
+// element in the form above.  It is called from various event handlers.
+function report(element, event)  {
+    if (selectable(element.type)) {
+        value = "";
+        for(var i = 0; i < element.options.length; i++)
+          if (element.options[i].selected)
+              value += element.options[i].value + " ";
+    }
+    else if (element.type == "textarea")  value = "...";
+    else  value = element.value;
+
+    var msg = event + ":" + element.name + ' (' + value + ')\n';
+    var t = element.form.event_reports_area;
+    t.value = t.value + msg;
+
+}
+// This function adds a bunch of event handlers to every element in a form.
+// Note that the event handlers all call report().
+
+// We are defining event handlers by assigning functions to the properties
+// of JavaScript objects rather than by assigning strings to the attributes
+// of HTML elements.
+function addhandlers(f) {
+    for(var i = 0; i < f.elements.length; i++)  {
+        var e = f.elements[i];
+        e.onclick = function() {report(this, 'Click');}
+        e.onchange = function() {report(this, 'Change');}
+        e.onfocus = function() {report(this, 'Focus');}
+        e.onblur = function() {report(this, 'Blur');}
+    }
+
+    // Special case event handlers for the 3 buttons
+    f.clearButton.onclick = function() { this.form.event_reports_area.value = ''; report(this, 'Click'); }
+    f.submitButton.onclick = function() { report(this, 'Click'); return false;}
+    f.resetButton.onclick = function() { this.form.reset(); report(this, 'Click'); return false; }
+}
+
+function removehandlers(f) {
+    for(var i = 0; i < f.elements.length; i++)  {
+        var e = f.elements[i];
+        e.onchange = null;
+        e.onfocus = null;
+        e.onblur = null;
+        if (e.name == "clearButton") continue;
+        e.onclick = null;
+    }
+}
+
+function selectable(type) { return (/^select/i).test(type);}

data/demo/webrick-servlet.rb

@@ -0,0 +1,58 @@
+require 'webrick'
+
+class HoneyDoDemoServlet < WEBrick::HTTPServlet::AbstractServlet
+
+  def do_POST(request, response)
+    status, content_type, body = format_form_values(request)
+    
+    response.status = status
+    response['Content-Type'] = content_type
+    response.body = body
+  end
+
+  # makes a document with a table of submitted form values from any POST request body.
+  def format_form_values(request)
+    html = "<html><head><title>#{Time.now.strftime('%A %B %d, %H:%M:%S')}</title></head>"
+    html += "\n<body><table border='3' bgcolor='beige' cellpadding='3' cellspacing = '2' id='form_values_table'>"
+    html += "\n<h2>Submitted from: &nbsp;<span>#{request.header['referer'].first}</span></h2>"
+
+    parse_query(request.body).sort.collect do | pair | 
+      html += write_row(*pair)
+    end
+
+    html += "\n</table></body></html>"
+  
+    return 200, "text/html", html
+  end
+  
+  # <pre> the value cell to get newlines
+  def write_row(name, value)
+    "\n<tr><td>#{name}:&nbsp;</td><td id='#{name}'><pre>#{value}</pre></td></tr>"
+  end
+  
+  # For some reason WEBrick doesn't append multiple values for checkboxes and multi-selects, thus this hack.
+  def parse_query(body)
+    query = {}
+    body.split(/[;&]/).each do |form_item|
+      key, value = form_item.split(/=/)
+      key = WEBrick::HTTPUtils::unescape_form(key)
+      value = WEBrick::HTTPUtils::unescape_form(value.to_s)
+      if query[key]
+        query[key] += "|" + value
+      else
+        query[key] = value
+      end
+    end
+    return query
+  end
+end
+
+if $0 == __FILE__ then
+  server = WEBrick::HTTPServer.new(:Port => 8000, 
+                                   :Host => 'localhost', 
+                                   :DocumentRoot => Dir::pwd + '/page')
+
+  server.mount "/display", HoneyDoDemoServlet
+  trap "INT" do server.shutdown end
+  server.start
+end

data/doc/INSTALLATION

@@ -0,0 +1,20 @@
+=== 1 - Have SeleniumRC[http://selenium-rc.seleniumhq.org/]
+=== 2 - Get the gem
+  gem install honey-do
+=== 3 - Move user-extensions.js
+1.  If you're already using a <tt>user-extensions.js</tt>, then merge the contents of <tt>honey-do/js/user-extensions.js</tt> in with yours.
+1.  Otherwise, move or copy <tt>honey-do/js/user-extensions.js</tt> to a folder convenient to your selenium proxy server.  
+1.  Start your selenium proxy with the <tt>-userExtensions</tt> option. For example, if your working directory contains both <tt>user-extensions.js</tt> and the <tt>selenium-remote-control-0.9.2</tt> folder:
+    
+      java -jar selenium-remote-control-0.9.2\server\selenium-server.jar -userExtensions user-extensions.js
+      
+    See <tt>honey-do/bin</tt> for other cmd line examples.
+    
+    See also SeleniumRC command line reference[http://selenium-rc.seleniumhq.org/options.html]
+=== 4 - +require+ / +include+
+  require 'honey_do'
+  require 'selenium'
+
+<b>Nothing to +include+</b>.  
+
+See <tt>functional_testcase/functional_testcase.rb</tt> and <tt>test/test_master.rb</tt> for examples.

data/doc/running_the_tests.rdoc

@@ -0,0 +1,81 @@
+=Running The Tests
+
+===Once you've installed[link:/files/doc/INSTALLATION.html]
+
+====1 - Start your selenium proxy server 
+Make sure the honey_do version of <i>user-extensions.js</i> gets loaded.  An example, minimal command line would be:
+  java -jar .\selenium-remote-control-0.9.2\server\selenium-server.jar -userExtensions user-extensions.js
+  
+See also <i>honey-do/bin</i> for other examples.
+
+====2 - Start honey-do/demo/webrick-servlet.rb
+  ruby webrick-servlet.rb    # you don't need to say 'ruby' on win32
+  
+You'll then have a webserver listening at http://localhost:8000
+
+====3 - Run honey-do/Rakefile as
+  honey-do/rake test
+
+This gathers and runs all files ending in <i>_test.rb</i>, and an extended version of Test::Unit::TestCase handles starting and stopping the Selenium driver.
+At the end, it will print to <tt>stdout</tt> a list of tests run, with run times.  A few of the tests print things as part of their illustrative mission.
+
+Run just the tests in a given file at the command line:
+  ruby fast_and_pretty_test.rb    # no need for 'ruby' on win32
+
+Run individual tests or sub-suites at the command line like this:
+  ruby checkbox_test.rb test_check_multiple_independents  
+  ruby checkbox_test.rb test_check_uncheck test_check_multiple_in_group test_check_multiple_independents
+
+====The Demo Page
+<tt>everything.html</tt> is a contrived example form, with all of the possible element types represented (thanks to David Flanagan). 
+There are event handlers to prove that HoneyDo fires them, but there is no Ajax.
+
+====The Servlet
+HoneyDoDemoServlet generates a display page showing whatever form data was submitted, but only for POST requests.  (HoneyDo itself doesn't know or care if a form is sent via GET or POST, however.)
+
+====Changing the Browser
+In <i>functional_testcase/functional_testcase.rb</i>, see the <tt>browser()</tt> method on Test::Unit::TestCase.
+
+  Selenium::SeleniumDriver.new("localhost", 4444, "*firefox", "http://localhost:8000", 60000)
+
+Use <tt>"*iexplore"</tt> for that MS thing.
+
+=Sample Output
+
+  C:\honey-do>rake test
+  (in C:/honey-do)
+  c:/ruby/lib/ruby/gems/1.8/gems/rake-0.8.3/lib/rake/rake_test_loader.rb
+  Loaded suite c:/ruby/lib/ruby/gems/1.8/gems/rake-0.8.3/lib/rake/rake_test_loader
+  Started
+  .....................................................
+  TEST OUTPUT:
+  *** *** TEST_HONEY_DO_TIME *** ***
+  honey_do_input, setting whole form 10 times: 0.608999967575073
+  
+  *** *** TEST_ONE_FIELD_AT_A_TIME_HONEY_DO_TIME *** ***
+  one_field_at_a_time_input, setting whole form 10 times: 3.8289999961853
+  
+  *** *** TEST_SELENIUM_TIME *** ***
+  selenium_input, setting whole form 10 times: 3.53099989891052
+  .
+  .
+  .
+
+  TESTS RUN:
+  1 - test_check_multiple_in_group(TestCheckboxFeatures) - 0.328
+  2 - test_check_multiple_independents(TestCheckboxFeatures) - 0.25
+  .
+  .
+  .
+  18 - test_honey_do_time(TestFastAndPretty) - 0.766
+  19 - test_one_field_at_a_time_honey_do_time(TestFastAndPretty) - 3.938
+  20 - test_selenium_time(TestFastAndPretty) - 3.703
+  .
+  .
+  .
+  53 - test_triple_colon_is_input_delimiter_with_mulitiple_fields(TestTextareaInput) - 0.265
+  54 - test_triple_colon_is_input_delimiter_with_single_field(TestTextareaInput) - 0.25
+  .
+  Finished in 34.797 seconds.
+  
+  54 tests, 131 assertions, 0 failures, 0 errors

data/functional_testcase/functional_testcase.rb

@@ -0,0 +1,99 @@
+# Extend Test::Unit::Testcase
+# Sel. session is started in setup() of first testcase, and stopped in teardown() of last
+require 'test/unit'
+require 'selenium'
+
+module Test::Unit
+  class TestCase
+    @@total_test_count = nil
+    def TestCase.total_test_count
+      @@total_test_count ||= 0
+    end
+
+    def TestCase.add_to_total_test_count(count_to_add)
+      @@total_test_count = total_test_count + count_to_add
+    end
+
+    # command line arguments which could be individual test method names
+    @@args = Array.new(ARGV)   
+    
+    # list of 1 or more test method names to follow a test file name
+    def TestCase.cmd_line_tests
+      @@args.select {|arg| arg =~ /^test_/}
+    end
+
+    # for each TestCase.suite
+    def self.all_test_method_names
+      @all_test_method_names ||= public_instance_methods(true).select {|m| m =~ /^test_/}
+    end
+
+    # gets tests from TestCase.suite or from the command line
+    def self.tests
+      tests = all_test_method_names
+      # intersection of arrays: remove any tests not on the command line
+      return (tests & cmd_line_tests) unless cmd_line_tests.empty?
+      
+      return tests
+    end
+
+    # * collects test method names into suite object
+    # * accumulates total test count from mulitple suites
+    def self.suite
+      suite = TestSuite.new(name)
+      tests.sort.each do |test|
+        catch(:invalid_test) do
+          suite << new(test)
+        end
+      end
+      
+      add_to_total_test_count(suite.tests.size) unless suite.empty?
+      return suite
+    end
+  
+    def start_time()
+      @start_time ||= Time.now()
+    end
+
+    def elapsed()
+      Time.now() - start_time
+    end
+
+    @@browser = nil
+    # <tt>SeleniumDriver</tt> reference
+    def browser
+      @@browser ||= Selenium::SeleniumDriver.new("localhost", 4444, "*firefox", "http://localhost:8000", 60000)
+    end
+    
+    def selenium_driver_started?
+      browser.inspect.include?("@session_id")
+    end
+    
+    # starts <tt>SeleniumDriver</tt> if necessary
+    def setup()
+      browser.start unless selenium_driver_started?
+      start_time()
+    end
+    
+    @@print_buffer = []
+    @@test_names = []
+    # stops <tt>SeleniumDriver</tt> after the last test in the last suite
+    def teardown
+      @@test_names << "#{name} - #{elapsed}"
+
+      if run_count.eql?(TestCase.total_test_count)
+        browser.stop()
+        unless @@print_buffer.empty?
+          puts "\nTEST OUTPUT:"
+          puts @@print_buffer
+        end
+        puts "\nTESTS RUN:"
+        @@test_names.each_with_index {|test_name, i| puts "#{i + 1} - #{test_name}"}
+      end
+    end
+    
+    def run_count
+      @_result.run_count + 1
+    end
+    
+  end
+end