RubyGems - kbaum-webrat - Versions diffs - 0.5.1 - Mend

kbaum-webrat 0.5.1

Files changed (214) hide show

data/.document +4 -0
data/.gitignore +15 -0
data/History.txt +406 -0
data/MIT-LICENSE.txt +19 -0
data/README.rdoc +85 -0
data/Rakefile +186 -0
data/VERSION +1 -0
data/install.rb +1 -0
data/lib/webrat.rb +18 -0
data/lib/webrat/adapters/mechanize.rb +78 -0
data/lib/webrat/adapters/merb.rb +11 -0
data/lib/webrat/adapters/rack.rb +25 -0
data/lib/webrat/adapters/rails.rb +96 -0
data/lib/webrat/adapters/sinatra.rb +9 -0
data/lib/webrat/core.rb +13 -0
data/lib/webrat/core/configuration.rb +96 -0
data/lib/webrat/core/elements/area.rb +31 -0
data/lib/webrat/core/elements/element.rb +33 -0
data/lib/webrat/core/elements/field.rb +487 -0
data/lib/webrat/core/elements/form.rb +103 -0
data/lib/webrat/core/elements/label.rb +31 -0
data/lib/webrat/core/elements/link.rb +93 -0
data/lib/webrat/core/elements/select_option.rb +48 -0
data/lib/webrat/core/locators.rb +20 -0
data/lib/webrat/core/locators/area_locator.rb +38 -0
data/lib/webrat/core/locators/button_locator.rb +54 -0
data/lib/webrat/core/locators/field_by_id_locator.rb +37 -0
data/lib/webrat/core/locators/field_labeled_locator.rb +56 -0
data/lib/webrat/core/locators/field_locator.rb +25 -0
data/lib/webrat/core/locators/field_named_locator.rb +41 -0
data/lib/webrat/core/locators/form_locator.rb +19 -0
data/lib/webrat/core/locators/label_locator.rb +34 -0
data/lib/webrat/core/locators/link_locator.rb +74 -0
data/lib/webrat/core/locators/locator.rb +20 -0
data/lib/webrat/core/locators/select_option_locator.rb +59 -0
data/lib/webrat/core/logging.rb +23 -0
data/lib/webrat/core/matchers.rb +4 -0
data/lib/webrat/core/matchers/have_content.rb +68 -0
data/lib/webrat/core/matchers/have_selector.rb +74 -0
data/lib/webrat/core/matchers/have_tag.rb +21 -0
data/lib/webrat/core/matchers/have_xpath.rb +122 -0
data/lib/webrat/core/methods.rb +64 -0
data/lib/webrat/core/mime.rb +18 -0
data/lib/webrat/core/save_and_open_page.rb +48 -0
data/lib/webrat/core/scope.rb +365 -0
data/lib/webrat/core/session.rb +307 -0
data/lib/webrat/core/xml.rb +72 -0
data/lib/webrat/core_extensions/blank.rb +58 -0
data/lib/webrat/core_extensions/deprecate.rb +8 -0
data/lib/webrat/core_extensions/detect_mapped.rb +12 -0
data/lib/webrat/core_extensions/meta_class.rb +6 -0
data/lib/webrat/core_extensions/nil_to_param.rb +5 -0
data/lib/webrat/core_extensions/tcp_socket.rb +27 -0
data/lib/webrat/integrations/merb.rb +10 -0
data/lib/webrat/integrations/rails.rb +9 -0
data/lib/webrat/integrations/rspec-rails.rb +10 -0
data/lib/webrat/integrations/selenium.rb +11 -0
data/lib/webrat/merb.rb +9 -0
data/lib/webrat/rspec-rails.rb +2 -0
data/lib/webrat/selenium.rb +70 -0
data/lib/webrat/selenium/application_server_factory.rb +40 -0
data/lib/webrat/selenium/application_servers.rb +5 -0
data/lib/webrat/selenium/application_servers/base.rb +46 -0
data/lib/webrat/selenium/application_servers/external.rb +26 -0
data/lib/webrat/selenium/application_servers/merb.rb +50 -0
data/lib/webrat/selenium/application_servers/rails.rb +44 -0
data/lib/webrat/selenium/application_servers/sinatra.rb +37 -0
data/lib/webrat/selenium/location_strategy_javascript/button.js +19 -0
data/lib/webrat/selenium/location_strategy_javascript/label.js +24 -0
data/lib/webrat/selenium/location_strategy_javascript/webrat.js +5 -0
data/lib/webrat/selenium/location_strategy_javascript/webratlink.js +12 -0
data/lib/webrat/selenium/location_strategy_javascript/webratlinkwithin.js +15 -0
data/lib/webrat/selenium/location_strategy_javascript/webratselectwithoption.js +5 -0
data/lib/webrat/selenium/matchers.rb +4 -0
data/lib/webrat/selenium/matchers/have_content.rb +66 -0
data/lib/webrat/selenium/matchers/have_selector.rb +74 -0
data/lib/webrat/selenium/matchers/have_tag.rb +49 -0
data/lib/webrat/selenium/matchers/have_xpath.rb +45 -0
data/lib/webrat/selenium/selenium_extensions.js +6 -0
data/lib/webrat/selenium/selenium_rc_server.rb +86 -0
data/lib/webrat/selenium/selenium_session.rb +250 -0
data/lib/webrat/selenium/silence_stream.rb +18 -0
data/selenium_rc_server.patch +20 -0
data/spec/fakes/test_adapter.rb +37 -0
data/spec/integration/mechanize/Rakefile +7 -0
data/spec/integration/mechanize/config.ru +2 -0
data/spec/integration/mechanize/sample_app.rb +20 -0
data/spec/integration/mechanize/spec/mechanize_spec.rb +22 -0
data/spec/integration/mechanize/spec/spec_helper.rb +27 -0
data/spec/integration/merb/.gitignore +21 -0
data/spec/integration/merb/Rakefile +35 -0
data/spec/integration/merb/app/controllers/application.rb +2 -0
data/spec/integration/merb/app/controllers/exceptions.rb +13 -0
data/spec/integration/merb/app/controllers/testing.rb +27 -0
data/spec/integration/merb/app/views/exceptions/not_acceptable.html.erb +63 -0
data/spec/integration/merb/app/views/exceptions/not_found.html.erb +47 -0
data/spec/integration/merb/app/views/layout/application.html.erb +12 -0
data/spec/integration/merb/app/views/testing/show_form.html.erb +27 -0
data/spec/integration/merb/app/views/testing/upload.html.erb +9 -0
data/spec/integration/merb/config/environments/development.rb +15 -0
data/spec/integration/merb/config/environments/rake.rb +11 -0
data/spec/integration/merb/config/environments/test.rb +14 -0
data/spec/integration/merb/config/init.rb +25 -0
data/spec/integration/merb/config/rack.rb +11 -0
data/spec/integration/merb/config/router.rb +34 -0
data/spec/integration/merb/spec/spec.opts +1 -0
data/spec/integration/merb/spec/spec_helper.rb +26 -0
data/spec/integration/merb/spec/webrat_spec.rb +39 -0
data/spec/integration/merb/tasks/merb.thor/app_script.rb +31 -0
data/spec/integration/merb/tasks/merb.thor/common.rb +64 -0
data/spec/integration/merb/tasks/merb.thor/gem_ext.rb +124 -0
data/spec/integration/merb/tasks/merb.thor/main.thor +150 -0
data/spec/integration/merb/tasks/merb.thor/ops.rb +93 -0
data/spec/integration/merb/tasks/merb.thor/utils.rb +40 -0
data/spec/integration/rack/Rakefile +5 -0
data/spec/integration/rack/app.rb +89 -0
data/spec/integration/rack/test/helper.rb +21 -0
data/spec/integration/rack/test/webrat_rack_test.rb +73 -0
data/spec/integration/rails/.gitignore +3 -0
data/spec/integration/rails/Rakefile +30 -0
data/spec/integration/rails/app/controllers/application.rb +15 -0
data/spec/integration/rails/app/controllers/buttons_controller.rb +7 -0
data/spec/integration/rails/app/controllers/fields_controller.rb +4 -0
data/spec/integration/rails/app/controllers/links_controller.rb +7 -0
data/spec/integration/rails/app/controllers/webrat_controller.rb +43 -0
data/spec/integration/rails/app/helpers/buttons_helper.rb +2 -0
data/spec/integration/rails/app/helpers/fields_helper.rb +2 -0
data/spec/integration/rails/app/helpers/links_helper.rb +2 -0
data/spec/integration/rails/app/views/buttons/show.html.erb +11 -0
data/spec/integration/rails/app/views/fields/show.html.erb +9 -0
data/spec/integration/rails/app/views/links/show.html.erb +5 -0
data/spec/integration/rails/app/views/webrat/before_redirect_form.html.erb +4 -0
data/spec/integration/rails/app/views/webrat/buttons.html.erb +11 -0
data/spec/integration/rails/app/views/webrat/form.html.erb +28 -0
data/spec/integration/rails/config/boot.rb +109 -0
data/spec/integration/rails/config/environment.rb +12 -0
data/spec/integration/rails/config/environments/development.rb +17 -0
data/spec/integration/rails/config/environments/selenium.rb +22 -0
data/spec/integration/rails/config/environments/test.rb +22 -0
data/spec/integration/rails/config/initializers/inflections.rb +10 -0
data/spec/integration/rails/config/initializers/mime_types.rb +5 -0
data/spec/integration/rails/config/initializers/new_rails_defaults.rb +17 -0
data/spec/integration/rails/config/locales/en.yml +5 -0
data/spec/integration/rails/config/routes.rb +18 -0
data/spec/integration/rails/public/404.html +30 -0
data/spec/integration/rails/public/422.html +30 -0
data/spec/integration/rails/public/500.html +33 -0
data/spec/integration/rails/script/about +4 -0
data/spec/integration/rails/script/console +3 -0
data/spec/integration/rails/script/dbconsole +3 -0
data/spec/integration/rails/script/destroy +3 -0
data/spec/integration/rails/script/generate +3 -0
data/spec/integration/rails/script/performance/benchmarker +3 -0
data/spec/integration/rails/script/performance/profiler +3 -0
data/spec/integration/rails/script/performance/request +3 -0
data/spec/integration/rails/script/plugin +3 -0
data/spec/integration/rails/script/process/inspector +3 -0
data/spec/integration/rails/script/process/reaper +3 -0
data/spec/integration/rails/script/process/spawner +3 -0
data/spec/integration/rails/script/runner +3 -0
data/spec/integration/rails/script/server +3 -0
data/spec/integration/rails/test/integration/button_click_test.rb +80 -0
data/spec/integration/rails/test/integration/fill_in_test.rb +24 -0
data/spec/integration/rails/test/integration/link_click_test.rb +27 -0
data/spec/integration/rails/test/integration/webrat_test.rb +97 -0
data/spec/integration/rails/test/test_helper.rb +26 -0
data/spec/integration/sinatra/Rakefile +5 -0
data/spec/integration/sinatra/classic_app.rb +64 -0
data/spec/integration/sinatra/modular_app.rb +16 -0
data/spec/integration/sinatra/test/classic_app_test.rb +37 -0
data/spec/integration/sinatra/test/modular_app_test.rb +18 -0
data/spec/integration/sinatra/test/test_helper.rb +17 -0
data/spec/private/core/configuration_spec.rb +87 -0
data/spec/private/core/field_spec.rb +85 -0
data/spec/private/core/link_spec.rb +24 -0
data/spec/private/core/session_spec.rb +200 -0
data/spec/private/mechanize/mechanize_adapter_spec.rb +73 -0
data/spec/private/nokogiri_spec.rb +77 -0
data/spec/private/rails/attaches_file_spec.rb +81 -0
data/spec/private/rails/rails_adapter_spec.rb +110 -0
data/spec/private/selenium/application_servers/rails_spec.rb +26 -0
data/spec/public/basic_auth_spec.rb +24 -0
data/spec/public/check_spec.rb +191 -0
data/spec/public/choose_spec.rb +118 -0
data/spec/public/click_area_spec.rb +106 -0
data/spec/public/click_button_spec.rb +494 -0
data/spec/public/click_link_spec.rb +511 -0
data/spec/public/fill_in_spec.rb +224 -0
data/spec/public/locators/field_by_xpath_spec.rb +19 -0
data/spec/public/locators/field_labeled_spec.rb +172 -0
data/spec/public/locators/field_with_id_spec.rb +16 -0
data/spec/public/matchers/contain_spec.rb +114 -0
data/spec/public/matchers/have_selector_spec.rb +146 -0
data/spec/public/matchers/have_tag_spec.rb +39 -0
data/spec/public/matchers/have_xpath_spec.rb +136 -0
data/spec/public/reload_spec.rb +10 -0
data/spec/public/save_and_open_spec.rb +70 -0
data/spec/public/select_date_spec.rb +112 -0
data/spec/public/select_datetime_spec.rb +137 -0
data/spec/public/select_spec.rb +455 -0
data/spec/public/select_time_spec.rb +100 -0
data/spec/public/selenium/application_server_factory_spec.rb +49 -0
data/spec/public/selenium/application_servers/external_spec.rb +12 -0
data/spec/public/selenium/selenium_session_spec.rb +37 -0
data/spec/public/set_hidden_field_spec.rb +5 -0
data/spec/public/submit_form_spec.rb +5 -0
data/spec/public/visit_spec.rb +58 -0
data/spec/public/within_spec.rb +177 -0
data/spec/rcov.opts +1 -0
data/spec/spec.opts +2 -0
data/spec/spec_helper.rb +54 -0
data/vendor/selenium-server.jar +0 -0
data/webrat.gemspec +356 -0
metadata +410 -0

data/spec/public/select_time_spec.rb ADDED Viewed

@@ -0,0 +1,100 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+describe "select_time" do
+  it "should send the values for each individual time component" do
+    with_html <<-HTML
+      <html>
+      <form action="/appointments" method="post">
+        <label for="appointment_time">Time</label><br />
+        <select id="appointment_time_4i" name="appointment[time(4i)]">
+          <option value="09">09</option>
+        </select>
+     : <select id="appointment_time_5i" name="appointment[time(5i)]">
+          <option value="30">30</option>
+        </select>
+        <input type="submit" />
+      </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:post).with("/appointments",
+      "appointment" => {"time(4i)" => "09", "time(5i)" => "30"})
+    select_time "9:30AM", :from => "Time"
+    click_button
+  end
+  it "should accept a time object" do
+    with_html <<-HTML
+      <html>
+      <form action="/appointments" method="post">
+        <label for="appointment_time">Time</label><br />
+        <select id="appointment_time_4i" name="appointment[time(4i)]">
+          <option value="09">09</option>
+        </select>
+     : <select id="appointment_time_5i" name="appointment[time(5i)]">
+          <option value="30">30</option>
+        </select>
+        <input type="submit" />
+      </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:post).with("/appointments",
+      "appointment" => {"time(4i)" => "09", "time(5i)" => "30"})
+    select_time Time.parse("9:30AM"), :from => "Time"
+    click_button
+  end
+  it "should work when the label ends in a non word character" do
+    with_html <<-HTML
+      <html>
+      <form action="/appointments" method="post">
+        <label for="appointment_time">Time #</label><br />
+        <select id="appointment_time_4i" name="appointment[time(4i)]">
+          <option value="09">09</option>
+        </select>
+     : <select id="appointment_time_5i" name="appointment[time(5i)]">
+          <option value="30">30</option>
+        </select>
+        <input type="submit" />
+      </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:post).with("/appointments",
+      "appointment" => {"time(4i)" => "09", "time(5i)" => "30"})
+    select_time "9:30AM", :from => "Time #"
+    click_button
+  end
+  it "should work when no label is specified" do
+    with_html <<-HTML
+      <html>
+      <form action="/appointments" method="post">
+        <select id="appointment_time_4i" name="appointment[time(4i)]">
+          <option value="09">09</option>
+        </select>
+     : <select id="appointment_time_5i" name="appointment[time(5i)]">
+          <option value="30">30</option>
+        </select>
+        <input type="submit" />
+      </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:post).with("/appointments",
+      "appointment" => {"time(4i)" => "09", "time(5i)" => "30"})
+    select_time "9:30"
+    click_button
+  end
+  it "should fail if the specified label is not found" do
+    with_html <<-HTML
+      <html>
+      <form method="post" action="/appointments">
+        <select name="month"><option>January</option></select>
+        <input type="submit" />
+      </form>
+      </html>
+    HTML
+    lambda { select_time "9:30", :from => "Time" }.should raise_error(Webrat::NotFoundError)
+  end
+end

data/spec/public/selenium/application_server_factory_spec.rb ADDED Viewed

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+require "webrat/selenium/silence_stream"
+require "webrat/selenium/application_server_factory"
+require "webrat/selenium/application_servers"
+describe Webrat::Selenium::ApplicationServerFactory do
+  it "should require and create a sinatra server in sinatra mode" do
+    server = mock(Webrat::Selenium::ApplicationServers::Sinatra)
+    Webrat.configuration.application_framework = :sinatra
+    Webrat::Selenium::ApplicationServerFactory.should_receive(:require).with("webrat/selenium/application_servers/sinatra")
+    Webrat::Selenium::ApplicationServers::Sinatra.should_receive(:new).and_return(server)
+    Webrat::Selenium::ApplicationServerFactory.app_server_instance.should == server
+  end
+  it "should require and create a merb server in merb mode" do
+    server = mock(Webrat::Selenium::ApplicationServers::Merb)
+    Webrat.configuration.application_framework = :merb
+    Webrat::Selenium::ApplicationServerFactory.should_receive(:require).with("webrat/selenium/application_servers/merb")
+    Webrat::Selenium::ApplicationServers::Merb.should_receive(:new).and_return(server)
+    Webrat::Selenium::ApplicationServerFactory.app_server_instance
+  end
+  it "should require and create a rails server in rails mode" do
+    server = mock(Webrat::Selenium::ApplicationServers::Rails)
+    Webrat.configuration.application_framework = :rails
+    Webrat::Selenium::ApplicationServerFactory.should_receive(:require).with("webrat/selenium/application_servers/rails")
+    Webrat::Selenium::ApplicationServers::Rails.should_receive(:new).and_return(server)
+    Webrat::Selenium::ApplicationServerFactory.app_server_instance
+  end
+  it "should require and create a rails server in external mode" do
+    server = mock(Webrat::Selenium::ApplicationServers::External)
+    Webrat.configuration.application_framework = :external
+    Webrat::Selenium::ApplicationServerFactory.should_receive(:require).with("webrat/selenium/application_servers/external")
+    Webrat::Selenium::ApplicationServers::External.should_receive(:new).and_return(server)
+    Webrat::Selenium::ApplicationServerFactory.app_server_instance
+  end
+  it "should handle unknown servers with an exception in unknown modes" do
+    Webrat.configuration.application_framework = :unknown
+    lambda {
+      Webrat::Selenium::ApplicationServerFactory.app_server_instance
+    }.should raise_error(Webrat::WebratError)
+  end
+end

data/spec/public/selenium/application_servers/external_spec.rb ADDED Viewed

@@ -0,0 +1,12 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+require "webrat/selenium/application_servers/base"
+require "webrat/selenium/application_servers/external"
+describe Webrat::Selenium::ApplicationServers::External do
+  it "should just boot up with no exceptions" do
+    Webrat::Selenium::ApplicationServers::External.new.boot
+  end
+end

data/spec/public/selenium/selenium_session_spec.rb ADDED Viewed

@@ -0,0 +1,37 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+require "webrat/selenium/silence_stream"
+require "webrat/selenium/selenium_session"
+describe Webrat::SeleniumSession do
+  before :each do
+    Webrat.configuration.mode = :selenium
+    @selenium = Webrat::SeleniumSession.new()
+  end
+  it "should throw timeout instead of spec expectionnotmet error" do
+    lambda {
+      @selenium.wait_for(:timeout => 0.0001) do
+        raise ::Spec::Expectations::ExpectationNotMetError
+      end
+    }.should raise_error(Webrat::TimeoutError)
+  end
+  it "should throw timeout instead of selenium command error" do
+    lambda {
+      @selenium.wait_for(:timeout => 0.0001) do
+        raise ::Selenium::CommandError
+      end
+    }.should raise_error(Webrat::TimeoutError)
+  end
+  it "should throw timeout instead of webrat error" do
+    lambda {
+      @selenium.wait_for(:timeout => 0.0001) do
+        raise Webrat::WebratError.new
+      end
+    }.should raise_error(Webrat::TimeoutError)
+  end
+end

data/spec/public/set_hidden_field_spec.rb ADDED Viewed

@@ -0,0 +1,5 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+describe "set_hidden_field" do
+  it "needs specs"
+end

data/spec/public/submit_form_spec.rb ADDED Viewed

@@ -0,0 +1,5 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+describe "submit_form" do
+  it "needs specs"
+end

data/spec/public/visit_spec.rb ADDED Viewed

@@ -0,0 +1,58 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+describe "visit" do
+  before do
+    with_html <<-HTML
+      <html>
+      Hello world
+      </html>
+    HTML
+  end
+  it "should use get" do
+    webrat_session.should_receive(:get).with("/", {})
+    visit("/")
+  end
+  it "should assert valid response" do
+    webrat_session.response_code = 501
+    lambda { visit("/") }.should raise_error(Webrat::PageLoadError)
+  end
+  [200, 300, 400, 499].each do |status|
+    it "should consider the #{status} status code as success" do
+      webrat_session.stub!(:redirect? => false)
+      webrat_session.response_code = status
+      lambda { visit("/") }.should_not raise_error
+    end
+  end
+  it "should require a visit before manipulating page" do
+    lambda { fill_in "foo", :with => "blah" }.should raise_error(Webrat::WebratError)
+  end
+  it "should not follow external redirects" do
+    webrat_session.should_receive(:internal_redirect?).and_return(false)
+    visit("/oldurl")
+    current_url.should == "/oldurl"
+  end
+end
+describe "visit with referer" do
+  before do
+    webrat_session.instance_variable_set(:@current_url, "/old_url")
+    with_html <<-HTML
+      <html>
+      Hello world
+      </html>
+    HTML
+  end
+  it "should use get with referer header" do
+    webrat_session.should_receive(:get).with("/", {}, {"HTTP_REFERER" => "/old_url"})
+    visit("/")
+  end
+end

data/spec/public/within_spec.rb ADDED Viewed

@@ -0,0 +1,177 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+describe "within" do
+  it "should work when nested" do
+    with_html <<-HTML
+      <html>
+      <div>
+        <a href="/page1">Link</a>
+      </div>
+      <div id="container">
+        <div><a href="/page2">Link</a></div>
+      </div>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/page2", {})
+    within "#container" do
+      within "div" do
+        click_link "Link"
+      end
+    end
+  end
+  it "should click links within a scope" do
+    with_html <<-HTML
+      <html>
+      <a href="/page1">Link</a>
+      <div id="container">
+        <a href="/page2">Link</a>
+      </div>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/page2", {})
+    within "#container" do
+      click_link "Link"
+    end
+  end
+  it "should submit forms within a scope" do
+    with_html <<-HTML
+      <html>
+        <form id="form1" action="/form1">
+          <label>Email: <input type="text" name="email" />
+          <input type="submit" value="Add" />
+        </form>
+        <form id="form2" action="/form2">
+          <label>Email: <input type="text" name="email" />
+          <input type="submit" value="Add" />
+        </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form2", "email" => "test@example.com")
+    within "#form2" do
+      fill_in "Email", :with => "test@example.com"
+      click_button
+    end
+  end
+  it "should work when the scope is inside the form" do
+    with_html <<-HTML
+      <html>
+        <form id="form2" action="/form2">
+          <div class="important">
+            <label>Email: <input type="text" class="email2" name="email" /></label>
+          </div>
+          <input type="submit" value="Add" />
+        </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form2", "email" => "test@example.com")
+    within ".important" do
+      fill_in "Email", :with => "test@example.com"
+    end
+    submit_form "form2"
+  end
+  it "should work when the form submission occurs inside a scope" do
+    with_html <<-HTML
+      <html>
+        <body>
+          <div>
+            <form id="form2" action="/form2">
+              <label for="email">Email</label><input id="email" type="text" class="email2" name="email" />
+              <input type="submit" value="Add" />
+            </form>
+          </div>
+        </body>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form2", "email" => "test@example.com")
+    within "form[@action='/form2']" do
+      fill_in "Email", :with => "test@example.com"
+      click_button "Add"
+    end
+  end
+  it "should work when there are multiple forms with the same label text" do
+    with_html <<-HTML
+      <html>
+        <body>
+          <div>
+            <form id="form1" action="/form1">
+              <label for="email1">Email</label><input id="email1" type="text" class="email1" name="email1" />
+              <input type="submit" value="Add" />
+            </form>
+            <form id="form2" action="/form2">
+              <label for="email2">Email</label><input id="email2" type="text" class="email2" name="email2" />
+              <input type="submit" value="Add" />
+            </form>
+          </div>
+        </body>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form2", "email2" => "test@example.com")
+    within "form[@action='/form2']" do
+      fill_in "Email", :with => "test@example.com"
+      click_button "Add"
+    end
+  end
+  it "should not find fields outside of the scope" do
+    with_html <<-HTML
+      <html>
+        <form id="form1" action="/form1">
+          <label for="email">Email</label><input id="email" type="text" name="email" />
+          <input type="submit" value="Add" />
+        </form>
+        <form id="form2" action="/form2">
+          <label for="email">Email</label><input id="email" type="text" name="email" />
+          <input type="submit" value="Add" />
+        </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form2", "email" => "test@example.com")
+    within "#form2" do
+      fill_in "Email", :with => "test@example.com"
+      click_button "Add"
+    end
+  end
+  it "should not find buttons outside of the scope" do
+    with_html <<-HTML
+      <html>
+      <form action="/form1">
+        <input type="submit" value="Add" />
+      </form>
+      <form id="form2" action="/form2">
+      </form>
+      </html>
+    HTML
+    within "#form2" do
+      lambda {
+        click_button
+      }.should raise_error(Webrat::NotFoundError)
+    end
+  end
+  it "should raise a Webrat::NotFounderror error when the scope doesn't exist" do
+    with_html <<-HTML
+      <html>
+      </html>
+    HTML
+    lambda {
+      within "#form2" do
+      end
+    }.should raise_error(Webrat::NotFoundError)
+  end
+end