caius-celerity 0.0.6.10 → 0.0.6.11

data/benchmark/bm_text_input.rb

@@ -0,0 +1,19 @@
+require File.dirname(__FILE__) + "/loader"
+
+browser = create_browser
+browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+
+TESTS = 10000
+res = Benchmark.bmbm do |results|
+  results.report("TextField#set") do
+    TESTS.times { browser.text_field(:id, "new_user_first_name").set("1234567890") }
+  end
+  results.report("TextField#value=") do
+    TESTS.times { browser.text_field(:id, "new_user_first_name").value = "1234567890" }
+  end
+end
+
+puts
+total = res.inject(0.0) { |mem, bm| mem + bm.real }
+puts "total  : " + total.to_s
+puts "average: " + (total/res.size.to_f).to_s

data/benchmark/loader.rb

@@ -0,0 +1,14 @@
+require 'benchmark'
+require File.dirname(__FILE__) + "/../spec/spec_helper"
+
+
+def create_browser
+  if RUBY_PLATFORM =~ /java/
+    browser = Celerity::Browser.new(:log_level => :off)
+  else
+    require 'watir'
+    browser = Watir::IE.new
+  end
+
+  browser
+end

data/celerity.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{celerity}
+  s.version = "0.0.6.11"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jari Bakken", "T. Alexander Lystad", "Knut Johannes Dahle"]
+  s.date = %q{2009-06-26}
+  s.description = %q{Celerity is a JRuby wrapper around HtmlUnit – a headless Java browser with JavaScript support. It provides a simple API for programmatic navigation through web applications. Celerity aims at being API compatible with Watir.}
+  s.email = %q{jari.bakken@finn.no}
+  s.extra_rdoc_files = ["History.txt", "License.txt", "Manifest.txt", "README.txt"]
+  s.files = ["History.txt", "License.txt", "Manifest.txt", "README.txt", "Rakefile", "benchmark/bm_2000_spans.rb", "benchmark/bm_digg.rb", "benchmark/bm_google_images.rb", "benchmark/bm_input_locator.rb", "benchmark/bm_text_input.rb", "benchmark/loader.rb", "celerity.gemspec", "config/hoe.rb", "config/requirements.rb", "lib/celerity.rb", "lib/celerity/browser.rb", "lib/celerity/clickable_element.rb", "lib/celerity/collections.rb", "lib/celerity/container.rb", "lib/celerity/default_viewer.rb", "lib/celerity/disabled_element.rb", "lib/celerity/element.rb", "lib/celerity/element_collection.rb", "lib/celerity/element_locator.rb", "lib/celerity/elements/button.rb", "lib/celerity/elements/file_field.rb", "lib/celerity/elements/form.rb", "lib/celerity/elements/frame.rb", "lib/celerity/elements/image.rb", "lib/celerity/elements/label.rb", "lib/celerity/elements/link.rb", "lib/celerity/elements/meta.rb", "lib/celerity/elements/non_control_elements.rb", "lib/celerity/elements/option.rb", "lib/celerity/elements/radio_check.rb", "lib/celerity/elements/select_list.rb", "lib/celerity/elements/table.rb", "lib/celerity/elements/table_cell.rb", "lib/celerity/elements/table_elements.rb", "lib/celerity/elements/table_row.rb", "lib/celerity/elements/text_field.rb", "lib/celerity/exception.rb", "lib/celerity/htmlunit.rb", "lib/celerity/htmlunit/commons-codec-1.3.jar", "lib/celerity/htmlunit/commons-collections-3.2.1.jar", "lib/celerity/htmlunit/commons-httpclient-3.1.jar", "lib/celerity/htmlunit/commons-io-1.4.jar", "lib/celerity/htmlunit/commons-lang-2.4.jar", "lib/celerity/htmlunit/commons-logging-1.1.1.jar", "lib/celerity/htmlunit/cssparser-0.9.5.jar", "lib/celerity/htmlunit/htmlunit-2.6-SNAPSHOT.jar", "lib/celerity/htmlunit/htmlunit-core-js-2.5.jar", "lib/celerity/htmlunit/nekohtml-1.9.13-20090507.082850-2.jar", "lib/celerity/htmlunit/sac-1.3.jar", "lib/celerity/htmlunit/serializer-2.7.1.jar", "lib/celerity/htmlunit/xalan-2.7.1.jar", "lib/celerity/htmlunit/xercesImpl-2.8.1.jar", "lib/celerity/htmlunit/xml-apis-1.3.04.jar", "lib/celerity/identifier.rb", "lib/celerity/input_element.rb", "lib/celerity/listener.rb", "lib/celerity/resources/no_viewer.png", "lib/celerity/short_inspect.rb", "lib/celerity/util.rb", "lib/celerity/version.rb", "lib/celerity/watir_compatibility.rb", "spec/area_spec.rb", "spec/areas_spec.rb", "spec/browser_authentication_spec.rb", "spec/browser_spec.rb", "spec/button_spec.rb", "spec/buttons_spec.rb", "spec/checkbox_spec.rb", "spec/checkboxes_spec.rb", "spec/clickable_element_spec.rb", "spec/dd_spec.rb", "spec/dds_spec.rb", "spec/default_viewer_spec.rb", "spec/div_spec.rb", "spec/divs_spec.rb", "spec/dl_spec.rb", "spec/dls_spec.rb", "spec/dt_spec.rb", "spec/dts_spec.rb", "spec/element_spec.rb", "spec/em_spec.rb", "spec/ems_spec.rb", "spec/filefield_spec.rb", "spec/filefields_spec.rb", "spec/form_spec.rb", "spec/forms_spec.rb", "spec/frame_spec.rb", "spec/frames_spec.rb", "spec/hidden_spec.rb", "spec/hiddens_spec.rb", "spec/hn_spec.rb", "spec/hns_spec.rb", "spec/html/2000_spans.html", "spec/html/bug_duplicate_attributes.html", "spec/html/bug_javascript_001.html", "spec/html/definition_lists.html", "spec/html/euc-jp_text.html", "spec/html/forms_with_input_elements.html", "spec/html/frame_1.html", "spec/html/frame_2.html", "spec/html/frames.html", "spec/html/iframes.html", "spec/html/images.html", "spec/html/images/1.gif", "spec/html/images/2.gif", "spec/html/images/3.gif", "spec/html/images/button.jpg", "spec/html/images/circle.jpg", "spec/html/images/map.gif", "spec/html/images/map2.gif", "spec/html/images/minus.gif", "spec/html/images/originaltriangle.jpg", "spec/html/images/plus.gif", "spec/html/images/square.jpg", "spec/html/images/triangle.jpg", "spec/html/iso-2022-jp_text.html", "spec/html/jquery.html", "spec/html/latin1_text.html", "spec/html/multiple_ids.html", "spec/html/non_control_elements.html", "spec/html/right_click.html", "spec/html/shift_jis_text.html", "spec/html/tables.html", "spec/html/timeout.html", "spec/html/tiny_mce.html", "spec/html/utf8_text.html", "spec/htmlunit_spec.rb", "spec/image_spec.rb", "spec/images_spec.rb", "spec/index_offset_spec.rb", "spec/label_spec.rb", "spec/labels_spec.rb", "spec/li_spec.rb", "spec/link_spec.rb", "spec/links_spec.rb", "spec/lis_spec.rb", "spec/listener_spec.rb", "spec/map_spec.rb", "spec/maps_spec.rb", "spec/meta_spec.rb", "spec/metas_spec.rb", "spec/ol_spec.rb", "spec/ols_spec.rb", "spec/option_spec.rb", "spec/p_spec.rb", "spec/pre_spec.rb", "spec/pres_spec.rb", "spec/ps_spec.rb", "spec/radio_spec.rb", "spec/radios_spec.rb", "spec/select_list_spec.rb", "spec/select_lists_spec.rb", "spec/span_spec.rb", "spec/spans_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "spec/strong_spec.rb", "spec/strongs_spec.rb", "spec/table_bodies_spec.rb", "spec/table_body_spec.rb", "spec/table_cell_spec.rb", "spec/table_cells_spec.rb", "spec/table_footer_spec.rb", "spec/table_footers_spec.rb", "spec/table_header_spec.rb", "spec/table_headers_spec.rb", "spec/table_row_spec.rb", "spec/table_rows_spec.rb", "spec/table_spec.rb", "spec/tables_spec.rb", "spec/text_field_spec.rb", "spec/text_fields_spec.rb", "spec/ul_spec.rb", "spec/uls_spec.rb", "spec/watir_compatibility_spec.rb", "support/spec_server.rb", "tasks/benchmark.rake", "tasks/deployment.rake", "tasks/environment.rake", "tasks/fix.rake", "tasks/jar.rake", "tasks/rdoc.rake", "tasks/rspec.rake", "tasks/simple_ci.rake", "tasks/snapshot.rake", "tasks/specserver.rake", "tasks/website.rake", "tasks/yard.rake", "website/benchmarks.html", "website/css/color.css", "website/css/hacks.css", "website/css/layout.css", "website/css/screen.css", "website/css/textmate.css", "website/css/typography.css", "website/gfx/body_bg.gif", "website/gfx/button_bg.jpg", "website/gfx/header_bg.jpg", "website/gfx/header_left.jpg", "website/gfx/header_right.jpg", "website/gfx/nav_bg.jpg", "website/index.html", "website/yard/Celerity.html", "website/yard/Celerity/Area.html", "website/yard/Celerity/Areas.html", "website/yard/Celerity/Browser.html", "website/yard/Celerity/Button.html", "website/yard/Celerity/Buttons.html", "website/yard/Celerity/CheckBox.html", "website/yard/Celerity/CheckBoxes.html", "website/yard/Celerity/ClickableElement.html", "website/yard/Celerity/Container.html", "website/yard/Celerity/Dd.html", "website/yard/Celerity/Dds.html", "website/yard/Celerity/DefaultViewer.html", "website/yard/Celerity/DisabledElement.html", "website/yard/Celerity/Div.html", "website/yard/Celerity/Divs.html", "website/yard/Celerity/Dl.html", "website/yard/Celerity/Dls.html", "website/yard/Celerity/Dt.html", "website/yard/Celerity/Dts.html", "website/yard/Celerity/Element.html", "website/yard/Celerity/ElementCollection.html", "website/yard/Celerity/ElementLocator.html", "website/yard/Celerity/Em.html", "website/yard/Celerity/Ems.html", "website/yard/Celerity/Exception.html", "website/yard/Celerity/Exception/CelerityException.html", "website/yard/Celerity/Exception/MissingWayOfFindingObjectException.html", "website/yard/Celerity/Exception/NavigationException.html", "website/yard/Celerity/Exception/NoValueFoundException.html", "website/yard/Celerity/Exception/ObjectDisabledException.html", "website/yard/Celerity/Exception/ObjectReadOnlyException.html", "website/yard/Celerity/Exception/UnexpectedPageException.html", "website/yard/Celerity/Exception/UnknownCellException.html", "website/yard/Celerity/Exception/UnknownFormException.html", "website/yard/Celerity/Exception/UnknownFrameException.html", "website/yard/Celerity/Exception/UnknownObjectException.html", "website/yard/Celerity/Exception/UnknownRowException.html", "website/yard/Celerity/FileField.html", "website/yard/Celerity/FileFields.html", "website/yard/Celerity/Form.html", "website/yard/Celerity/Forms.html", "website/yard/Celerity/Frame.html", "website/yard/Celerity/Frames.html", "website/yard/Celerity/H1.html", "website/yard/Celerity/H1s.html", "website/yard/Celerity/H2.html", "website/yard/Celerity/H2s.html", "website/yard/Celerity/H3.html", "website/yard/Celerity/H3s.html", "website/yard/Celerity/H4.html", "website/yard/Celerity/H4s.html", "website/yard/Celerity/H5.html", "website/yard/Celerity/H5s.html", "website/yard/Celerity/H6.html", "website/yard/Celerity/H6s.html", "website/yard/Celerity/Hidden.html", "website/yard/Celerity/Hiddens.html", "website/yard/Celerity/Image.html", "website/yard/Celerity/Images.html", "website/yard/Celerity/InputElement.html", "website/yard/Celerity/Label.html", "website/yard/Celerity/Labels.html", "website/yard/Celerity/Li.html", "website/yard/Celerity/Link.html", "website/yard/Celerity/Links.html", "website/yard/Celerity/Lis.html", "website/yard/Celerity/Listener.html", "website/yard/Celerity/Map.html", "website/yard/Celerity/Maps.html", "website/yard/Celerity/Meta.html", "website/yard/Celerity/Metas.html", "website/yard/Celerity/MethodGenerator.html", "website/yard/Celerity/NonControlElement.html", "website/yard/Celerity/Ol.html", "website/yard/Celerity/Ols.html", "website/yard/Celerity/Option.html", "website/yard/Celerity/Options.html", "website/yard/Celerity/P.html", "website/yard/Celerity/Pre.html", "website/yard/Celerity/Pres.html", "website/yard/Celerity/Ps.html", "website/yard/Celerity/Radio.html", "website/yard/Celerity/RadioCheckCommon.html", "website/yard/Celerity/Radios.html", "website/yard/Celerity/SelectList.html", "website/yard/Celerity/SelectLists.html", "website/yard/Celerity/ShortInspect.html", "website/yard/Celerity/Span.html", "website/yard/Celerity/Spans.html", "website/yard/Celerity/Strong.html", "website/yard/Celerity/Strongs.html", "website/yard/Celerity/Table.html", "website/yard/Celerity/TableBodies.html", "website/yard/Celerity/TableBody.html", "website/yard/Celerity/TableCell.html", "website/yard/Celerity/TableCells.html", "website/yard/Celerity/TableElement.html", "website/yard/Celerity/TableFooter.html", "website/yard/Celerity/TableFooters.html", "website/yard/Celerity/TableHeader.html", "website/yard/Celerity/TableHeaders.html", "website/yard/Celerity/TableRow.html", "website/yard/Celerity/TableRows.html", "website/yard/Celerity/Tables.html", "website/yard/Celerity/TextField.html", "website/yard/Celerity/TextFields.html", "website/yard/Celerity/Th.html", "website/yard/Celerity/Ul.html", "website/yard/Celerity/Uls.html", "website/yard/Celerity/Util.html", "website/yard/Celerity/VERSION.html", "website/yard/HtmlUnit.html", "website/yard/HtmlUnit/Html.html", "website/yard/HtmlUnit/Util.html", "website/yard/Java/ComGargoylesoftwareHtmlunitHtml/HtmlPage.html", "website/yard/Java/JavaLang/Iterable.html", "website/yard/Java/OrgW3cDom/NamedNodeMap.html", "website/yard/README.txt.html", "website/yard/String.html", "website/yard/all-files.html", "website/yard/all-methods.html", "website/yard/all-namespaces.html", "website/yard/app.js", "website/yard/index.html", "website/yard/jquery.js", "website/yard/style.css", "website/yard/syntax_highlight.css"]
+  s.homepage = %q{http://celerity.rubyforge.org}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{celerity}
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{Celerity is a JRuby library for easy and fast functional test automation for web applications}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<hoe>, [">= 2.0.0"])
+    else
+      s.add_dependency(%q<hoe>, [">= 2.0.0"])
+    end
+  else
+    s.add_dependency(%q<hoe>, [">= 2.0.0"])
+  end
+end

data/config/hoe.rb

@@ -0,0 +1,78 @@
+require 'celerity/version'
+
+AUTHORS            = ["Jari Bakken", "T. Alexander Lystad", "Knut Johannes Dahle"]
+EMAIL              = "jari.bakken@finn.no"
+DESCRIPTION        = "Celerity is a JRuby wrapper around HtmlUnit – a headless Java browser with JavaScript support. It provides a simple API for programmatic navigation through web applications. Celerity aims at being API compatible with Watir."
+SUMMARY            = "Celerity is a JRuby library for easy and fast functional test automation for web applications"
+GEM_NAME           = 'celerity'
+RUBYFORGE_PROJECT  = 'celerity'
+HOMEPATH           = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH      = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+@config_file       = "~/.rubyforge/user-config.yml"
+@config            = nil
+RUBYFORGE_USERNAME = "unknown"
+
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil
+# UNCOMMENT IF REQUIRED:
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = Celerity::VERSION::STRING
+
+class Hoe
+  def extra_deps
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' }
+    @extra_deps
+  end
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec(GEM_NAME) do |p|
+  p.version = VERS
+  p.author = AUTHORS
+  p.email = EMAIL
+  p.description = DESCRIPTION
+  p.summary = SUMMARY
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store', 'classes']  #An array of file patterns to delete on clean.
+
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+
+end
+
+CHANGES = $hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+$hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+$hoe.rsync_args = '-av --delete --ignore-errors'
+
+namespace :gem do
+  desc "create a gemspec file"
+  task :make_spec do
+    file = "#{GEM_NAME.downcase}.gemspec"
+    File.open(file, "w") do |file|
+      file.puts $hoe.spec.to_ruby
+    end
+  end
+end

data/config/requirements.rb

@@ -0,0 +1,9 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe].each do |req_gem|
+    require req_gem
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))

data/lib/celerity/version.rb

@@ -3,7 +3,7 @@ module Celerity #:nodoc:
     MAJOR = 0
     MINOR = 0
     TINY  = 6
-    PATCH = 10 # Set to nil for official release
+    PATCH = 11 # Set to nil for official release
 
     STRING = [MAJOR, MINOR, TINY, PATCH].compact.join('.')
   end

data/spec/area_spec.rb

@@ -0,0 +1,97 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Area" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/images.html")
+  end
+
+  # Exists method
+  describe "#exist?" do
+    it "returns true if the area exists" do
+      @browser.area(:id, "NCE").should exist
+      @browser.area(:id, /NCE/).should exist
+      @browser.area(:name, "NCE").should exist
+      @browser.area(:name, /NCE/).should exist
+      @browser.area(:title, "Tables").should exist
+      @browser.area(:title, /Tables/).should exist
+      @browser.area(:url, "tables.html").should exist
+      @browser.area(:url, /tables/).should exist
+      @browser.area(:index, 1).should exist
+      @browser.area(:xpath, "//area[@id='NCE']").should exist
+    end
+
+    it "returns true if the element exists (default how = :id)" do
+      @browser.area("NCE").should exist
+    end
+
+    it "returns false if the area doesn't exist" do
+      @browser.area(:id, "no_such_id").should_not exist
+      @browser.area(:id, /no_such_id/).should_not exist
+      @browser.area(:name, "no_such_id").should_not exist
+      @browser.area(:name, /no_such_id/).should_not exist
+      @browser.area(:title, "no_such_title").should_not exist
+      @browser.area(:title, /no_such_title/).should_not exist
+      @browser.area(:url, "no_such_href").should_not exist
+      @browser.area(:url, /no_such_href/).should_not exist
+      @browser.area(:index, 1337).should_not exist
+      @browser.area(:xpath, "//area[@id='no_such_id']").should_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { @browser.area(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { @browser.area(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#id" do
+    it "returns the id attribute" do
+      @browser.area(:index, 1).id.should == "NCE"
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      @browser.area(:index, 3).id.should == ''
+    end
+
+    it "raises UnknownObjectException if the area doesn't exist" do
+      lambda { @browser.area(:id, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda { @browser.area(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+
+  end
+
+  describe "#name" do
+    it "returns the name attribute" do
+      @browser.area(:index, 1).name.should == "NCE"
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      @browser.area(:index, 3).name.should == ''
+    end
+
+    it "raises UnknownObjectException if the area doesn't exist" do
+      lambda { @browser.area(:id, "no_such_id").name }.should raise_error(UnknownObjectException)
+      lambda { @browser.area(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      @browser.area(:index, 1).should respond_to(:id)
+      @browser.area(:index, 1).should respond_to(:name)
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end

data/spec/areas_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Areas" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/images.html")
+  end
+
+  describe "#length" do
+    it "returns the number of areas" do
+      @browser.areas.length.should == 3
+    end
+  end
+
+  describe "#[]" do
+    it "returns the area at the given index" do
+      @browser.areas[1].id.should == "NCE"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through areas correctly" do
+      @browser.areas.each_with_index do |a, index|
+        a.name.should == @browser.area(:index, index+1).name
+        a.id.should == @browser.area(:index, index+1).id
+        a.value.should == @browser.area(:index, index+1).value
+      end
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end
+

data/spec/browser_authentication_spec.rb

@@ -0,0 +1,20 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Browser" do
+
+  before :all do
+    @browser = Browser.new(:log_level => :off)
+  end
+
+  describe "#credentials=" do
+    it "sets the basic authentication credentials" do
+      @browser.goto(TEST_HOST + "/authentication/")
+      @browser.text.should_not include("Index of /authentication/")
+
+      @browser.credentials = "foo:bar"
+
+      @browser.goto(TEST_HOST + "/authentication/")
+      @browser.text.should include("Index of /authentication/")
+    end
+  end
+end

data/spec/browser_spec.rb

@@ -0,0 +1,537 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Browser" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  describe "#new" do
+    it "raises TypeError if argument is not a Hash" do
+      lambda { Browser.new(:foo) }.should raise_error(TypeError)
+    end
+
+    it "raises ArgumentError if given bad arguments for :render key" do
+      lambda { Browser.new(:render => :foo) }.should raise_error(ArgumentError)
+    end
+
+    it "raises ArgumentError if given bad arguments for :browser key" do
+      lambda { Browser.new(:browser => 'foo') }.should raise_error(ArgumentError)
+    end
+
+    it "raises ArgumentError if given an unknown option" do
+      lambda { Browser.new(:foo => 1) }.should raise_error(ArgumentError)
+    end
+
+    it "should hold the init options" do
+      @browser.options.should == BROWSER_OPTIONS
+    end
+
+    it "should use the specified proxy" do
+      received = false
+      blk      = lambda { received = true }
+      s = WEBrick::HTTPProxyServer.new(:Port => 2001, :ProxyContentHandler => blk)
+      Thread.new { s.start }
+
+      b = Browser.new(:proxy => "localhost:2001")
+      b.goto(TEST_HOST)
+      s.shutdown
+
+      received.should be_true
+    end
+
+    it "should use the specified user agent" do
+      b = Browser.new(BROWSER_OPTIONS.merge(:user_agent => "Celerity"))
+      b.goto(TEST_HOST + "/header_echo")
+      b.text.should include(%q["user-agent"=>["Celerity"]])
+    end
+
+  end
+
+  describe "#exists?" do
+    it "returns true if we are at a page" do
+      @browser.should_not exist
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.should exist
+    end
+
+    it "returns false after IE#close" do
+      @browser.close
+      @browser.should_not exist
+    end
+  end
+
+  describe "#html" do
+    it "returns the html of the page" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.html.should == File.read(File.dirname(__FILE__) + "/html/non_control_elements.html")
+    end
+
+    %w(shift_jis iso-2022-jp euc-jp).each do |charset|
+      it "returns decoded #{charset.upcase} when :charset specified" do
+        browser = Browser.new(:charset => charset.upcase)
+        browser.goto(HTML_DIR + "/#{charset}_text.html")
+        browser.html.should =~ /本日は晴天なり。/ # Browser#text is automagically transcoded into the right charset, but Browser#html isn't.
+      end
+    end
+  end
+
+  describe "#title" do
+    it "returns the current page title" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.title.should == "Non-control elements"
+    end
+  end
+
+  describe "#status" do
+    it "returns the current value of window.status" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.execute_script "window.status = 'All done!';"
+      @browser.status.should == "All done!"
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the page" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.text.should include("Dubito, ergo cogito, ergo sum.")
+    end
+
+    it "returns the text also if the content-type is text/plain" do
+      # more specs for text/plain? what happens if we call other methods?
+      @browser.goto(TEST_HOST + "/plain_text")
+      @browser.text.strip.should == 'This is text/plain'
+    end
+
+# disabled for CI - need fix from HtmlUnit
+#     it "returns a text representation including newlines" do
+#       @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+#       @browser.text.should == <<-TEXT
+# Forms with input elementsUser administration
+#
+# Add user
+#
+# Personal informationFirst name
+#
+# Last name
+#
+# Email address
+#
+# Country  Denmark Norway Sweden United Kingdom USA
+#
+# Occupation
+#
+# Species
+#
+# Personal code
+#
+# Languages  Danish English Norwegian Swedish
+#
+# Portrait
+#
+# Dental records   Login informationUsername (max 20 characters)  0
+#
+# Password
+#
+# Role  Administrator Moderator Regular user  Interests Books  Bowling  Cars  Dancing  Dentistry   Food  Preferences
+#
+# Do you want to recieve our newslettter?
+#
+#  Yes  No  Certainly  Absolutely  Nah  Actions  Button 2
+#
+# Delete user
+#
+# Username  Username 1 Username 2 Username 3
+#
+# Comment Default comment.
+# TEXT
+#     end
+  end
+
+  describe "#url" do
+    it "returns the current url" do
+      @browser.goto(TEST_HOST + "/non_control_elements.html")
+      @browser.url.should == TEST_HOST + "/non_control_elements.html"
+    end
+  end
+
+  describe "#document" do
+    it "returns the underlying object" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      if RUBY_PLATFORM =~ /java/
+        @browser.document.should be_instance_of(Java::ComGargoylesoftwareHtmlunitHtml::HtmlHtml)
+      else
+        @browser.document.should be_instance_of(WIN32OLE)
+      end
+    end
+  end
+
+  describe "#response_headers" do
+    it "returns the response headers (as a hash)" do
+      @browser.goto(TEST_HOST + "/non_control_elements.html")
+      @browser.response_headers.should be_kind_of(Hash)
+      @browser.response_headers['Date'].should be_kind_of(String)
+      @browser.response_headers['Content-Type'].should be_kind_of(String)
+    end
+  end
+
+  describe "#content_type" do
+    it "returns the content type" do
+      @browser.goto(TEST_HOST + "/non_control_elements.html")
+      @browser.content_type.should =~ /\w+\/\w+/
+    end
+  end
+
+
+  describe "#io" do
+    it "returns the io object of the content" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.io.should be_kind_of(IO)
+      @browser.io.read.should == File.read("#{File.dirname(__FILE__)}/html/non_control_elements.html")
+    end
+  end
+
+
+  # Manipulation methods
+  describe ".start" do
+    it "goes to the given URL and return an instance of itself" do
+      @browser = Browser.start(HTML_DIR + "/non_control_elements.html")
+      @browser.should be_instance_of(Browser)
+      @browser.title.should == "Non-control elements"
+    end
+  end
+
+  describe "#goto" do
+    it "adds http:// to URLs with no protocol specified" do
+      url = TEST_HOST[%r{http://(.*)}, 1]
+      url.should_not be_nil
+      @browser.goto(url)
+      @browser.url.should =~ %r[http://#{url}/?]
+    end
+
+    it "goes to the given url without raising errors" do
+      lambda { @browser.goto(HTML_DIR + "/non_control_elements.html") }.should_not raise_error
+    end
+
+    it "raises UnexpectedPageException if the content type is not understood" do
+      lambda { @browser.goto(TEST_HOST + "/octet_stream") }.should raise_error(UnexpectedPageException)
+    end
+  end
+
+  describe "#refresh" do
+    it "refreshes the page" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.span(:name, 'footer').click
+      @browser.span(:name, 'footer').text.should include('Javascript')
+      @browser.refresh
+      @browser.span(:name, 'footer').text.should_not include('Javascript')
+    end
+  end
+
+  describe "#execute_script" do
+    it "executes the given JavaScript on the current page" do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      @browser.pre(:id, 'rspec').text.should_not == "javascript text"
+      @browser.execute_script("document.getElementById('rspec').innerHTML = 'javascript text'")
+      @browser.pre(:id, 'rspec').text.should == "javascript text"
+    end
+  end
+
+  describe "#cookies" do
+    it "returns set cookies as a Ruby hash" do
+      cookies = @browser.cookies
+      cookies.should be_instance_of(Hash)
+      cookies.should be_empty
+
+      @browser.goto(TEST_HOST + "/set_cookie")
+
+      cookies = @browser.cookies
+      cookies.size.should == 1
+      cookies['localhost']['monster'].should == "/"
+    end
+  end
+
+  describe "#clear_cookies" do
+    it "clears all cookies" do
+      @browser.cookies.should be_empty
+      @browser.goto(TEST_HOST + "/set_cookie")
+      @browser.cookies.size.should == 1
+      @browser.clear_cookies
+      @browser.cookies.should be_empty
+    end
+  end
+
+  describe "add_cookie" do
+    it "adds a cookie with the given domain, name and value" do
+      @browser.add_cookie("example.com", "foo", "bar")
+      cookies = @browser.cookies
+      cookies.should be_instance_of(Hash)
+      cookies.should have_key('example.com')
+      cookies['example.com']['foo'].should == 'bar'
+
+      @browser.clear_cookies
+    end
+
+    it "adds a cookie with the specified options" do
+      @browser.add_cookie("example.com", "foo", "bar", :path => "/foobar", :max_age => 1000)
+      cookies = @browser.cookies
+      cookies.should be_instance_of(Hash)
+      cookies['example.com']['foo'].should == 'bar'
+    end
+  end
+
+  describe "remove_cookie" do
+    it "removes the cookie for the given domain and name" do
+      @browser.goto(TEST_HOST + "/set_cookie")
+      @browser.remove_cookie("localhost", "monster")
+      @browser.cookies.should be_empty
+    end
+
+    it "raises an error if no such cookie exists" do
+      lambda { @browser.remove_cookie("bogus.com", "bar") }.should raise_error
+    end
+  end
+
+  describe "#back" do
+    it "goes to the previous page" do
+      @browser.goto(TEST_HOST + "/non_control_elements.html")
+      orig_url = @browser.url
+      @browser.goto(TEST_HOST + "/tables.html")
+      new_url = @browser.url
+      orig_url.should_not == new_url
+      @browser.back
+      orig_url.should == @browser.url
+    end
+  end
+
+  describe "#wait" do
+    it "should wait for javascript timers to finish" do
+      alerts = 0
+      @browser.add_listener(:alert) { alerts += 1 }
+      @browser.goto(HTML_DIR + "/timeout.html")
+      @browser.div(:id, 'alert').click
+      @browser.wait.should be_true
+      alerts.should == 1
+    end
+  end
+
+  describe "#wait_while" do
+    it "waits until the specified condition becomes false" do
+      @browser.goto(HTML_DIR + "/timeout.html")
+      @browser.div(:id, "change").click
+      @browser.wait_while { @browser.contains_text("Trigger change") }
+      @browser.div(:id, "change").text.should == "all done"
+    end
+  end
+
+  describe "#wait_until" do
+    it "waits until the condition becomes true" do
+      @browser.goto(HTML_DIR + "/timeout.html")
+      @browser.div(:id, "change").click
+      @browser.wait_until { @browser.contains_text("all done") }
+    end
+  end
+
+  # Other
+  describe "#contains_text" do
+    before :each do
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+    end
+
+    it "raises ArgumentError when called with no arguments" do
+      lambda { @browser.contains_text }.should raise_error(ArgumentError)
+    end
+
+    it "raises TypeError when called with wrong arguments" do
+      lambda { @browser.contains_text(nil) }.should raise_error(TypeError)
+      lambda { @browser.contains_text(42) }.should raise_error(TypeError)
+    end
+
+    it "returns the index if the given text exists" do
+        @browser.contains_text('Dubito, ergo cogito, ergo sum.').should be_instance_of(Fixnum)
+        @browser.contains_text(/Dubito.*sum./).should_not be_nil
+    end
+
+    it "returns nil if the text doesn't exist" do
+      @browser.contains_text('no_such_text').should be_nil
+      @browser.contains_text(/no_such_text/).should be_nil
+    end
+
+    it "does not raise error on a blank page" do
+      @browser = Browser.new(BROWSER_OPTIONS)
+      lambda { @browser.contains_text('') }.should_not raise_error
+    end
+  end
+
+  describe "#element_by_xpath" do
+    before :each do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+    end
+
+    it "finds submit buttons matching the given xpath" do
+      e = @browser.element_by_xpath("//input[@type='submit']")
+      e.should exist
+    end
+
+    it "finds reset buttons matching the given xpath" do
+      e = @browser.element_by_xpath("//input[@type='reset']")
+      e.should exist
+    end
+
+    it "finds image buttons matching the given xpath" do
+      e = @browser.element_by_xpath("//input[@type='image']")
+      e.should exist
+    end
+
+    it "finds the element matching the given xpath" do
+      e = @browser.element_by_xpath("//input[@type='password']")
+      e.should exist
+    end
+
+    it "will not find elements that doesn't exist" do
+      e = @browser.element_by_xpath("//input[@type='foobar']")
+      e.should_not exist
+      lambda { e.set('foo') }.should raise_error(UnknownObjectException)
+    end
+
+    it "returns usable elements even though they're not supported" do
+      el = @browser.element_by_xpath("//link")
+      el.should be_instance_of(Celerity::Element)
+      el.rel.should == "stylesheet"
+    end
+  end
+
+  describe "#elements_by_xpath" do
+    before :each do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+    end
+
+    it "returns an Array of matching elements" do
+      objects = @browser.elements_by_xpath("//*[@type='text']")
+      objects.size.should == 6
+    end
+
+    it "returns an empty Array if there are no matching elements" do
+      objects = @browser.elements_by_xpath("//*[@type='foobar']")
+      objects.size.should == 0
+    end
+  end
+
+  describe "#add_checker" do
+    it "raises ArgumentError when not given any arguments" do
+      lambda { @browser.add_checker }.should raise_error(ArgumentError)
+    end
+
+    it "runs the given proc on each page load" do
+      output = ''
+      proc = Proc.new { |ie| output << ie.text }
+      @browser.add_checker(proc)
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      output.should include('Dubito, ergo cogito, ergo sum')
+    end
+
+    it "runs the given block on each page load" do
+      output = ''
+      @browser.add_checker { |ie| output << ie.text }
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      output.should include('Dubito, ergo cogito, ergo sum')
+    end
+  end
+
+  describe "#disable_checker" do
+    it "removes a previously added checker" do
+      output = ''
+      checker = lambda { |ie| output << ie.text }
+
+      @browser.add_checker(checker)
+      @browser.goto(HTML_DIR + "/non_control_elements.html")
+      output.should include('Dubito, ergo cogito, ergo sum')
+
+      @browser.disable_checker(checker)
+      @browser.goto(HTML_DIR + "/definition_lists.html")
+      output.should_not include('definition_lists')
+    end
+  end
+
+  describe "#focused_element" do
+    it "returns the element that currently has the focus" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+      @browser.focused_element.id.should == "new_user_first_name"
+    end
+  end
+
+  describe "#status_code" do
+    it "returns the status code of the last request" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+      @browser.status_code.should == 200
+
+      @browser.goto(TEST_HOST + "/doesnt_exist")
+      @browser.status_code.should == 404
+    end
+  end
+
+  describe "#status_code_exceptions" do
+    it "raises status code exceptions if set to true" do
+      @browser.status_code_exceptions = true
+      lambda do
+        @browser.goto(TEST_HOST + "/doesnt_exist")
+      end.should raise_error(NavigationException)
+    end
+  end
+
+  describe "#javascript_exceptions" do
+    it "raises javascript exceptions if set to true" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+      @browser.javascript_exceptions = true
+      lambda do
+        @browser.execute_script("no_such_function()")
+      end.should raise_error
+    end
+  end
+
+  describe "#add_listener" do
+    it "should click OK for confirm() calls" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+      @browser.add_listener(:confirm) {  }
+      @browser.execute_script("confirm()").should == true
+    end
+  end
+  
+  describe "#remove_listener" do
+    it "should remove the listener" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+      @browser.add_listener(:confirm) {  }
+      @browser.remove_listener(:confirm) {  }
+      @browser.execute_script("confirm()").should != true
+    end
+  end
+
+  describe "#confirm" do
+    it "clicks 'OK' for a confirm() call" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+
+      @browser.confirm(true) do
+        @browser.execute_script('confirm()').should be_true
+      end
+    end
+
+    it "clicks 'cancel' for a confirm() call" do
+      @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+
+      @browser.confirm(false) do
+        @browser.execute_script('confirm()').should be_false
+      end
+    end
+  end
+
+  it "raises UnknownObjectException when trying to access DOM elements on plain/text-page" do
+    @browser.goto(TEST_HOST + "/plain_text")
+    lambda { @browser.div(:id, 'foo').id }.should raise_error(UnknownObjectException)
+  end
+
+
+  after :all do
+    @browser.close
+  end
+
+end