capybara 0.3.0 → 0.3.5

data/Manifest.txt

@@ -40,11 +40,15 @@ spec/dsl/click_spec.rb
 spec/dsl/current_url_spec.rb
 spec/dsl/fill_in_spec.rb
 spec/dsl/find_button_spec.rb
+spec/dsl/find_by_id_spec.rb
 spec/dsl/find_field_spec.rb
 spec/dsl/find_link_spec.rb
 spec/dsl/find_spec.rb
+spec/dsl/has_button_spec.rb
 spec/dsl/has_content_spec.rb
 spec/dsl/has_css_spec.rb
+spec/dsl/has_field_spec.rb
+spec/dsl/has_link_spec.rb
 spec/dsl/has_xpath_spec.rb
 spec/dsl/locate_spec.rb
 spec/dsl/select_spec.rb

data/README.rdoc

@@ -12,16 +12,22 @@ Celerity and Selenium support built in.
 
 == Install:
 
-Capybara is hosted on Gemcutter, install it with:
+Install as a gem:
 
     sudo gem install capybara
 
+On OSX you may have to install libffi, you can install it via MacPorts with:
+
+    sudo port install libffi
+
 == Development:
 
 * Source hosted at {GitHub}[http://github.com/jnicklas/capybara].
 * Please direct questions, discussions at the {mailing list}[http://groups.google.com/group/ruby-capybara].
 * Report issues on {GitHub Issues}[http://github.com/jnicklas/capybara/issues]
-* Pull requests are very welcome!
+
+Pull requests are very welcome! Make sure your patches are well tested, Capybara is
+a testing tool after all.
 
 == Using Capybara with Cucumber
 
@@ -110,7 +116,7 @@ Culerity doesn't seem to be working under Ruby 1.9 at the moment.
 
 == The DSL
 
-Capybara's DSL is inspired by Webrat. While backwards compatibility is retained 
+Capybara's DSL is inspired by Webrat. While backwards compatibility is retained
 in a lot of cases, there are certain important differences.
 
 Unlike in Webrat, all searches in Capybara are *case sensitive*. This is because
@@ -189,7 +195,7 @@ certain elements, and working with and manipulating those elements.
     page.has_xpath?('//table/tr')
     page.has_css?('table tr.foo')
     page.has_content?('foo')
-    
+
 You can use with RSpecs magic matchers:
 
     page.should have_xpath('//table/tr')
@@ -206,7 +212,7 @@ You can also find specific elements, in order to manipulate them:
     find_field('First Name').value
     find_link('Hello').visible?
     find_button('Send').click
-    
+
     find('//table/tr').click
     wait_for("//*[@id='overlay'").find("//h1").click
     all('a').each { |a| a[:href] }
@@ -276,6 +282,27 @@ examples. Just load the dsl and include it anywhere:
     end
     click_link 'Sign in'
 
+== Calling remote servers
+
+Normally Capybara expects to be testing an in-process Rack application, but you can also use it to talk to a web server running anywhere on the internets, by setting app_host:
+
+    require 'capybara'
+    require 'capybara/dsl'
+
+    include Capybara
+    Capybara.current_driver = :selenium
+    Capybara.app_host = 'http://www.google.com'
+
+    visit('/')
+
+Note that rack-test does not support running against a remote server. With drivers that support it, you can also visit any URL directly:
+
+    visit('http://www.google.com')
+
+By default Capybara will try to boot a rack application automatically. You might want to switch off Capybara's rack server if you are running against a remote application:
+
+    Capybara.run_server = false
+
 == Using the sessions manually
 
 For ultimate control, you can instantiate and use a session manually.
@@ -296,12 +323,16 @@ if you want to use CSS with your 'within' declarations for example, you'll need
 to do:
 
     within(:css, 'ul li') { ... }
+    find(:css, 'ul li').text
+    locate(:css, 'input#name').value
 
 Alternatively you can set the default selector to CSS, which may help if you are
 moving from Webrat and used CSS a lot, or simply generally prefer CSS:
 
     Capybara.default_selector = :css
     within('ul li') { ... }
+    find('ul li').text
+    locate('input#name').value
 
 == Gotchas:
 
@@ -338,6 +369,15 @@ The following people have dedicated their time and effort to Capybara:
 * Dan Dofter
 * Thorbjørn Hermansen
 * Louis T.
+* Stephan Hagemann
+* Graham Ashton
+* Joseph Wilk
+* Matt Wynne
+* Piotr Sarnacki
+* Pavel Gabriel
+* Bodaniel Jeanes
+* Carl Porth
+* Darrin Holst
 
 == License:
 

data/lib/capybara.rb

@@ -2,19 +2,21 @@ require 'timeout'
 require 'nokogiri'
 
 module Capybara
-  VERSION = '0.3.0'
+  VERSION = '0.3.5'
 
   class CapybaraError < StandardError; end
   class DriverNotFoundError < CapybaraError; end
   class ElementNotFound < CapybaraError; end
+  class OptionNotFound < ElementNotFound; end
+  class UnselectNotAllowed < CapybaraError; end
   class NotSupportedByDriverError < CapybaraError; end
   class TimeoutError < CapybaraError; end
+  class LocateHiddenElementError < CapybaraError; end
   class InfiniteRedirectError < TimeoutError; end
   
   class << self
-    attr_accessor :debug, :asset_root, :app_host
-    attr_writer :default_selector, :default_wait_time
-    
+    attr_accessor :debug, :asset_root, :app_host, :run_server, :default_host
+    attr_accessor :default_selector, :default_wait_time, :ignore_hidden_elements
 
     def default_selector
       @default_selector ||= :xpath
@@ -44,3 +46,8 @@ module Capybara
     autoload :Selenium, 'capybara/driver/selenium_driver'
   end
 end
+
+Capybara.run_server = true
+Capybara.default_selector = :xpath
+Capybara.default_wait_time = 2
+Capybara.ignore_hidden_elements = false

data/lib/capybara/driver/base.rb

@@ -31,4 +31,7 @@ class Capybara::Driver::Base
     raise NotImplementedError
   end
 
+  def cleanup!
+  end
+
 end

data/lib/capybara/driver/celerity_driver.rb

@@ -10,7 +10,15 @@ class Capybara::Driver::Celerity < Capybara::Driver::Base
       else
         node.send(name.to_sym)
       end
-      return value if value and not value.empty?
+      return value if value and not value.to_s.empty?
+    end
+
+    def value
+      if tag_name == "select" and node.multiple?
+        node.selected_options
+      else
+        super
+      end
     end
 
     def set(value)
@@ -19,6 +27,26 @@ class Capybara::Driver::Celerity < Capybara::Driver::Base
 
     def select(option)
       node.select(option)
+    rescue
+      options = all(:xpath, "//option").map { |o| "'#{o.text}'" }.join(', ')
+      raise Capybara::OptionNotFound, "No such option '#{option}' in this select box. Available options: #{options}"
+    end
+
+    def unselect(option)
+      unless node.multiple?
+        raise Capybara::UnselectNotAllowed, "Cannot unselect option '#{option}' from single select box."
+      end
+
+      # FIXME: couldn't find a clean way to unselect, so clear and reselect
+      selected_options = node.selected_options
+      if unselect_option  = selected_options.detect { |value| value == option } ||
+                            selected_options.detect { |value| value.index(option) }
+        node.clear
+        (selected_options - [unselect_option]).each { |value| node.select_value(value) }
+      else
+        options = all(:xpath, "//option").map { |o| "'#{o.text}'" }.join(', ')
+        raise Capybara::OptionNotFound, "No such option '#{option}' in this select box. Available options: #{options}"
+      end
     end
 
     def click
@@ -44,6 +72,18 @@ class Capybara::Driver::Celerity < Capybara::Driver::Base
     def path
       node.xpath
     end
+    
+    def trigger(event)
+      node.fire_event(event.to_s)
+    end
+
+  private
+
+    def all_unfiltered(locator)
+      noko_node = Nokogiri::HTML(driver.body).xpath(node.xpath).first
+      all_nodes = noko_node.xpath(locator).map { |n| n.path }.join(' | ')
+      driver.find(all_nodes)
+    end
 
   end
 
@@ -51,9 +91,8 @@ class Capybara::Driver::Celerity < Capybara::Driver::Base
 
   def initialize(app)
     @app = app
-    unless Capybara.app_host
-      @rack_server = Capybara::Server.new(@app)
-    end
+    @rack_server = Capybara::Server.new(@app)
+    @rack_server.boot if Capybara.run_server
   end
 
   def visit(path)
@@ -98,11 +137,7 @@ class Capybara::Driver::Celerity < Capybara::Driver::Base
 private
 
   def url(path)
-    if rack_server
-      rack_server.url(path)
-    else
-      Capybara.app_host.to_s + path
-    end
+    rack_server.url(path)
   end
 
 end

data/lib/capybara/driver/rack_test_driver.rb

@@ -10,10 +10,23 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
     end
 
     def [](name)
-      value = node[name.to_s]
-      return value.to_s if value
+      attr_name = name.to_s
+      case
+      when 'select' == tag_name && 'value' == attr_name
+        if node['multiple'] == 'multiple'
+          node.xpath(".//option[@selected='selected']").map { |option| option.content  }
+        else
+          option = node.xpath(".//option[@selected='selected']").first || node.xpath(".//option").first
+          option.content if option
+        end
+      when 'input' == tag_name && 'checkbox' == type && 'checked' == attr_name
+        node[attr_name] == 'checked' ? true : false
+      else
+        node[attr_name]
+      end
     end
 
+
     def set(value)
       if tag_name == 'input' and %w(text password hidden file).include?(type)
         node['value'] = value.to_s
@@ -32,8 +45,31 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
     end
 
     def select(option)
-      node.xpath(".//option").each { |node| node.remove_attribute("selected") }
-      node.xpath(".//option[contains(.,'#{option}')]").first["selected"] = 'selected'
+      if node['multiple'] != 'multiple'
+        node.xpath(".//option[@selected]").each { |node| node.remove_attribute("selected") }
+      end
+
+      if option_node = node.xpath(".//option[text()='#{option}']").first ||
+                       node.xpath(".//option[contains(.,'#{option}')]").first
+        option_node["selected"] = 'selected'
+      else
+        options = node.xpath(".//option").map { |o| "'#{o.text}'" }.join(', ')
+        raise Capybara::OptionNotFound, "No such option '#{option}' in this select box. Available options: #{options}"
+      end
+    end
+
+    def unselect(option)
+      if node['multiple'] != 'multiple'
+        raise Capybara::UnselectNotAllowed, "Cannot unselect option '#{option}' from single select box."
+      end
+
+      if option_node = node.xpath(".//option[text()='#{option}']").first ||
+                       node.xpath(".//option[contains(.,'#{option}')]").first
+        option_node.remove_attribute('selected')
+      else
+        options = node.xpath(".//option").map { |o| "'#{o.text}'" }.join(', ')
+        raise Capybara::OptionNotFound, "No such option '#{option}' in this select box. Available options: #{options}"
+      end
     end
 
     def click
@@ -49,7 +85,7 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
     end
 
     def visible?
-      node.xpath("./ancestor-or-self::*[contains(@style, 'display:none')]").size == 0
+      node.xpath("./ancestor-or-self::*[contains(@style, 'display:none') or contains(@style, 'display: none')]").size == 0
     end
 
     def path
@@ -58,8 +94,12 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
 
   private
 
+    def all_unfiltered(locator)
+      node.xpath(locator).map { |n| self.class.new(driver, n) }
+    end
+
     def type
-      self[:type]
+      node[:type]
     end
 
     def form
@@ -70,7 +110,10 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
   class Form < Node
     def params(button)
       params = {}
-      node.xpath(".//input[@type='text' or @type='hidden' or @type='password']").map do |input|
+
+      text_fields = %w[text hidden password url color tel email search].map{|f| "@type='#{f}'"}.join(' or ')
+
+      node.xpath(".//input[#{text_fields}]").map do |input|
         merge_param!(params, input['name'].to_s, input['value'].to_s)
       end
       node.xpath(".//textarea").map do |textarea|
@@ -80,9 +123,16 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
         merge_param!(params, input['name'].to_s, input['value'].to_s) if input['checked']
       end
       node.xpath(".//select").map do |select|
-        option = select.xpath(".//option[@selected]").first
-        option ||= select.xpath('.//option').first
-        merge_param!(params, select['name'].to_s, (option['value'] || option.text).to_s) if option
+        if select['multiple'] == 'multiple'
+          options = select.xpath(".//option[@selected]")
+          options.each do |option|
+            merge_param!(params, select['name'].to_s, (option['value'] || option.text).to_s)
+          end
+        else
+          option = select.xpath(".//option[@selected]").first
+          option ||= select.xpath('.//option').first
+          merge_param!(params, select['name'].to_s, (option['value'] || option.text).to_s) if option
+        end
       end
       node.xpath(".//input[@type='file']").map do |input|
         unless input['value'].to_s.empty?
@@ -95,7 +145,7 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
           end
         end
       end
-      merge_param!(params, button[:name], button[:value]) if button[:name]
+      merge_param!(params, button[:name], button[:value] || "") if button[:name]
       params
     end
 
@@ -108,7 +158,7 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
     end
 
   private
-    
+
     def method
       self[:method] =~ /post/i ? :post : :get
     end
@@ -140,7 +190,7 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
 
   def visit(path, attributes = {})
     return if path.gsub(/^#{current_path}/, '') =~ /^#/
-    get(path, attributes)
+    get(path, attributes, env)
     follow_redirects!
     cache_body
   end
@@ -154,8 +204,8 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
   end
 
   def submit(method, path, attributes)
-    path = current_path if not path or path.empty? 
-    send(method, path, attributes)
+    path = current_path if not path or path.empty?
+    send(method, path, attributes, env)
     follow_redirects!
     cache_body
   end
@@ -166,10 +216,14 @@ class Capybara::Driver::RackTest < Capybara::Driver::Base
 
 private
 
+  def build_rack_mock_session # :nodoc:
+    Rack::MockSession.new(app, Capybara.default_host || "example.org")
+  end
+
   def current_path
     request.path rescue ""
   end
-  
+
   def follow_redirects!
     Capybara::WaitUntil.timeout(4) do
       redirect = response.redirect?
@@ -180,6 +234,16 @@ private
     raise Capybara::InfiniteRedirectError, "infinite redirect detected!"
   end
 
+  def env
+    env = {}
+    begin
+      env["HTTP_REFERER"] = request.url
+    rescue Rack::Test::Error
+      # no request yet
+    end
+    env
+  end
+
   def cache_body
     @body = response.body
     @html = Nokogiri::HTML(body)

data/lib/capybara/driver/selenium_driver.rb

@@ -16,6 +16,14 @@ class Capybara::Driver::Selenium < Capybara::Driver::Base
       nil
     end
 
+    def value
+      if tag_name == "select" and self[:multiple]
+        node.find_elements(:xpath, ".//option").select { |n| n.selected? }.map { |n| n.text }
+      else
+        super
+      end
+    end
+
     def set(value)
       if tag_name == 'textarea' or (tag_name == 'input' and %w(text password hidden file).include?(type))
         node.clear
@@ -28,7 +36,25 @@ class Capybara::Driver::Selenium < Capybara::Driver::Base
     end
 
     def select(option)
-      node.find_element(:xpath, ".//option[contains(.,'#{option}')]").select
+      option_node = node.find_element(:xpath, ".//option[text()='#{option}']") || node.find_element(:xpath, ".//option[contains(.,'#{option}')]")
+      option_node.select
+    rescue 
+      options = node.find_elements(:xpath, "//option").map { |o| "'#{o.text}'" }.join(', ')
+      raise Capybara::OptionNotFound, "No such option '#{option}' in this select box. Available options: #{options}"
+    end
+
+    def unselect(option)
+      if node['multiple'] != 'multiple'
+        raise Capybara::UnselectNotAllowed, "Cannot unselect option '#{option}' from single select box."
+      end
+
+      begin
+        option_node = node.find_element(:xpath, ".//option[text()='#{option}']") || node.find_element(:xpath, ".//option[contains(.,'#{option}')]")
+        option_node.clear
+      rescue
+        options = node.find_elements(:xpath, "//option").map { |o| "'#{o.text}'" }.join(', ')
+        raise Capybara::OptionNotFound, "No such option '#{option}' in this select box. Available options: #{options}"
+      end
     end
 
     def click
@@ -46,9 +72,16 @@ class Capybara::Driver::Selenium < Capybara::Driver::Base
     def visible?
       node.displayed? and node.displayed? != "false"
     end
+    
+    def trigger(event)
+    end
 
   private
 
+    def all_unfiltered(locator)
+      node.find_elements(:xpath, locator).map { |n| self.class.new(driver, n) }
+    end
+
     def type
       self[:type]
     end
@@ -69,9 +102,8 @@ class Capybara::Driver::Selenium < Capybara::Driver::Base
 
   def initialize(app)
     @app = app
-    unless Capybara.app_host
-      @rack_server = Capybara::Server.new(@app)
-    end
+    @rack_server = Capybara::Server.new(@app)
+    @rack_server.boot if Capybara.run_server
   end
 
   def visit(path)
@@ -104,14 +136,14 @@ class Capybara::Driver::Selenium < Capybara::Driver::Base
     self.class.driver
   end
 
+  def cleanup!
+    browser.manage.delete_all_cookies
+  end
+
 private
 
   def url(path)
-    if rack_server
-      rack_server.url(path)
-    else
-      Capybara.app_host.to_s + path
-    end
+    rack_server.url(path)
   end
 
 end