RubyGems - indirect-webrat - Versions diffs - 0.7.4 - Mend

indirect-webrat 0.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (218) hide show

data/.document +4 -0
data/.gitignore +21 -0
data/Gemfile +14 -0
data/History.txt +470 -0
data/MIT-LICENSE.txt +19 -0
data/README.rdoc +85 -0
data/Rakefile +143 -0
data/Thorfile +118 -0
data/install.rb +1 -0
data/lib/webrat.rb +18 -0
data/lib/webrat/adapters/mechanize.rb +94 -0
data/lib/webrat/adapters/merb.rb +11 -0
data/lib/webrat/adapters/rack.rb +30 -0
data/lib/webrat/adapters/rails.rb +77 -0
data/lib/webrat/adapters/sinatra.rb +9 -0
data/lib/webrat/core.rb +13 -0
data/lib/webrat/core/configuration.rb +114 -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 +438 -0
data/lib/webrat/core/elements/form.rb +127 -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 +82 -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 +85 -0
data/lib/webrat/core/matchers/have_tag.rb +21 -0
data/lib/webrat/core/matchers/have_xpath.rb +124 -0
data/lib/webrat/core/methods.rb +73 -0
data/lib/webrat/core/mime.rb +18 -0
data/lib/webrat/core/save_and_open_page.rb +28 -0
data/lib/webrat/core/scope.rb +362 -0
data/lib/webrat/core/session.rb +318 -0
data/lib/webrat/core/xml.rb +44 -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_query_string.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/rack.rb +9 -0
data/lib/webrat/integrations/rails.rb +25 -0
data/lib/webrat/integrations/rspec-rails.rb +11 -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 +43 -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/rack.rb +51 -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 +48 -0
data/lib/webrat/selenium/location_strategy_javascript/webrat.js +6 -0
data/lib/webrat/selenium/location_strategy_javascript/webratlink.js +32 -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 +78 -0
data/lib/webrat/selenium/matchers/have_selector.rb +57 -0
data/lib/webrat/selenium/matchers/have_tag.rb +72 -0
data/lib/webrat/selenium/matchers/have_xpath.rb +53 -0
data/lib/webrat/selenium/selenium_extensions.js +6 -0
data/lib/webrat/selenium/selenium_rc_server.rb +89 -0
data/lib/webrat/selenium/selenium_session.rb +276 -0
data/lib/webrat/selenium/silence_stream.rb +18 -0
data/spec/fakes/test_adapter.rb +33 -0
data/spec/integration/mechanize/Rakefile +7 -0
data/spec/integration/mechanize/config.ru +2 -0
data/spec/integration/mechanize/sample_app.rb +35 -0
data/spec/integration/mechanize/spec/mechanize_spec.rb +30 -0
data/spec/integration/mechanize/spec/spec_helper.rb +29 -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 +20 -0
data/spec/integration/rack/test/webrat_rack_test.rb +74 -0
data/spec/integration/rails/.gitignore +3 -0
data/spec/integration/rails/Rakefile +30 -0
data/spec/integration/rails/app/controllers/application_controller.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 +46 -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 +9 -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 +9 -0
data/spec/integration/rails/app/views/webrat/form.html.erb +28 -0
data/spec/integration/rails/app/views/webrat/within.html.erb +3 -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 +19 -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 +66 -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 +123 -0
data/spec/integration/rails/test/test_helper.rb +27 -0
data/spec/integration/sinatra/Rakefile +5 -0
data/spec/integration/sinatra/classic_app.rb +63 -0
data/spec/integration/sinatra/modular_app.rb +15 -0
data/spec/integration/sinatra/test/classic_app_test.rb +38 -0
data/spec/integration/sinatra/test/modular_app_test.rb +18 -0
data/spec/integration/sinatra/test/test_helper.rb +16 -0
data/spec/private/core/configuration_spec.rb +87 -0
data/spec/private/core/field_spec.rb +83 -0
data/spec/private/core/form_spec.rb +51 -0
data/spec/private/core/link_spec.rb +24 -0
data/spec/private/core/session_spec.rb +182 -0
data/spec/private/mechanize/mechanize_adapter_spec.rb +96 -0
data/spec/private/nokogiri_spec.rb +77 -0
data/spec/private/rails/attaches_file_spec.rb +114 -0
data/spec/private/rails/rails_adapter_spec.rb +79 -0
data/spec/private/selenium/application_servers/rails_spec.rb +26 -0
data/spec/public/basic_auth_spec.rb +35 -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 +544 -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 +118 -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 +165 -0
data/spec/public/reload_spec.rb +10 -0
data/spec/public/save_and_open_spec.rb +49 -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 +474 -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 +56 -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 +53 -0
data/vendor/selenium-server.jar +0 -0
data/webrat.gemspec +355 -0
metadata +424 -0

data/spec/public/select_time_spec.rb ADDED

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -0,0 +1,56 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+describe "submit_form" do
+  it "should submit forms by ID" do
+    with_html <<-HTML
+      <html>
+        <form id="form1" action="/form1">
+          <label for="email">Email:</label> <input type="text" id="email" name="email" /></label>
+          <input type="submit" value="Add" />
+        </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form1", "email" => "test@example.com")
+    fill_in "Email", :with => "test@example.com"
+    submit_form "form1"
+  end
+  it "should submit forms by CSS" 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>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form1", "email" => "test@example.com")
+    fill_in "Email", :with => "test@example.com"
+    submit_form "form[action='/form1']"
+  end
+  it "should give priority to selecting forms by ID" do
+    with_html <<-HTML
+      <html>
+        <form action="/form1">
+          <label for="email">Email:</label> <input id="email" type="text" name="email" />
+          <input type="submit" value="Add" />
+        </form>
+        <form action="/form2" id="form">
+          <label for="email2">Another email:</label> <input id="email2" type="text" name="email" />
+          <input type="submit" value="Add" />
+        </form>
+      </html>
+    HTML
+    webrat_session.should_receive(:get).with("/form2", "email" => "test@example.com")
+    fill_in "Another email", :with => "test@example.com"
+    submit_form "form"
+  end
+end

data/spec/public/visit_spec.rb ADDED

@@ -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

@@ -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