capybara 0.1

data/lib/capybara/rails.rb

@@ -0,0 +1,11 @@
+require 'capybara'
+require 'capybara/dsl'
+
+Capybara.app = Rack::Builder.new do
+  map "/" do
+    use Rails::Rack::Static
+    run ActionController::Dispatcher.new
+  end
+end.to_app 
+
+Capybara.asset_root = Rails.root.join('public')

data/lib/capybara/save_and_open_page.rb

@@ -0,0 +1,25 @@
+module Capybara
+  module SaveAndOpenPage
+    extend(self)
+
+    def save_and_open_page(html)
+      require 'tempfile'
+      tempfile = Tempfile.new("capybara#{rand(1000000)}")
+      tempfile.write(rewrite_css_and_image_references(html))
+      tempfile.close
+      open_in_browser(tempfile.path)
+    end
+
+    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
+      response_html.gsub(/("|')\/(stylesheets|images)/, '\1' + Capybara.asset_root + '/\2')
+    end
+  end
+end

data/lib/capybara/server.rb

@@ -0,0 +1,53 @@
+require 'net/http'
+require 'rack'
+
+class Capybara::Server
+  attr_reader :app
+  
+  def initialize(app)
+    @app = app
+  end
+  
+  def port
+    8080
+  end
+
+  def host
+    'localhost'
+  end
+
+  def url(path)
+    "http://#{host}:#{port}#{path}"
+  end
+  
+  def boot
+    Capybara.log "application has already booted" and return if responsive?
+    Capybara.log "booting Rack applicartion on port #{port}"
+    start_time = Time.now
+    Thread.new do
+      Rack::Handler::Mongrel.run @app, :Port => port
+    end
+    Capybara.log "checking if application has booted"
+    loop do
+      Capybara.log("application has booted") and break if responsive?
+      if Time.now - start_time > 10 
+        Capybara.log "Rack application timed out during boot"
+        exit
+      end
+      
+      Capybara.log '.'
+      sleep 1
+    end
+  end
+
+  def responsive?
+    res = Net::HTTP.start(host, port) { |http| http.get('/') }
+
+    if res.is_a?(Net::HTTPSuccess) or res.is_a?(Net::HTTPRedirection)
+      return true
+    end
+  rescue Errno::ECONNREFUSED 
+    return false
+  end
+
+end

data/lib/capybara/session.rb

@@ -0,0 +1,190 @@
+class Capybara::Session
+  attr_reader :mode, :app
+
+  def initialize(mode, app)
+    @mode = mode
+    @app = app
+  end
+
+  def driver
+    @driver ||= case mode
+    when :rack_test
+      Capybara::Driver::RackTest.new(app)
+    when :culerity
+      Capybara::Driver::Culerity.new(app)
+    when :selenium
+      Capybara::Driver::Selenium.new(app)
+    else
+      raise Capybara::DriverNotFoundError, "no driver called #{mode} was found"
+    end
+  end
+
+  def visit(path)
+    driver.visit(path)
+  end
+  
+  def click_link(locator)
+    find_link(locator).click
+  end
+
+  def click_button(locator)
+    find_button(locator).click
+  end
+
+  def fill_in(locator, options={})
+    find_field(locator, :text_field, :text_area, :password_field).set(options[:with])
+  end
+  
+  def choose(locator)
+    find_field(locator, :radio).set(true)
+  end
+  
+  def check(locator)
+    find_field(locator, :checkbox).set(true)
+  end
+  
+  def uncheck(locator)
+    find_field(locator, :checkbox).set(false)
+  end
+  
+  def select(value, options={})
+    find_field(options[:from], :select).select(value)
+  end
+  
+  def attach_file(locator, path)
+    find_field(locator, :file_field).set(path)
+  end
+
+  def body
+    driver.body
+  end
+  
+  def has_content?(content)
+    has_xpath?("//*[contains(.,'#{content}')]")
+  end
+  
+  def has_xpath?(path, options={})
+    results = find(path)
+    if options[:text]
+      results = filter_by_text(results, options[:text])
+    end
+    if options[:count]
+      results.size == options[:count]
+    else
+      results.size > 0
+    end
+  end
+  
+  def has_css?(path, options={})
+    has_xpath?(css_to_xpath(path), options)
+  end
+  
+  def within(kind, scope=nil)
+    kind, scope = :xpath, kind unless scope
+    scope = css_to_xpath(scope) if kind == :css
+    raise Capybara::ElementNotFound, "scope '#{scope}' not found on page" if find(scope).empty?
+    scopes.push(scope)
+    yield
+    scopes.pop
+  end
+  
+  def save_and_open_page
+    require 'capybara/save_and_open_page'
+    Capybara::SaveAndOpenPage.save_and_open_page(body)
+  end
+
+  def find_field(locator, *kinds)
+    kinds = FIELDS_PATHS.keys if kinds.empty?
+    field = find_field_by_id(locator, *kinds) || find_field_by_label(locator, *kinds)
+    raise Capybara::ElementNotFound, "no field of kind #{kinds.inspect} with id or label '#{locator}' found" unless field
+    field
+  end
+  alias_method :field_labeled, :find_field
+  
+  def find_link(locator)
+    link = find_element("//a[@id='#{locator}']", "//a[contains(.,'#{locator}')]", "//a[@title='#{locator}']")
+    raise Capybara::ElementNotFound, "no link with title, id or text '#{locator}' found" unless link
+    link
+  end
+  
+  def find_button(locator)
+    button = find_element(
+      "//input[@type='submit'][@id='#{locator}']",
+      "//input[@type='submit'][@value='#{locator}']",
+      "//input[@type='image'][@id='#{locator}']",
+      "//input[@type='image'][@value='#{locator}']"
+    )
+    raise Capybara::ElementNotFound, "no button with value or id '#{locator}' found" unless button
+    button
+  end
+
+private
+
+  def css_to_xpath(css)
+    Nokogiri::CSS.xpath_for(css).first
+  end
+
+  def filter_by_text(nodes, text)
+    nodes.select do |node|
+      case text
+      when String
+        node.text.include?(text)
+      when Regexp
+        node.text =~ text
+      end
+    end
+  end
+
+  def current_scope
+    scopes.join('')
+  end
+
+  def scopes
+    @scopes ||= []
+  end
+
+  FIELDS_PATHS = {
+    :text_field => proc { |id| "//input[@type='text'][@id='#{id}']" },
+    :text_area => proc { |id| "//textarea[@id='#{id}']" },
+    :password_field => proc { |id| "//input[@type='password'][@id='#{id}']" },
+    :radio => proc { |id| "//input[@type='radio'][@id='#{id}']" },
+    :hidden_field => proc { |id| "//input[@type='hidden'][@id='#{id}']" },
+    :checkbox => proc { |id| "//input[@type='checkbox'][@id='#{id}']" },
+    :select => proc { |id| "//select[@id='#{id}']" },
+    :file_field => proc { |id| "//input[@type='file'][@id='#{id}']" }
+  }
+
+  def find_field_by_id(locator, *kinds)
+    kinds.each do |kind|
+      path = FIELDS_PATHS[kind]
+      element = find(path.call(locator)).first
+      return element if element
+    end
+    return nil
+  end
+
+  def find_field_by_label(locator, *kinds)
+    kinds.each do |kind|
+      label = find("//label[contains(.,'#{locator}')]").first
+      if label
+        element = find_field_by_id(label[:for], kind)
+        return element if element
+      end
+    end
+    return nil
+  end
+
+  def find_element(*locators)
+    locators.each do |locator|
+      element = find(locator).first
+      return element if element
+    end
+    return nil
+  end
+  
+  def find(locator)
+    locator = current_scope.to_s + locator
+    driver.find(locator)
+  end
+  
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/capybara.rb'}"
+puts "Loading capybara gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/spec/driver/culerity_driver_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::Culerity do
+  before do
+    @driver = Capybara::Driver::Culerity.new(TestApp)
+  end
+  
+  it_should_behave_like "driver"
+  it_should_behave_like "driver with javascript support"
+end

data/spec/driver/firewatir_driver_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::FireWatir do
+  before do
+    @driver = Capybara::Driver::FireWatir.new(TestApp)
+  end
+  
+  # it_should_behave_like "driver"
+  # it_should_behave_like "driver with javascript support"
+end

data/spec/driver/rack_test_driver_spec.rb

@@ -0,0 +1,9 @@
+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_behave_like "driver"
+end

data/spec/driver/safariwarit_driver_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::SafariWatir do
+  before do
+    @driver = Capybara::Driver::SafariWatir.new(TestApp)
+  end
+  
+  # it_should_behave_like "driver"
+  # it_should_behave_like "driver with javascript support"
+end

data/spec/driver/selenium_driver_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Capybara::Driver::Selenium do
+  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/drivers_spec.rb

@@ -0,0 +1,72 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+
+shared_examples_for 'driver' do
+
+  describe '#visit' do
+    it "should move to another page" do
+      @driver.visit('/')
+      @driver.body.should include('Hello world!')
+      @driver.visit('/foo')
+      @driver.body.should include('Another World')
+    end
+  end
+
+  describe '#body' do
+    it "should return text reponses" do
+      @driver.visit('/')
+      @driver.body.should include('Hello world!')
+    end
+
+    it "should return the full response html" do
+      @driver.visit('/with_simple_html')
+      @driver.body.should include('<h1>Bar</h1>')
+    end
+  end
+
+  describe '#find' do
+    context "with xpath selector" do
+      before 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'
+      end
+      
+      it "should extract node attributes" do
+        @driver.find('//a')[0][:href].should == '/with_simple_html'
+        @driver.find('//a')[0][:class].should == 'simple'
+        @driver.find('//a')[1][:href].should == '/foo'
+        @driver.find('//a')[1][:id].should == 'foo'
+        @driver.find('//a')[1][:rel].should be_nil
+      end
+
+      it "should allow assignment of field value" do
+        @driver.find('//input').first.value.should == 'monkey'
+        @driver.find('//input').first.set('gorilla')
+        @driver.find('//input').first.value.should == 'gorilla'
+      end
+      
+      it "should extract node tag name" do
+        @driver.find('//a')[0].tag_name.should == 'a'
+        @driver.find('//a')[1].tag_name.should == 'a'
+        @driver.find('//p')[1].tag_name.should == 'p'
+      end
+    end
+  end
+
+end
+
+shared_examples_for "driver with javascript support" do
+  describe '#find' do
+    it "should find dynamically changed nodes" do
+      @driver.visit('/with_js')
+      @driver.find('//p').first.text.should == 'I changed it'
+    end
+  end
+end