yannp-capybara 0.3.9

data/lib/capybara/spec/views/tables.erb

@@ -0,0 +1,122 @@
+<form action="/form" method="post">
+  <table id="agent_table">
+    <caption>Agent</caption>
+  
+    <tr>
+      <td>
+        <label for="form_agent_name">Name</label>
+      </td>
+      <td>
+        <input type="text" name="form[agent_name]" value="James" id="form_agent_name"/>
+      </td>
+    </tr>
+  
+    <tr>
+      <td colspan="2">
+        <input type="submit" value="Create"/>
+      </td>
+    </tr>
+  </table>
+</form>
+
+<form action="/form" method="post">
+  <table id="girl_table">
+    <caption>Girl</caption>
+  
+    <tr>
+      <td>
+        <label for="form_girl_name">Name</label>
+      </td>
+      <td>
+        <input type="text" name="form[girl_name]" value="Vesper" id="form_girl_name"/>
+      </td>
+    </tr>
+  
+    <tr>
+      <td colspan="2">
+        <input type="submit" value="Create"/>
+      </td>
+    </tr>
+  </table>
+</form>
+
+<form action="/form" method="post">
+  <table id="villain_table">
+    <caption>Villain</caption>
+  
+    <tr>
+      <td>
+        <label for="form_villain_name">Name</label>
+      </td>
+      <td>
+        <input type="text" name="form[villain_name]" value="Ernst" id="form_villain_name"/>
+      </td>
+    </tr>
+  
+    <tr>
+      <td colspan="2">
+        <input type="submit" value="Create"/>
+      </td>
+    </tr>
+  </table>
+</form>
+
+<table>
+  <caption>Ransom</caption>
+
+  <thead>
+    <tr>
+      <th>Year</th>
+      <th>Governmental</th>
+      <th>Private</th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <tr>
+      <th scope="row">2007</th>
+      <td>$300</td>
+      <td>$100</td>
+    </tr>
+    <tr>
+      <th scope="row">2008</th>
+      <td>$123</td>
+      <td>$897</td>
+    </tr>
+    <tr>
+      <th scope="row">2009</th>
+      <td>$543</td>
+      <td>$99</td>
+    </tr>
+  </tbody>
+</table>
+
+<table>
+  <caption>Deaths</caption>
+
+  <thead>
+    <tr>
+      <th>Year</th>
+      <th>Sharks with lasers</th>
+      <th>Flaming volcano</th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <tr>
+      <th scope="row">2007</th>
+      <td>66</td>
+      <td>7</td>
+    </tr>
+    <tr>
+      <th scope="row">2008</th>
+      <td>123</td>
+      <td>12</td>
+    </tr>
+    <tr>
+      <th scope="row">2009</th>
+      <td>913</td>
+      <td>13</td>
+    </tr>
+  </tbody>
+</table>

data/lib/capybara/spec/views/with_html.erb

@@ -0,0 +1,43 @@
+<h1>This is a test</h1>
+
+<p id="first">
+  Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
+  tempor incididunt ut <a href="/with_simple_html" title="awesome title" class="simple">labore</a>
+  et dolore magna aliqua. Ut enim ad minim veniam,
+  quis nostrud exercitation <a href="/foo" id="foo">ullamco</a> laboris nisi
+  ut aliquip ex ea commodo consequat.
+  <a href="/with_simple_html"><img src="http://www.foobar.sun/dummy_image.jpg" width="20" height="20" alt="awesome image" /></a>
+</p>
+
+<p id="second">
+  Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
+  dolore eu fugiat <a href="/redirect" id="red">Redirect</a> pariatur. Excepteur sint occaecat cupidatat non proident,
+  sunt in culpa qui officia
+  text   with
+  whitespace
+  id est laborum.
+</p>
+
+<p>
+  <input type="text" id="test_field" value="monkey"/>
+  <textarea>banana</textarea>
+  <a href="/redirect_back">BackToMyself</a>
+  <a title="twas a fine link" href="/redirect">A link came first</a>
+  <a title="a fine link" href="/with_simple_html">A link</a>
+  <a title="a fine link with data method" data-method="delete" href="/delete">A link with data-method</a>
+  <a>No Href</a>
+  <a href="">Blank Href</a>
+  <a href="#">Blank Anchor</a>
+  <a href="#anchor">Anchor</a>
+  <a href="/with_simple_html#anchor">Anchor on different page</a>
+  <a href="/with_html#anchor">Anchor on same page</a>
+  <input type="text" value="" id="test_field">
+  <input type="text" checked="checked" id="checked_field">
+  <a href="/redirect"><img src="http://www.foobar.sun/dummy_image.jpg" width="20" height="20" alt="very fine image" /></a>
+  <a href="/with_simple_html"><img src="http://www.foobar.sun/dummy_image.jpg" width="20" height="20" alt="fine image" /></a>
+</p>
+
+<div id="hidden" style="display: none;">
+  <div id="hidden_via_ancestor">Inside element with hidden ancestor</div>
+  <a href="/with_simple_html" title="awesome title" class="simple">hidden link</a>
+</div>

data/lib/capybara/spec/views/with_js.erb

@@ -0,0 +1,39 @@
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+  <head>
+    <meta http-equiv="Content-type" content="text/html; charset=utf-8"/>
+    <title>with_js</title>
+    <script src="/jquery.js" type="text/javascript" charset="utf-8"></script>
+    <script src="/jquery-ui.js" type="text/javascript" charset="utf-8"></script>
+    <script src="/test.js" type="text/javascript" charset="utf-8"></script>
+  </head>
+  
+  <body id="with_js">
+    <h1>FooBar</h1>
+    
+    <p id="change">This is text</p>
+    <div id="drag">
+      <p>This is a draggable element.</p>
+    </div>
+    <div id="drop">
+      <p>It should be dropped here.</p>
+    </div>
+    
+    <p><a href="#" id="clickable">Click me</a></p>
+    
+    <p>
+      <select id="waiter">
+        <option>Foo</option>
+        <option>My Waiting Option</option>
+      </select>
+    </p>
+    
+    <p>
+      <input type="text" name="with_focus_event" value="" id="with_focus_event"/>
+    </p>
+
+    <p>
+      <input type="checkbox" id="checkbox_with_event"/>
+    </p>
+  </body>
+</html>
+

data/lib/capybara/spec/views/with_scope.erb

@@ -0,0 +1,36 @@
+<h1>This page is used for testing various scopes</h1>
+
+<p id="for_foo">
+  Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor
+  incididunt ut labore et dolore magna aliqua. Ut enim ad minim venia.
+  <a href="/redirect">Go</a>
+</p>
+
+<div id="for_bar">
+  <ul>
+    <li>With Simple HTML: <a href="/with_simple_html">Go</a>
+      <form action="/redirect" method="post" accept-charset="utf-8">
+        <p>
+          <label for="simple_first_name">First Name</label>
+          <input type="text" name="first_name" value="John" id="simple_first_name"/>
+        </p>
+        <p><input type="submit" value="Go"/></p>
+      </form>
+    </li>
+    <li>Bar: <a href="/foo">Go</a>
+      <form action="/form" method="post" accept-charset="utf-8">
+        <p>
+          <label for="bar_first_name">First Name</label>
+          <input type="text" name="form[first_name]" value="Peter" id="bar_first_name"/>
+        </p>
+        <p><input type="submit" value="Go"/></p>
+      </form>
+    </li>
+  </ul>
+</div>
+
+<div id="another_foo">
+  <ul>
+    <li>With Simple HTML: <a href="/">Go</a>
+  </ul>
+</div>

data/lib/capybara/spec/views/with_simple_html.erb

@@ -0,0 +1 @@
+Bar

data/lib/capybara/spec/views/within_frames.erb

@@ -0,0 +1,10 @@
+<html>
+    <head>
+        <title>With Frames</title>
+    </head>
+    <body>
+        <div id="divInMainWindow">This is the text for divInMainWindow</div>
+    <iframe src="/frame_one" id="frameOne"></iframe>
+    <iframe src="/frame_two" id="frameTwo"></iframe>
+    </body>
+</html>

data/lib/capybara/util/save_and_open_page.rb

@@ -0,0 +1,36 @@
+module Capybara
+  class << self
+    def save_and_open_page(html)
+      name = File.join(*[Capybara.save_and_open_page_path, "capybara-#{Time.new.strftime("%Y%m%d%H%M%S")}.html"].compact)
+
+      unless Capybara.save_and_open_page_path.nil? || File.directory?(Capybara.save_and_open_page_path )
+        FileUtils.mkdir_p(Capybara.save_and_open_page_path)
+      end
+      FileUtils.touch(name) unless File.exist?(name)
+
+      tempfile = File.new(name,'w')
+      tempfile.write(rewrite_css_and_image_references(html))
+      tempfile.close
+
+      open_in_browser(tempfile.path)
+    end
+
+  protected
+
+    def open_in_browser(path) # :nodoc
+      require "launchy"
+      Launchy::Browser.run(path)
+    rescue LoadError
+      warn "Sorry, you need to install launchy to open pages: `gem install launchy`"
+    end
+
+    def rewrite_css_and_image_references(response_html) # :nodoc:
+      return response_html unless Capybara.asset_root
+      directories = Dir.new(Capybara.asset_root).entries.inject([]) do |list, name|
+        list << name if File.directory?(name) and not name.to_s =~ /^\./
+        list
+      end
+      response_html.gsub(/("|')\/(#{directories.join('|')})/, '\1' + Capybara.asset_root.to_s + '/\2')
+    end
+  end
+end

data/lib/capybara/util/timeout.rb

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

data/lib/capybara/version.rb

@@ -0,0 +1,3 @@
+module Capybara
+  VERSION = '0.3.9'
+end

data/lib/capybara/xpath.rb

@@ -0,0 +1,182 @@
+module Capybara
+
+  ##
+  #
+  # This is a class for generating XPath queries, use it like this:
+  #
+  #     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 escape(string)
+        if string.include?("'")
+          string = string.split("'", -1).map do |substr|
+            "'#{substr}'"
+          end.join(%q{,"'",})
+          "concat(#{string})"
+        else
+          "'#{string}'"
+        end
+      end
+      
+      def wrap(path)
+        if path.is_a?(self)
+          path
+        else
+          new(path.to_s)
+        end
+      end
+
+      def respond_to?(method)
+        new.respond_to?(method)
+      end
+
+      def method_missing(*args)
+        new.send(*args)
+      end
+    end
+
+    attr_reader :paths
+
+    def initialize(*paths)
+      @paths = paths
+    end
+
+    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 from_css(css)
+      XPath.new(*[@paths, Nokogiri::CSS.xpath_for(css).map { |selector| '.' + selector }].flatten)
+    end
+    alias_method :for_css, :from_css
+
+    def field(locator, options={})
+      if options[:with]
+        fillable_field(locator, options)
+      else
+        xpath = fillable_field(locator)
+        xpath = xpath.input_field(:file, locator, options)
+        xpath = xpath.checkbox(locator, options)
+        xpath = xpath.radio_button(locator, options)
+        xpath.select(locator, options)
+      end
+    end
+
+    def fillable_field(locator, options={})
+      text_area(locator, options).text_field(locator, options)
+    end
+
+    def content(locator)
+      append("./descendant-or-self::*[contains(normalize-space(.),#{s(locator)})]")
+    end
+
+    def table(locator, options={})
+      conditions = ""
+      if options[:rows]
+        row_conditions = options[:rows].map do |row|
+          row = row.map { |column| "*[self::td or self::th][text()=#{s(column)}]" }.join(sibling)
+          "tr[./#{row}]"
+        end.join(sibling)
+        conditions << "[.//#{row_conditions}]"
+      end
+      append(".//table[@id=#{s(locator)} or contains(caption,#{s(locator)})]#{conditions}")
+    end
+
+    def fieldset(locator)
+      append(".//fieldset[@id=#{s(locator)} or contains(legend,#{s(locator)})]")
+    end
+
+    def link(locator)
+      xpath = append(".//a[@href][@id=#{s(locator)} or contains(.,#{s(locator)}) or contains(@title,#{s(locator)}) or img[contains(@alt,#{s(locator)})]]")
+      xpath.prepend(".//a[@href][text()=#{s(locator)} or @title=#{s(locator)} or img[@alt=#{s(locator)}]]")
+    end
+
+    def button(locator)
+      xpath = append(".//input[@type='submit' or @type='image' or @type='button'][@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' or @type='button'][@value=#{s(locator)}]")
+      xpath = xpath.prepend(".//input[@type='image'][@alt=#{s(locator)} or contains(@alt,#{s(locator)})]")
+      xpath = xpath.prepend(".//button[@value=#{s(locator)} or text()=#{s(locator)}]")
+    end
+
+    def text_field(locator, options={})
+      options = options.merge(:value => options[:with]) if options.has_key?(:with)
+      add_field(locator, ".//input[not(@type) or (@type!='radio' and @type!='checkbox' and @type!='hidden')]", options)
+    end
+
+    def text_area(locator, options={})
+      options = options.merge(:text => options[:with]) if options.has_key?(:with)
+      add_field(locator, ".//textarea", options)
+    end
+
+    def select(locator, options={})
+      add_field(locator, ".//select", options)
+    end
+
+    def checkbox(locator, options={})
+      input_field(:checkbox, locator, options)
+    end
+
+    def radio_button(locator, options={})
+      input_field(:radio, locator, options)
+    end
+
+    def file_field(locator, options={})
+      input_field(:file, locator, options)
+    end
+
+  protected
+
+    def input_field(type, locator, options={})
+      options = options.merge(:value => options[:with]) if options.has_key?(:with)
+      add_field(locator, ".//input[@type='#{type}']", options)
+    end
+
+    # place this between to nodes to indicate that they should be siblings
+    def sibling
+      '/following-sibling::*[1]/self::'
+    end
+
+    def add_field(locator, field, options={})
+      postfix = extract_postfix(options)
+      xpath = append("#{field}[@id=#{s(locator)}]#{postfix}")
+      xpath = xpath.append("#{field}[@name=#{s(locator)}]#{postfix}")
+      xpath = xpath.append("#{field}[@id=//label[contains(.,#{s(locator)})]/@for]#{postfix}")
+      # FIXME: Label should not be scoped to node, temporary workaround!!!
+      xpath = xpath.append(".//label[contains(.,#{s(locator)})]/#{field}#{postfix}")
+      xpath.prepend("#{field}[@id=//label[text()=#{s(locator)}]/@for]#{postfix}")
+    end
+
+    def extract_postfix(options)
+      options.inject("") do |postfix, (key, value)|
+        case key
+          when :value     then postfix += "[@value=#{s(value)}]"
+          when :text      then postfix += "[text()=#{s(value)}]"
+          when :checked   then postfix += "[@checked]"
+          when :unchecked then postfix += "[not(@checked)]"
+          when :options   then postfix += value.map { |o| "[.//option/text()=#{s(o)}]" }.join
+          when :selected  then postfix += [value].flatten.map { |o| "[.//option[@selected]/text()=#{s(o)}]" }.join
+        end
+        postfix
+      end
+    end
+
+    # Sanitize a String for putting it into an xpath query
+    def s(string)
+      XPath.escape(string)
+    end
+
+  end
+end

data/lib/capybara.rb

@@ -0,0 +1,73 @@
+require 'timeout'
+require 'nokogiri'
+
+module Capybara
+  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 :asset_root, :app_host, :run_server, :default_host
+    attr_accessor :default_selector, :default_wait_time, :ignore_hidden_elements
+    attr_accessor :save_and_open_page_path
+
+    ##
+    #
+    # Configure Capybara to suit your needs.
+    #
+    #     Capybara.configure do |config|
+    #       config.run_server = false
+    #       config.app_host   = 'http://www.google.com'
+    #     end
+    #
+    # === Configurable options
+    #
+    # [asset_root = String]               Where static assets are located, used by save_and_open_page
+    # [app_host = String]                 The default host to use when giving a relative URL to visit
+    # [run_server = Boolean]              Whether to start a Rack server for the given Rack app (Default: true)
+    # [default_selector = :css/:xpath]    Methods which take a selector use the given type by default (Default: CSS)
+    # [default_wait_time = Integer]       The number of seconds to wait for asynchronous processes to finish (Default: 2)
+    # [ignore_hidden_elements = Boolean]  Whether to ignore hidden elements on the page (Default: false)
+    #
+    # === DSL Options
+    #
+    # when using capybara/dsl, the following options are also available:
+    #
+    # [default_driver = Symbol]           The name of the driver to use by default. (Default: :rack_test)
+    # [javascript_driver = Symbol]        The name of a driver to use for JavaScript enabled tests. (Default: :selenium)
+    #
+    def configure
+      yield self
+    end
+  end
+
+  autoload :Server,     'capybara/server'
+  autoload :Session,    'capybara/session'
+  autoload :XPath,      'capybara/xpath'
+  autoload :Node,       'capybara/node'
+  autoload :Document,   'capybara/node'
+  autoload :Element,    'capybara/node'
+  autoload :VERSION,    'capybara/version'
+
+  module Driver
+    autoload :Base,     'capybara/driver/base'
+    autoload :Node,     'capybara/driver/node'
+    autoload :RackTest, 'capybara/driver/rack_test_driver'
+    autoload :Celerity, 'capybara/driver/celerity_driver'
+    autoload :Culerity, 'capybara/driver/culerity_driver'
+    autoload :Selenium, 'capybara/driver/selenium_driver'
+  end
+end
+
+Capybara.configure do |config|
+  config.run_server = true
+  config.default_selector = :css
+  config.default_wait_time = 2
+  config.ignore_hidden_elements = false
+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(:all) 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 status code support"
+    it_should_behave_like "driver with cookies support"
+  end
+else
+  puts "#{File.basename(__FILE__)} requires JRuby; skipping.."
+end

data/spec/driver/culerity_driver_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::Culerity do
+  before(:all) do
+    @driver = Capybara::Driver::Culerity.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 status code support"
+  it_should_behave_like "driver with cookies support"
+end

data/spec/driver/rack_test_driver_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::RackTest do
+  before do
+    @driver = Capybara::Driver::RackTest.new(TestApp)
+  end
+
+  it "should throw an error when no rack app is given" do
+    running do
+      Capybara::Driver::RackTest.new(nil)
+    end.should raise_error(ArgumentError)
+  end
+
+  it_should_behave_like "driver"
+  it_should_behave_like "driver with header support"
+  it_should_behave_like "driver with status code support"
+  it_should_behave_like "driver with cookies support"
+  it_should_behave_like "driver with infinite redirect detection"
+end

data/spec/driver/remote_culerity_driver_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::Culerity do
+  before(:all) do
+    Capybara.app_host = "http://capybara-testapp.heroku.com"
+    Capybara.run_server = false
+    @driver = Capybara::Driver::Culerity.new(TestApp)
+  end
+  
+  after(:all) do
+    Capybara.app_host = nil
+    Capybara.run_server = true
+  end
+
+  it "should navigate to a fully qualified remote page" do
+    @driver.visit('http://capybara-testapp.heroku.com/foo')
+    @driver.body.should include('Another World')
+  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 status code support"
+end