capybara_minitest_spec 0.1.0

data/test_app/session/select_spec.rb

@@ -0,0 +1,113 @@
+shared_examples_for "select" do
+  describe "#select" do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should return value of the first option" do
+      @session.find_field('Title').value.should == 'Mrs'
+    end
+
+    it "should return value of the selected option" do
+      @session.select("Miss", :from => 'Title')
+      @session.find_field('Title').value.should == 'Miss'
+    end
+
+    it "should return the value attribute rather than content if present" do
+      @session.find_field('Locale').value.should == 'en'
+    end
+
+    it "should select an option from a select box by id" do
+      @session.select("Finish", :from => 'form_locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'fi'
+    end
+
+    it "should select an option from a select box by label" do
+      @session.select("Finish", :from => 'Locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'fi'
+    end
+
+    it "should select an option without giving a select box" do
+      @session.select("Mr")
+      @session.click_button('awesome')
+      extract_results(@session)['title'].should == 'Mr'
+    end
+
+    it "should favour exact matches to option labels" do
+      @session.select("Mr", :from => 'Title')
+      @session.click_button('awesome')
+      extract_results(@session)['title'].should == 'Mr'
+    end
+
+    it "should escape quotes" do
+      @session.select("John's made-up language", :from => 'Locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'jo'
+    end
+
+    it "should obey from" do
+      @session.select("Miss", :from => "Other title")
+      @session.click_button('awesome')
+      results = extract_results(@session)
+      results['other_title'].should == "Miss"
+      results['title'].should_not == "Miss"
+    end
+
+    it "show match labels with preceding or trailing whitespace" do
+      @session.select("Lojban", :from => 'Locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'jbo'
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.select('foo', :from => 'does not exist') }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    context "with an option that doesn't exist" do
+      it "should raise an error" do
+        running { @session.select('Does not Exist', :from => 'form_locale') }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    context "with multiple select" do
+      it "should return an empty value" do
+        @session.find_field('Language').value.should == []
+      end
+
+      it "should return value of the selected options" do
+        @session.select("Ruby",       :from => 'Language')
+        @session.select("Javascript", :from => 'Language')
+        @session.find_field('Language').value.should include('Ruby', 'Javascript')
+      end
+
+      it "should select one option" do
+        @session.select("Ruby", :from => 'Language')
+        @session.click_button('awesome')
+        extract_results(@session)['languages'].should == ['Ruby']
+      end
+
+      it "should select multiple options" do
+        @session.select("Ruby",       :from => 'Language')
+        @session.select("Javascript", :from => 'Language')
+        @session.click_button('awesome')
+        extract_results(@session)['languages'].should include('Ruby', 'Javascript')
+      end
+      
+      it "should remain selected if already selected" do
+        @session.select("Ruby",       :from => 'Language')
+        @session.select("Javascript", :from => 'Language')
+        @session.select("Ruby",       :from => 'Language')
+        @session.click_button('awesome')
+        extract_results(@session)['languages'].should include('Ruby', 'Javascript')
+      end
+      
+      it "should return value attribute rather than content if present" do
+        @session.find_field('Underwear').value.should include('thermal')
+      end
+    end
+  end
+end

data/test_app/session/text_spec.rb

@@ -0,0 +1,19 @@
+shared_examples_for "text" do
+  describe '#text' do
+    before do
+      @session.visit('/with_simple_html')
+    end
+
+    it "should print the text of the page" do
+      @session.text.should == 'Bar'
+    end
+
+    context "with css as default selector" do
+      before { Capybara.default_selector = :css }
+      it "should print the text of the page" do
+        @session.text.should == 'Bar'
+      end
+      after { Capybara.default_selector = :xpath }
+    end
+  end
+end

data/test_app/session/uncheck_spec.rb

@@ -0,0 +1,21 @@
+shared_examples_for "uncheck" do  
+  describe "#uncheck" do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should uncheck a checkbox by id" do
+      @session.uncheck("form_pets_hamster")
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should include('dog')
+      extract_results(@session)['pets'].should_not include('hamster')
+    end
+
+    it "should uncheck a checkbox by label" do
+      @session.uncheck("Hamster")
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should include('dog')
+      extract_results(@session)['pets'].should_not include('hamster')
+    end
+  end
+end

data/test_app/session/unselect_spec.rb

@@ -0,0 +1,61 @@
+shared_examples_for "unselect" do
+  describe "#unselect" do
+    before do
+      @session.visit('/form')
+    end
+
+    context "with multiple select" do
+      it "should unselect an option from a select box by id" do
+        @session.unselect('Commando', :from => 'form_underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Commando')
+      end
+
+      it "should unselect an option without a select box" do
+        @session.unselect('Commando')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Commando')
+      end
+
+      it "should unselect an option from a select box by label" do
+        @session.unselect('Commando', :from => 'Underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Commando')
+      end
+
+      it "should favour exact matches to option labels" do
+        @session.unselect("Briefs", :from => 'Underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Commando', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Briefs')
+      end
+
+      it "should escape quotes" do
+        @session.unselect("Frenchman's Pantalons", :from => 'Underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should_not include("Frenchman's Pantalons")
+      end
+    end
+
+    context "with single select" do
+      it "should raise an error" do
+        running { @session.unselect("English", :from => 'form_locale') }.should raise_error(Capybara::UnselectNotAllowed)
+      end
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.unselect('foo', :from => 'does not exist') }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    context "with an option that doesn't exist" do
+      it "should raise an error" do
+        running { @session.unselect('Does not Exist', :from => 'form_underwear') }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

data/test_app/session/within_spec.rb

@@ -0,0 +1,178 @@
+shared_examples_for "within" do
+  describe '#within' do
+    before do
+      @session.visit('/with_scope')
+    end
+
+    context "with CSS selector" do
+      it "should click links in the given scope" do
+        @session.within(:css, "ul li[contains('With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+
+      it "should assert content in the given scope" do
+        @session.within(:css, "#for_foo") do
+          @session.should_not have_content('First Name')
+        end
+        @session.should have_content('First Name')
+      end
+
+      it "should accept additional options" do
+        @session.within(:css, "ul li", :text => 'With Simple HTML') do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with XPath selector" do
+      it "should click links in the given scope" do
+        @session.within(:xpath, "//li[contains(.,'With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with the default selector" do
+      it "should use XPath" do
+        @session.within("//li[contains(., 'With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with Node rather than selector" do
+      it "should click links in the given scope" do
+        node_of_interest = @session.find(:css, "ul li[contains('With Simple HTML')]")
+
+        @session.within(node_of_interest) do 
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with the default selector set to CSS" do
+      before { Capybara.default_selector = :css }
+      it "should use CSS" do
+        @session.within("ul li[contains('With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+      after { Capybara.default_selector = :xpath }
+    end
+
+    context "with click_link" do
+      it "should click links in the given scope" do
+        @session.within("//li[contains(.,'With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+
+      context "with nested scopes" do
+        it "should respect the inner scope" do
+          @session.within("//div[@id='for_bar']") do
+            @session.within(".//li[contains(.,'Bar')]") do
+              @session.click_link('Go')
+            end
+          end
+          @session.body.should include('Another World')
+        end
+
+        it "should respect the outer scope" do
+          @session.within("//div[@id='another_foo']") do
+            @session.within(".//li[contains(.,'With Simple HTML')]") do
+              @session.click_link('Go')
+            end
+          end
+          @session.body.should include('Hello world')
+        end
+      end
+
+      it "should raise an error if the scope is not found on the page" do
+        running {
+          @session.within("//div[@id='doesnotexist']") do
+          end
+        }.should raise_error(Capybara::ElementNotFound)
+      end
+
+      it "should restore the scope when an error is raised" do
+        running {
+          @session.within("//div[@id='for_bar']") do
+            running {
+              running {
+                @session.within(".//div[@id='doesnotexist']") do
+                end
+              }.should raise_error(Capybara::ElementNotFound)
+            }.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
+          end
+        }.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(true)
+      end
+    end
+
+    context "with forms" do
+      it "should fill in a field and click a button" do
+        @session.within("//li[contains(.,'Bar')]") do
+          @session.click_button('Go')
+        end
+        extract_results(@session)['first_name'].should == 'Peter'
+        @session.visit('/with_scope')
+        @session.within("//li[contains(.,'Bar')]") do
+          @session.fill_in('First Name', :with => 'Dagobert')
+          @session.click_button('Go')
+        end
+        extract_results(@session)['first_name'].should == 'Dagobert'
+      end
+    end
+  end
+
+  describe '#within_fieldset' do
+    before do
+      @session.visit('/fieldsets')
+    end
+
+    it "should restrict scope to a fieldset given by id" do
+      @session.within_fieldset("villain_fieldset") do
+        @session.fill_in("Name", :with => 'Goldfinger')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['villain_name'].should == 'Goldfinger'
+    end
+
+    it "should restrict scope to a fieldset given by legend" do
+      @session.within_fieldset("Villain") do
+        @session.fill_in("Name", :with => 'Goldfinger')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['villain_name'].should == 'Goldfinger'
+    end
+  end
+
+  describe '#within_table' do
+    before do
+      @session.visit('/tables')
+    end
+
+    it "should restrict scope to a fieldset given by id" do
+      @session.within_table("girl_table") do
+        @session.fill_in("Name", :with => 'Christmas')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['girl_name'].should == 'Christmas'
+    end
+
+    it "should restrict scope to a fieldset given by legend" do
+      @session.within_table("Villain") do
+        @session.fill_in("Name", :with => 'Quantum')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['villain_name'].should == 'Quantum'
+    end
+  end
+end

data/test_app/session.rb

@@ -0,0 +1,154 @@
+require 'capybara/spec/test_app'
+require 'nokogiri'
+
+Dir[File.dirname(__FILE__)+'/session/*'].each { |group| require group }
+
+shared_examples_for "session" do
+  def extract_results(session)
+    YAML.load Nokogiri::HTML(session.body).xpath("//pre[@id='results']").first.text
+  end
+
+  after do
+    @session.reset_session!
+  end
+
+  describe '#visit' do
+    it "should fetch a response from the driver" do
+      @session.visit('/')
+      @session.body.should include('Hello world!')
+      @session.visit('/foo')
+      @session.body.should include('Another World')
+    end
+  end
+
+  describe '#body' do
+    it "should return the unmodified page body" do
+      @session.visit('/')
+      @session.body.should include('Hello world!')
+    end
+  end
+
+  describe '#html' do
+    it "should return the unmodified page body" do
+      # html and body should be aliased, but we can't just check for
+      # method(:html) == method(:body) because these shared examples get run
+      # against the DSL, which uses forwarding methods.  So we test behavior.
+      @session.visit('/')
+      @session.body.should include('Hello world!')
+    end
+  end
+
+  describe '#source' do
+    it "should return the unmodified page source" do
+      @session.visit('/')
+      @session.source.should include('Hello world!')
+    end
+  end
+
+  describe '#reset_session!' do
+    it "removes cookies" do
+      @session.visit('/set_cookie')
+      @session.visit('/get_cookie')
+      @session.body.should include('test_cookie')
+
+      @session.reset_session!
+      @session.visit('/get_cookie')
+      @session.body.should_not include('test_cookie')
+    end
+
+    it "resets current host" do
+      @session.visit('http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+
+      @session.reset_session!
+      @session.current_host.should be_nil
+    end
+
+    it "resets current path" do
+      @session.visit('/with_html')
+      @session.current_path.should == '/with_html'
+
+      @session.reset_session!
+      @session.current_path.should be_nil
+    end
+
+    it "resets page body" do
+      @session.visit('/with_html')
+      @session.body.should include('This is a test')
+      @session.find('.//h1').text.should include('This is a test')
+
+      @session.reset_session!
+      @session.body.should_not include('This is a test')
+      @session.should have_no_selector('.//h1')
+    end
+  end
+
+  it_should_behave_like "all"
+  it_should_behave_like "first"
+  it_should_behave_like "attach_file"
+  it_should_behave_like "check"
+  it_should_behave_like "choose"
+  it_should_behave_like "click_link_or_button"
+  it_should_behave_like "click_button"
+  it_should_behave_like "click_link"
+  it_should_behave_like "fill_in"
+  it_should_behave_like "find_button"
+  it_should_behave_like "find_field"
+  it_should_behave_like "find_link"
+  it_should_behave_like "find_by_id"
+  it_should_behave_like "find"
+  it_should_behave_like "has_content"
+  it_should_behave_like "has_css"
+  it_should_behave_like "has_css"
+  it_should_behave_like "has_selector"
+  it_should_behave_like "has_xpath"
+  it_should_behave_like "has_link"
+  it_should_behave_like "has_button"
+  it_should_behave_like "has_field"
+  it_should_behave_like "has_select"
+  it_should_behave_like "has_table"
+  it_should_behave_like "select"
+  it_should_behave_like "text"
+  it_should_behave_like "uncheck"
+  it_should_behave_like "unselect"
+  it_should_behave_like "within"
+  it_should_behave_like "current_url"
+  it_should_behave_like "current_host"
+
+  it "should encode complex field names, like array[][value]" do
+    @session.visit('/form')
+    @session.fill_in('address1_city', :with =>'Paris')
+    @session.fill_in('address1_street', :with =>'CDG')
+    @session.fill_in('address1_street', :with =>'CDG')
+    @session.select("France", :from => 'address1_country')
+
+    @session.fill_in('address2_city', :with => 'Mikolaiv')
+    @session.fill_in('address2_street', :with => 'PGS')
+    @session.select("Ukraine", :from => 'address2_country')
+
+    @session.click_button "awesome"
+
+    addresses=extract_results(@session)["addresses"]
+    addresses.should have(2).addresses
+
+    addresses[0]["street"].should   == 'CDG'
+    addresses[0]["city"].should     == 'Paris'
+    addresses[0]["country"].should  == 'France'
+
+    addresses[1]["street"].should   == 'PGS'
+    addresses[1]["city"].should     == 'Mikolaiv'
+    addresses[1]["country"].should  == 'Ukraine'
+  end
+
+end
+
+
+describe Capybara::Session do
+  context 'with non-existant driver' do
+    it "should raise an error" do
+      running {
+        Capybara::Session.new(:quox, TestApp).driver
+      }.should raise_error(Capybara::DriverNotFoundError)
+    end
+  end
+end

data/test_app/test_app.rb

@@ -0,0 +1,142 @@
+require 'sinatra/base'
+require 'rack'
+require 'yaml'
+
+class TestApp < Sinatra::Base
+  set :root, File.dirname(__FILE__)
+  set :static, true
+
+  get '/' do
+    'Hello world! <a href="with_html">Relative</a>'
+  end
+
+  get '/foo' do
+    'Another World'
+  end
+
+  get '/redirect' do
+    redirect '/redirect_again'
+  end
+
+  get '/redirect_again' do
+    redirect '/landed'
+  end
+
+  get '/host' do
+    "Current host is #{request.scheme}://#{request.host}"
+  end
+
+  get '/redirect/:times/times' do
+    times = params[:times].to_i
+    if times.zero?
+      "redirection complete"
+    else
+      redirect "/redirect/#{times - 1}/times"
+    end
+  end
+
+  get '/landed' do
+    "You landed"
+  end
+
+  get '/with-quotes' do
+    %q{"No," he said, "you can't do that."}
+  end
+
+  get '/form/get' do
+    '<pre id="results">' + params[:form].to_yaml + '</pre>'
+  end
+
+  post '/relative' do
+    '<pre id="results">' + params[:form].to_yaml + '</pre>'
+  end
+
+  get '/favicon.ico' do
+    nil
+  end
+
+  post '/redirect' do
+    redirect '/redirect_again'
+  end
+
+  delete "/delete" do
+    "The requested object was deleted"
+  end
+
+  get "/delete" do
+    "Not deleted"
+  end
+
+  get '/redirect_back' do
+    redirect back
+  end
+
+  get '/redirect_secure' do
+    redirect "https://#{request.host}/host"
+  end
+
+  get '/slow_response' do
+    sleep 2
+    'Finally!'
+  end
+
+  get '/set_cookie' do
+    cookie_value = 'test_cookie'
+    response.set_cookie('capybara', cookie_value)
+    "Cookie set to #{cookie_value}"
+  end
+
+  get '/get_cookie' do
+    request.cookies['capybara']
+  end
+
+  get '/get_header' do
+    env['HTTP_FOO']
+  end
+
+  get '/get_header_via_redirect' do
+    redirect '/get_header'
+  end
+
+  get '/:view' do |view|
+    erb view.to_sym
+  end
+
+  post '/form' do
+    '<pre id="results">' + params[:form].to_yaml + '</pre>'
+  end
+
+  post '/upload_empty' do
+    if params[:form][:file].nil?
+      'Successfully ignored empty file field.'
+    else
+      'Something went wrong.'
+    end
+  end
+
+  post '/upload' do
+    begin
+      buffer = []
+      buffer << "Content-type: #{params[:form][:document][:type]}"
+      buffer << "File content: #{params[:form][:document][:tempfile].read}"
+      buffer.join(' | ')
+    rescue
+      'No file uploaded'
+    end
+  end
+
+  post '/upload_multiple' do
+    begin
+      buffer = []
+      buffer << "Content-type: #{params[:form][:multiple_documents][0][:type]}"
+      buffer << "File content: #{params[:form][:multiple_documents][0][:tempfile].read}"
+      buffer.join(' | ')
+    rescue
+      'No files uploaded'
+    end
+  end
+end
+
+if __FILE__ == $0
+  Rack::Handler::WEBrick.run TestApp, :Port => 8070
+end

data/test_app/views/buttons.erb

@@ -0,0 +1,4 @@
+<h1>Buttons</h1>
+<button>Click me!</button>
+<button id="click_me_123">Click me by id!</button>
+<button value="click_me">Click me by value!</button>