capybara 0.2.0 → 0.3.0

data/lib/capybara/wait_until.rb

@@ -0,0 +1,23 @@
+module Capybara
+  #Provides timeout similar to standard library Timeout, but avoids threads
+  class WaitUntil
+
+    class << self
+
+      def timeout(seconds = 1, &block)
+        start_time = Time.now
+
+        result = nil
+
+        until result
+          return result if result = yield
+
+          if (Time.now - start_time) > seconds
+             raise TimeoutError
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/capybara/xpath.rb

@@ -3,7 +3,13 @@ module Capybara
   #     Xpath.text_field('foo').link('blah').to_s
   # this will generate an XPath that matches either a text field or a link
   class XPath
+
     class << self
+      def from_css(css)
+        Nokogiri::CSS.xpath_for(css).first
+      end
+      alias_method :for_css, :from_css
+
       def wrap(path)
         if path.is_a?(self)
           path
@@ -11,7 +17,7 @@ module Capybara
           new(path.to_s)
         end
       end
-      
+
       def respond_to?(method)
         new.respond_to?(method)
       end
@@ -26,64 +32,53 @@ module Capybara
     def initialize(*paths)
       @paths = paths
     end
-    
+
     def field(locator)
-      fillable_field(locator).file_field(locator).checkbox(locator).radio_button(locator).select(locator)
+      fillable_field(locator).input_field(:file, locator).checkbox(locator).radio_button(locator).select(locator)
     end
 
     def fillable_field(locator)
-      text_field(locator).password_field(locator).text_area(locator)
+      [:text, :password, :email, :url, :search, :tel, :color].inject(text_area(locator)) do |all, type|
+        all.input_field(type, locator)
+      end
     end
-    
+
     def content(locator)
       append("/descendant-or-self::*[contains(.,#{s(locator)})]")
     end
-    
+
     def table(locator)
       append("//table[@id=#{s(locator)} or contains(caption,#{s(locator)})]")
     end
-    
+
     def fieldset(locator)
       append("//fieldset[@id=#{s(locator)} or contains(legend,#{s(locator)})]")
     end
-    
-    def link(locator)
-      append("//a[@id=#{s(locator)} or contains(.,#{s(locator)}) or @title=#{s(locator)}]")
-    end
-    
-    def button(locator)
-      xpath = append("//input[@type='submit' or @type='image'][@id=#{s(locator)} or @value=#{s(locator)}]")
-      xpath.append("//button[@id=#{s(locator)} or @value=#{s(locator)} or contains(.,#{s(locator)})]")
-    end
 
-    def text_field(locator)
-      add_field(locator) { |id| "//input[@type='text'][@id=#{id}]" }
+    def link(locator)
+      xpath = append("//a[@href][@id=#{s(locator)} or contains(.,#{s(locator)}) or contains(@title,#{s(locator)})]")
+      xpath.prepend("//a[@href][text()=#{s(locator)} or @title=#{s(locator)}]")
     end
 
-    def password_field(locator)
-      add_field(locator) { |id| "//input[@type='password'][@id=#{id}]" }
+    def button(locator)
+      xpath = append("//input[@type='submit' or @type='image'][@id=#{s(locator)} or contains(@value,#{s(locator)})]")
+      xpath = xpath.append("//button[@id=#{s(locator)} or contains(@value,#{s(locator)}) or contains(.,#{s(locator)})]")
+      xpath = xpath.prepend("//input[@type='submit' or @type='image'][@value=#{s(locator)}]")
+      xpath = xpath.prepend("//button[@value=#{s(locator)} or text()=#{s(locator)}]")
     end
 
     def text_area(locator)
-      add_field(locator) { |id| "//textarea[@id=#{id}]" }
-    end
-
-    def radio_button(locator)
-      add_field(locator) { |id| "//input[@type='radio'][@id=#{id}]" }
-    end
-
-    def checkbox(locator)
-      add_field(locator) { |id| "//input[@type='checkbox'][@id=#{id}]" }
+      add_field(locator, "//textarea")
     end
 
     def select(locator)
-      add_field(locator) { |id| "//select[@id=#{id}]" }
+      add_field(locator, "//select")
     end
 
-    def file_field(locator)
-      add_field(locator) { |id| "//input[@type='file'][@id=#{id}]" }
+    def input_field(type, locator)
+      add_field(locator, "//input[@type='#{type}']")
     end
-    
+
     def scope(scope)
       XPath.new(*paths.map { |p| scope + p })
     end
@@ -91,23 +86,41 @@ module Capybara
     def to_s
       @paths.join(' | ')
     end
-    
+
     def append(path)
       XPath.new(*[@paths, XPath.wrap(path).paths].flatten)
     end
-    
+
     def prepend(path)
       XPath.new(*[XPath.wrap(path).paths, @paths].flatten)
     end
 
+    def checkbox(locator)
+      input_field(:checkbox, locator)
+    end
+
+    def radio_button(locator)
+      input_field(:radio, locator)
+    end
+
+    [:text, :password, :email, :url, :search, :tel, :color, :file].each do |type|
+      class_eval <<-RUBY, __FILE__, __LINE__+1
+        def #{type}_field(locator)
+          input_field(:#{type}, locator)
+        end
+      RUBY
+    end
+
   protected
-  
-    def add_field(locator)
-      xpath = append(yield(s(locator)))
-      xpath = xpath.append(yield("//label[contains(.,#{s(locator)})]/@for"))
-      xpath.prepend(yield("//label[text()=#{s(locator)}]/@for"))
+
+    def add_field(locator, field)
+      xpath = append("#{field}[@id=#{s(locator)}]")
+      xpath = xpath.append("#{field}[@name=#{s(locator)}]")
+      xpath = xpath.append("#{field}[@id=//label[contains(.,#{s(locator)})]/@for]")
+      xpath = xpath.append("//label[contains(.,#{s(locator)})]#{field}")
+      xpath.prepend("#{field}[@id=//label[text()=#{s(locator)}]/@for]")
     end
-  
+
     # Sanitize a String for putting it into an xpath query
     def s(string)
       if string.include?("'")
@@ -118,6 +131,7 @@ module Capybara
       else
         "'#{string}'"
       end
+
     end
 
   end

data/spec/capybara_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+
+require 'capybara'
+
+describe Capybara do
+  
+  describe 'default_wait_time' do
+    after do
+      Capybara.default_wait_time = 2
+    end
+    
+    it "should be changeable" do
+      Capybara.default_wait_time = 5
+      Capybara.default_wait_time.should == 5
+    end
+  end
+  
+end

data/spec/driver/celerity_driver_spec.rb

@@ -0,0 +1,17 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+if RUBY_PLATFORM =~ /java/
+  describe Capybara::Driver::Celerity do
+    before do
+      @driver = Capybara::Driver::Celerity.new(TestApp)
+    end
+
+    it_should_behave_like "driver"
+    it_should_behave_like "driver with javascript support"
+    it_should_behave_like "driver with header support"
+    it_should_behave_like "driver with node path support"
+    
+  end
+else
+  puts "#{File.basename(__FILE__)} requires JRuby; skipping.."
+end

data/spec/driver/culerity_driver_spec.rb

@@ -7,4 +7,7 @@ describe Capybara::Driver::Culerity do
   
   it_should_behave_like "driver"
   it_should_behave_like "driver with javascript support"
+  it_should_behave_like "driver with header support"
+  it_should_behave_like "driver with node path support" 
+  
 end

data/spec/driver/rack_test_driver_spec.rb

@@ -6,4 +6,7 @@ describe Capybara::Driver::RackTest do
   end
   
   it_should_behave_like "driver"
+  it_should_behave_like "driver with header support"
+  it_should_behave_like "driver with node path support"
+  
 end

data/spec/driver/remote_culerity_driver_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::Culerity do
+  before do
+    @driver = Capybara::Driver::Culerity.new(TestApp)
+  end
+  
+  before(:all) do
+    Capybara.app_host = "http://capybara-testapp.heroku.com"
+  end
+  
+  after(:all) do
+    Capybara.app_host = nil
+  end
+  
+  it_should_behave_like "driver"
+  it_should_behave_like "driver with javascript support"
+  it_should_behave_like "driver with header support"
+end

data/spec/driver/remote_selenium_driver_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::Selenium do
+  before(:all) do
+    Capybara.app_host = "http://capybara-testapp.heroku.com"
+  end
+  
+  after(:all) do
+    Capybara.app_host = nil
+  end
+
+  before do
+    @driver = Capybara::Driver::Selenium.new(TestApp)
+  end
+
+  it_should_behave_like "driver"
+  it_should_behave_like "driver with javascript support"
+end

data/spec/driver/selenium_driver_spec.rb

@@ -7,4 +7,6 @@ describe Capybara::Driver::Selenium do
 
   it_should_behave_like "driver"
   it_should_behave_like "driver with javascript support"
+  it_should_behave_like "driver without node path support"
+  
 end

data/spec/drivers_spec.rb

@@ -9,6 +9,11 @@ shared_examples_for 'driver' do
       @driver.visit('/foo')
       @driver.body.should include('Another World')
     end
+    
+    it "should show the correct URL" do
+      @driver.visit('/foo')
+      @driver.current_url.should include('/foo')
+    end
   end
 
   describe '#body' do
@@ -19,7 +24,7 @@ shared_examples_for 'driver' do
 
     it "should return the full response html" do
       @driver.visit('/with_simple_html')
-      @driver.body.should include('<h1>Bar</h1>')
+      @driver.body.should include('Bar')
     end
   end
 
@@ -29,10 +34,6 @@ shared_examples_for 'driver' do
         @driver.visit('/with_html')
       end
 
-      it "should find the correct number of elements" do
-        @driver.find('//a').size.should == 3
-      end
-
       it "should extract node texts" do
         @driver.find('//a')[0].text.should == 'labore'
         @driver.find('//a')[1].text.should == 'ullamco'
@@ -57,6 +58,13 @@ shared_examples_for 'driver' do
         @driver.find('//a')[1].tag_name.should == 'a'
         @driver.find('//p')[1].tag_name.should == 'p'
       end
+      
+      it "should extract node visibility" do
+        @driver.find('//a')[0].should be_visible
+        
+        @driver.find('//div[@id="hidden"]')[0].should_not be_visible
+        @driver.find('//div[@id="hidden_via_ancestor"]')[0].should_not be_visible
+      end
     end
   end
 
@@ -87,3 +95,41 @@ shared_examples_for "driver with javascript support" do
   end
 
 end
+
+shared_examples_for "driver with header support" do
+  it "should make headers available through response_headers" do
+    @driver.visit('/with_simple_html')
+    @driver.response_headers['Content-Type'].should == 'text/html'
+  end
+end
+
+shared_examples_for "driver with node path support" do
+  describe "node relative searching" do
+    before do
+      @driver.visit('/tables')
+      @node = @driver.find('//body').first
+    end
+  
+    it "should be able to navigate/search child nodes" do
+      @node.all('//table').size.should == 3
+      @node.find('//form').all('//table').size.should == 1
+      @node.find('//form').find('//table//caption').text.should == 'Agent'
+    end
+  end
+end
+
+shared_examples_for "driver without node path support" do
+  describe "node relative searching" do
+    before do
+      @driver.visit('/tables')
+      @node = @driver.find('//body').first
+    end
+  
+    it "should get NotSupportedByDriverError" do
+      running do
+        @node.all('//form')
+      end.should raise_error(Capybara::NotSupportedByDriverError) 
+    end
+    
+  end
+end

data/spec/dsl/all_spec.rb

@@ -0,0 +1,38 @@
+module AllSpec
+  shared_examples_for "all" do
+    describe '#all' do
+      before do
+        @session.visit('/with_html')
+      end
+
+      it "should find all elements using the given locator" do
+        @session.all('//p').should have(3).elements
+        @session.all('//h1').first.text.should == 'This is a test'
+        @session.all("//input[@id='test_field']").first[:value].should == 'monkey'
+      end
+
+      it "should return an empty array when nothing was found" do
+        @session.all('//div[@id="nosuchthing"]').should be_empty
+      end
+
+      it "should accept an XPath instance" do
+        @session.visit('/form')
+        @xpath = Capybara::XPath.text_field('Name')
+        @result = @session.all(@xpath).map { |r| r.value }
+        @result.should include('Smith', 'John', 'John Smith')
+      end
+
+      context "within a scope" do
+        before do
+          @session.visit('/with_scope')
+        end
+
+        it "should find any element using the given locator" do
+          @session.within(:xpath, "//div[@id='for_bar']") do
+            @session.all('//li').should have(2).elements
+          end
+        end
+      end
+    end
+  end
+end  

data/spec/dsl/attach_file_spec.rb

@@ -0,0 +1,66 @@
+module AttachFileSpec
+  shared_examples_for "attach_file" do
+
+    describe "#attach_file" do
+      before do
+        @session.visit('/form')
+      end
+
+      context "with normal form" do
+        it "should set a file path by id" do
+          @session.attach_file "form_image", __FILE__
+          @session.click_button('awesome')
+          extract_results(@session)['image'].should == File.basename(__FILE__)
+        end
+
+        it "should set a file path by label" do
+          @session.attach_file "Image", __FILE__
+          @session.click_button('awesome')
+          extract_results(@session)['image'].should == File.basename(__FILE__)
+        end
+      end
+
+      context "with multipart form" do
+        before do
+          @test_file_path = File.expand_path('../fixtures/test_file.txt', File.dirname(__FILE__))
+          @test_jpg_file_path = File.expand_path('../fixtures/capybara.jpg', File.dirname(__FILE__))
+        end
+
+        it "should set a file path by id" do
+          @session.attach_file "form_document", @test_file_path
+          @session.click_button('Upload')
+          @session.body.should include(File.read(@test_file_path))
+        end
+
+        it "should set a file path by label" do
+          @session.attach_file "Document", @test_file_path
+          @session.click_button('Upload')
+          @session.body.should include(File.read(@test_file_path))
+        end
+
+        it "should not break if no file is submitted" do
+          @session.click_button('Upload')
+          @session.body.should include('No file uploaded')
+        end
+
+        it "should send content type text/plain when uploading a text file" do
+          @session.attach_file "Document", @test_file_path
+          @session.click_button 'Upload'
+          @session.body.should include('text/plain')
+        end
+
+        it "should send content type image/jpeg when uploading an image" do
+          @session.attach_file "Document", @test_jpg_file_path
+          @session.click_button 'Upload'
+          @session.body.should include('image/jpeg')
+        end
+      end
+
+      context "with a locator that doesn't exist" do
+        it "should raise an error" do
+          running { @session.attach_file('does not exist', 'foo.txt') }.should raise_error(Capybara::ElementNotFound)
+        end
+      end
+    end
+  end
+end