bjeanes-capybara 0.3.1

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/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

@@ -0,0 +1,13 @@
+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"
+  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

@@ -0,0 +1,12 @@
+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"
+  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,26 @@
+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"
+    Capybara.run_server = false
+  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://elabs.se/contact')
+    @driver.body.should include('Edithouse eLabs AB')
+  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

@@ -0,0 +1,12 @@
+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"
+  it_should_behave_like "driver without node path support"
+  
+end

data/spec/drivers_spec.rb

@@ -0,0 +1,139 @@
+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
+    
+    it "should show the correct URL" do
+      @driver.visit('/foo')
+      @driver.current_url.should include('/foo')
+    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('Bar')
+    end
+  end
+
+  describe '#find' do
+    context "with xpath selector" do
+      before do
+        @driver.visit('/with_html')
+      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 extract boolean node attributes" do
+        @driver.find('//input[@id="checked_field"]')[0][:checked].should be_true
+      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
+      
+      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
+
+end
+
+shared_examples_for "driver with javascript support" do
+  before { @driver.visit('/with_js') }
+
+  describe '#find' do
+    it "should find dynamically changed nodes" do
+      @driver.find('//p').first.text.should == 'I changed it'
+    end
+  end
+
+  describe '#drag_to' do
+    it "should drag and drop an object" do
+      draggable = @driver.find('//div[@id="drag"]').first
+      droppable = @driver.find('//div[@id="drop"]').first
+      draggable.drag_to(droppable)
+      @driver.find('//div[contains(., "Dropped!")]').should_not be_nil
+    end
+  end
+
+  describe "#evaluate_script" do
+    it "should return the value of the executed script" do
+      @driver.evaluate_script('1+1').should == 2
+    end
+  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,69 @@
+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 "with css selectors" do
+      it "should find the first element using the given locator" do
+        @session.all(:css, 'h1').first.text.should == 'This is a test'
+        @session.all(:css, "input[id='test_field']").first[:value].should == 'monkey'
+      end
+    end
+
+    context "with xpath selectors" do
+      it "should find the first element using the given locator" do
+        @session.all(:xpath, '//h1').first.text.should == 'This is a test'
+        @session.all(:xpath, "//input[@id='test_field']").first[:value].should == 'monkey'
+      end
+    end
+
+    context "with css as default selector" do
+      before { Capybara.default_selector = :css }
+      it "should find the first element using the given locator" do
+        @session.all('h1').first.text.should == 'This is a test'
+        @session.all("input[id='test_field']").first[:value].should == 'monkey'
+      end
+      after { Capybara.default_selector = :xpath }
+    end
+
+    context "with visible filter" do
+      after { Capybara.ignore_hidden_elements = false }
+      it "should only find visible nodes" do
+        @session.all("//a[@title='awesome title']").should have(2).elements
+        @session.all("//a[@title='awesome title']", :visible => true).should have(1).elements
+        Capybara.ignore_hidden_elements = true
+        @session.all("//a[@title='awesome title']").should have(1).elements
+      end
+    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

data/spec/dsl/attach_file_spec.rb

@@ -0,0 +1,64 @@
+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

data/spec/dsl/check_spec.rb

@@ -0,0 +1,39 @@
+module CheckSpec
+  shared_examples_for "check" do
+  
+    describe "#check" do
+      before do
+        @session.visit('/form')
+      end
+      
+      describe "'checked' attribute" do
+        it "should be true if checked" do
+          @session.check("Terms of Use")
+          @session.find(:xpath, "//input[@id='form_terms_of_use']")['checked'].should be_true
+        end
+        
+        it "should be false if unchecked" do
+          @session.find(:xpath, "//input[@id='form_terms_of_use']")['checked'].should be_false
+        end
+      end
+
+      it "should check a checkbox by id" do
+        @session.check("form_pets_cat")
+        @session.click_button('awesome')
+        extract_results(@session)['pets'].should include('dog', 'cat', 'hamster')
+      end
+
+      it "should check a checkbox by label" do
+        @session.check("Cat")
+        @session.click_button('awesome')
+        extract_results(@session)['pets'].should include('dog', 'cat', 'hamster')
+      end
+
+      context "with a locator that doesn't exist" do
+        it "should raise an error" do
+          running { @session.check('does not exist') }.should raise_error(Capybara::ElementNotFound)
+        end
+      end
+    end
+  end
+end