katzil-capybara 0.3.8

data/History.txt

@@ -0,0 +1,87 @@
+# Version 0.3.8
+
+Release date: 2010-05-12
+
+### Added
+
+* Within_frame method to execute a block of code within a particular iframe (Selenium only!)
+
+### Fixed
+
+* Single quotes are properly escaped with `select` under rack-test and Selenium.
+* The :text option for searches now escapes regexp special characters when a string is given.
+* Selenium now correctly checks already checked checkboxes (same with uncheck)
+* Timing issue which caused Selenium to hang under certain circumstances.
+* Selenium now resolves attributes even if they are given as a Symbol
+
+# Version 0.3.7
+
+Release date: 2010-04-09
+
+This is a drop in compatible maintainance release. It's mostly
+important for driver authors.
+
+### Added
+
+* RackTest scans for data-method which rails3 uses to change the request method
+
+### Fixed
+
+* Don't hang when starting server on Windoze
+
+### Changed
+
+* The driver and session specs are now located inside lib! Driver authors can simply require them.
+
+# Version 0.3.6
+
+Release date: 2010-03-22
+
+This is a maintainance release with minor bug fixes, should be
+drop in compatible.
+
+### Added
+
+* It's now possible to load in external drivers
+
+### Fixed
+
+* has_content? ignores whitespace
+* Trigger events when choosing radios and checking checkboxes under Selenium
+* Make Capybara.app totally optional when running without server
+* Changed fallback host so it matches the one set up by Rails' integration tests
+
+# Version 0.3.5
+
+Release date: 2010-02-26
+
+This is a mostly backwards compatible release, it does break
+the API in some minor places, which should hopefully not affect
+too many users, please read the release notes carefully!
+
+### Breaking
+
+* Relative searching in a node (e.g. find('//p').all('//a')) will now follow XPath standard
+  this means that if you want to find descendant nodes only, you'll need to prefix a dot!
+* `visit` now accepts fully qualified URLs for drivers that support it.
+* Capybara will always try to run a rack server, unless you set Capybara.run_sever = false
+
+### Changed
+
+* thin is preferred over mongrel and webrick, since it is Ruby 1.9 compatible
+* click_button and click will find <input type="button">, clicking them does nothing in RackTest
+
+### Added
+
+* Much improved error messages in a multitude of places
+* More semantic page querying with has_link?, has_button?, etc...
+* Option to ignore hidden elements when querying and interacting with the page
+* Support for multiple selects
+
+### Fixed
+
+* find_by_id is no longer broken
+* clicking links where the image's alt attribute contains the text is now possible
+* within_fieldset and within_table work when the default selector is CSS
+* boolean attributes work the same across drivers (return true/false)
+

data/Manifest

@@ -0,0 +1,89 @@
+History.txt
+Manifest
+README.rdoc
+Rakefile
+lib/capybara.rb
+lib/capybara/cucumber.rb
+lib/capybara/driver/base.rb
+lib/capybara/driver/celerity_driver.rb
+lib/capybara/driver/culerity_driver.rb
+lib/capybara/driver/rack_test_driver.rb
+lib/capybara/driver/selenium_driver.rb
+lib/capybara/dsl.rb
+lib/capybara/node.rb
+lib/capybara/rails.rb
+lib/capybara/save_and_open_page.rb
+lib/capybara/searchable.rb
+lib/capybara/server.rb
+lib/capybara/server.rb.orig
+lib/capybara/session.rb
+lib/capybara/spec/driver.rb
+lib/capybara/spec/fixtures/capybara.jpg
+lib/capybara/spec/fixtures/test_file.txt
+lib/capybara/spec/public/jquery-ui.js
+lib/capybara/spec/public/jquery.js
+lib/capybara/spec/public/test.js
+lib/capybara/spec/session.rb
+lib/capybara/spec/session/all_spec.rb
+lib/capybara/spec/session/attach_file_spec.rb
+lib/capybara/spec/session/check_spec.rb
+lib/capybara/spec/session/choose_spec.rb
+lib/capybara/spec/session/click_button_spec.rb
+lib/capybara/spec/session/click_link_spec.rb
+lib/capybara/spec/session/click_spec.rb
+lib/capybara/spec/session/current_url_spec.rb
+lib/capybara/spec/session/fill_in_spec.rb
+lib/capybara/spec/session/find_button_spec.rb
+lib/capybara/spec/session/find_by_id_spec.rb
+lib/capybara/spec/session/find_field_spec.rb
+lib/capybara/spec/session/find_link_spec.rb
+lib/capybara/spec/session/find_spec.rb
+lib/capybara/spec/session/has_button_spec.rb
+lib/capybara/spec/session/has_content_spec.rb
+lib/capybara/spec/session/has_css_spec.rb
+lib/capybara/spec/session/has_field_spec.rb
+lib/capybara/spec/session/has_link_spec.rb
+lib/capybara/spec/session/has_select_spec.rb
+lib/capybara/spec/session/has_table_spec.rb
+lib/capybara/spec/session/has_xpath_spec.rb
+lib/capybara/spec/session/headers.rb
+lib/capybara/spec/session/javascript.rb
+lib/capybara/spec/session/locate_spec.rb
+lib/capybara/spec/session/select_spec.rb
+lib/capybara/spec/session/uncheck_spec.rb
+lib/capybara/spec/session/unselect_spec.rb
+lib/capybara/spec/session/within_spec.rb
+lib/capybara/spec/test_app.rb
+lib/capybara/spec/views/buttons.erb
+lib/capybara/spec/views/fieldsets.erb
+lib/capybara/spec/views/form.erb
+lib/capybara/spec/views/frame_one.erb
+lib/capybara/spec/views/frame_two.erb
+lib/capybara/spec/views/postback.erb
+lib/capybara/spec/views/tables.erb
+lib/capybara/spec/views/with_html.erb
+lib/capybara/spec/views/with_js.erb
+lib/capybara/spec/views/with_scope.erb
+lib/capybara/spec/views/with_simple_html.erb
+lib/capybara/spec/views/within_frames.erb
+lib/capybara/version.rb
+lib/capybara/wait_until.rb
+lib/capybara/xpath.rb
+spec/capybara_spec.rb
+spec/driver/celerity_driver_spec.rb
+spec/driver/culerity_driver_spec.rb
+spec/driver/rack_test_driver_spec.rb
+spec/driver/remote_culerity_driver_spec.rb
+spec/driver/remote_selenium_driver_spec.rb
+spec/driver/selenium_driver_spec.rb
+spec/dsl_spec.rb
+spec/save_and_open_page_spec.rb
+spec/searchable_spec.rb
+spec/server_spec.rb
+spec/session/celerity_session_spec.rb
+spec/session/culerity_session_spec.rb
+spec/session/rack_test_session_spec.rb
+spec/session/selenium_session_spec.rb
+spec/spec_helper.rb
+spec/wait_until_spec.rb
+spec/xpath_spec.rb

data/README.rdoc

@@ -0,0 +1,7 @@
+= capybara
+
+* http://github.com/jnicklas/capybara
+
+== Description:
+
+This is a test fix for capybara problem with localhost. See http://github.com/jnicklas/capybara

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('katzil-capybara', '0.3.8') do |p|
+  p.description    = "A fork for capybara project"
+  p.summary        = "A fix to capybara gem"
+  p.url            = "http://github.com/ilyakatz/tests"
+  p.author         = "Ilya Katz"
+  p.email          = "ilyakatz @nospam@ gmail dot com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+end
+

data/katzil-capybara.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{katzil-capybara}
+  s.version = "0.3.8"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ilya Katz"]
+  s.cert_chain = ["/Users/ilyakatz/.ssh/gem-public_cert.pem"]
+  s.date = %q{2010-05-20}
+  s.description = %q{A fork for capybara project}
+  s.email = %q{ilyakatz @nospam@ gmail dot com}
+  s.extra_rdoc_files = ["README.rdoc", "lib/capybara.rb", "lib/capybara/cucumber.rb", "lib/capybara/driver/base.rb", "lib/capybara/driver/celerity_driver.rb", "lib/capybara/driver/culerity_driver.rb", "lib/capybara/driver/rack_test_driver.rb", "lib/capybara/driver/selenium_driver.rb", "lib/capybara/dsl.rb", "lib/capybara/node.rb", "lib/capybara/rails.rb", "lib/capybara/save_and_open_page.rb", "lib/capybara/searchable.rb", "lib/capybara/server.rb", "lib/capybara/server.rb.orig", "lib/capybara/session.rb", "lib/capybara/spec/driver.rb", "lib/capybara/spec/fixtures/capybara.jpg", "lib/capybara/spec/fixtures/test_file.txt", "lib/capybara/spec/public/jquery-ui.js", "lib/capybara/spec/public/jquery.js", "lib/capybara/spec/public/test.js", "lib/capybara/spec/session.rb", "lib/capybara/spec/session/all_spec.rb", "lib/capybara/spec/session/attach_file_spec.rb", "lib/capybara/spec/session/check_spec.rb", "lib/capybara/spec/session/choose_spec.rb", "lib/capybara/spec/session/click_button_spec.rb", "lib/capybara/spec/session/click_link_spec.rb", "lib/capybara/spec/session/click_spec.rb", "lib/capybara/spec/session/current_url_spec.rb", "lib/capybara/spec/session/fill_in_spec.rb", "lib/capybara/spec/session/find_button_spec.rb", "lib/capybara/spec/session/find_by_id_spec.rb", "lib/capybara/spec/session/find_field_spec.rb", "lib/capybara/spec/session/find_link_spec.rb", "lib/capybara/spec/session/find_spec.rb", "lib/capybara/spec/session/has_button_spec.rb", "lib/capybara/spec/session/has_content_spec.rb", "lib/capybara/spec/session/has_css_spec.rb", "lib/capybara/spec/session/has_field_spec.rb", "lib/capybara/spec/session/has_link_spec.rb", "lib/capybara/spec/session/has_select_spec.rb", "lib/capybara/spec/session/has_table_spec.rb", "lib/capybara/spec/session/has_xpath_spec.rb", "lib/capybara/spec/session/headers.rb", "lib/capybara/spec/session/javascript.rb", "lib/capybara/spec/session/locate_spec.rb", "lib/capybara/spec/session/select_spec.rb", "lib/capybara/spec/session/uncheck_spec.rb", "lib/capybara/spec/session/unselect_spec.rb", "lib/capybara/spec/session/within_spec.rb", "lib/capybara/spec/test_app.rb", "lib/capybara/spec/views/buttons.erb", "lib/capybara/spec/views/fieldsets.erb", "lib/capybara/spec/views/form.erb", "lib/capybara/spec/views/frame_one.erb", "lib/capybara/spec/views/frame_two.erb", "lib/capybara/spec/views/postback.erb", "lib/capybara/spec/views/tables.erb", "lib/capybara/spec/views/with_html.erb", "lib/capybara/spec/views/with_js.erb", "lib/capybara/spec/views/with_scope.erb", "lib/capybara/spec/views/with_simple_html.erb", "lib/capybara/spec/views/within_frames.erb", "lib/capybara/version.rb", "lib/capybara/wait_until.rb", "lib/capybara/xpath.rb"]
+  s.files = ["History.txt", "Manifest", "README.rdoc", "Rakefile", "lib/capybara.rb", "lib/capybara/cucumber.rb", "lib/capybara/driver/base.rb", "lib/capybara/driver/celerity_driver.rb", "lib/capybara/driver/culerity_driver.rb", "lib/capybara/driver/rack_test_driver.rb", "lib/capybara/driver/selenium_driver.rb", "lib/capybara/dsl.rb", "lib/capybara/node.rb", "lib/capybara/rails.rb", "lib/capybara/save_and_open_page.rb", "lib/capybara/searchable.rb", "lib/capybara/server.rb", "lib/capybara/server.rb.orig", "lib/capybara/session.rb", "lib/capybara/spec/driver.rb", "lib/capybara/spec/fixtures/capybara.jpg", "lib/capybara/spec/fixtures/test_file.txt", "lib/capybara/spec/public/jquery-ui.js", "lib/capybara/spec/public/jquery.js", "lib/capybara/spec/public/test.js", "lib/capybara/spec/session.rb", "lib/capybara/spec/session/all_spec.rb", "lib/capybara/spec/session/attach_file_spec.rb", "lib/capybara/spec/session/check_spec.rb", "lib/capybara/spec/session/choose_spec.rb", "lib/capybara/spec/session/click_button_spec.rb", "lib/capybara/spec/session/click_link_spec.rb", "lib/capybara/spec/session/click_spec.rb", "lib/capybara/spec/session/current_url_spec.rb", "lib/capybara/spec/session/fill_in_spec.rb", "lib/capybara/spec/session/find_button_spec.rb", "lib/capybara/spec/session/find_by_id_spec.rb", "lib/capybara/spec/session/find_field_spec.rb", "lib/capybara/spec/session/find_link_spec.rb", "lib/capybara/spec/session/find_spec.rb", "lib/capybara/spec/session/has_button_spec.rb", "lib/capybara/spec/session/has_content_spec.rb", "lib/capybara/spec/session/has_css_spec.rb", "lib/capybara/spec/session/has_field_spec.rb", "lib/capybara/spec/session/has_link_spec.rb", "lib/capybara/spec/session/has_select_spec.rb", "lib/capybara/spec/session/has_table_spec.rb", "lib/capybara/spec/session/has_xpath_spec.rb", "lib/capybara/spec/session/headers.rb", "lib/capybara/spec/session/javascript.rb", "lib/capybara/spec/session/locate_spec.rb", "lib/capybara/spec/session/select_spec.rb", "lib/capybara/spec/session/uncheck_spec.rb", "lib/capybara/spec/session/unselect_spec.rb", "lib/capybara/spec/session/within_spec.rb", "lib/capybara/spec/test_app.rb", "lib/capybara/spec/views/buttons.erb", "lib/capybara/spec/views/fieldsets.erb", "lib/capybara/spec/views/form.erb", "lib/capybara/spec/views/frame_one.erb", "lib/capybara/spec/views/frame_two.erb", "lib/capybara/spec/views/postback.erb", "lib/capybara/spec/views/tables.erb", "lib/capybara/spec/views/with_html.erb", "lib/capybara/spec/views/with_js.erb", "lib/capybara/spec/views/with_scope.erb", "lib/capybara/spec/views/with_simple_html.erb", "lib/capybara/spec/views/within_frames.erb", "lib/capybara/version.rb", "lib/capybara/wait_until.rb", "lib/capybara/xpath.rb", "spec/capybara_spec.rb", "spec/driver/celerity_driver_spec.rb", "spec/driver/culerity_driver_spec.rb", "spec/driver/rack_test_driver_spec.rb", "spec/driver/remote_culerity_driver_spec.rb", "spec/driver/remote_selenium_driver_spec.rb", "spec/driver/selenium_driver_spec.rb", "spec/dsl_spec.rb", "spec/save_and_open_page_spec.rb", "spec/searchable_spec.rb", "spec/server_spec.rb", "spec/session/celerity_session_spec.rb", "spec/session/culerity_session_spec.rb", "spec/session/rack_test_session_spec.rb", "spec/session/selenium_session_spec.rb", "spec/spec_helper.rb", "spec/wait_until_spec.rb", "spec/xpath_spec.rb", "katzil-capybara.gemspec"]
+  s.homepage = %q{http://github.com/ilyakatz/tests}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Katzil-capybara", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{katzil-capybara}
+  s.rubygems_version = %q{1.3.6}
+  s.signing_key = %q{/Users/ilyakatz/.ssh/gem-private_key.pem}
+  s.summary = %q{A fix to capybara gem}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/capybara.rb

@@ -0,0 +1,52 @@
+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 :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
+    end
+    
+    def default_wait_time
+      @default_wait_time ||= 2
+    end
+
+    def log(message)
+      puts "[capybara] #{message}" if debug
+      true
+    end
+  end
+  
+  autoload :Server,     'capybara/server'
+  autoload :Session,    'capybara/session'
+  autoload :Node,       'capybara/node'
+  autoload :XPath,      'capybara/xpath'
+  autoload :Searchable, 'capybara/searchable'
+  autoload :VERSION,    'capybara/version'
+  
+  module Driver
+    autoload :Base,     'capybara/driver/base'
+    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.run_server = true
+Capybara.default_selector = :xpath
+Capybara.default_wait_time = 2
+Capybara.ignore_hidden_elements = false

data/lib/capybara/cucumber.rb

@@ -0,0 +1,32 @@
+require 'capybara'
+require 'capybara/dsl'
+
+World(Capybara)
+
+After do
+  Capybara.reset_sessions!
+end
+
+Before('@javascript') do
+  Capybara.current_driver = Capybara.javascript_driver
+end
+
+Before('@selenium') do
+  Capybara.current_driver = :selenium
+end
+
+Before('@celerity') do
+  Capybara.current_driver = :celerity
+end
+
+Before('@culerity') do
+  Capybara.current_driver = :culerity
+end
+
+Before('@rack_test') do
+  Capybara.current_driver = :rack_test
+end
+
+After do
+  Capybara.use_default_driver
+end

data/lib/capybara/driver/base.rb

@@ -0,0 +1,48 @@
+class Capybara::Driver::Base
+  def current_url
+    raise NotImplementedError
+  end
+
+  def visit(path)
+    raise NotImplementedError
+  end
+
+  def find(query)
+    raise NotImplementedError
+  end
+
+  def evaluate_script(script)
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def wait?
+    false
+  end
+
+  def wait_until *args
+  end
+
+  def response_headers
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def body
+    raise NotImplementedError
+  end
+
+  def within_frame(frame_id)
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def source
+    raise NotImplementedError
+  end
+
+  def cleanup!
+  end
+
+  def has_shortcircuit_timeout?
+    false
+  end
+
+end

data/lib/capybara/driver/celerity_driver.rb

@@ -0,0 +1,143 @@
+class Capybara::Driver::Celerity < Capybara::Driver::Base
+  class Node < Capybara::Node
+    def text
+      node.text
+    end
+
+    def [](name)
+      value = if name.to_sym == :class
+        node.class_name
+      else
+        node.send(name.to_sym)
+      end
+      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)
+      node.set(value)
+    end
+
+    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
+      node.click
+    end
+
+    def drag_to(element)
+      node.fire_event('mousedown')
+      element.node.fire_event('mousemove')
+      element.node.fire_event('mouseup')
+    end
+
+    def tag_name
+      # FIXME: this might be the dumbest way ever of getting the tag name
+      # there has to be something better...
+      node.to_xml[/^\s*<([a-z0-9\-\:]+)/, 1]
+    end
+
+    def visible?
+      node.visible?
+    end
+
+    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
+
+  attr_reader :app, :rack_server
+
+  def initialize(app)
+    @app = app
+    @rack_server = Capybara::Server.new(@app)
+    @rack_server.boot if Capybara.run_server
+  end
+
+  def visit(path)
+    browser.goto(url(path))
+  end
+
+  def current_url
+    browser.url
+  end
+  
+  def source
+    browser.html
+  end
+
+  def body
+    browser.document.as_xml
+  end
+
+  def response_headers
+    browser.response_headers
+  end
+
+  def find(selector)
+    browser.elements_by_xpath(selector).map { |node| Node.new(self, node) }
+  end
+
+  def wait?; true; end
+
+  def evaluate_script(script)
+    browser.execute_script "#{script}"
+  end
+
+  def browser
+    unless @_browser
+      require 'celerity'
+      @_browser = ::Celerity::Browser.new(:browser => :firefox, :log_level => :off)
+    end
+
+    @_browser
+  end
+
+private
+
+  def url(path)
+    rack_server.url(path)
+  end
+
+end