capybara-mechanize 0.1.0

data/README.mdown

@@ -0,0 +1,51 @@
+Capybara-mechanize
+==================
+
+This gems makes it possible to use Capybara for (partially) remote testing. It inherits most functionality from the RackTest driver and only uses [Mechanize](http://github.com/tenderlove/mechanize) for remote requests. 
+
+It is currently in use to test the integration between a Rails application and Twitter authorization and sharing.
+
+This gem is a [Capybara](http://github.com/jnicklas/capybara) extension. I have been inspired by the Capybara driver and some earlier efforts for a Mechanize driver.
+
+Thanks to [Pinkelstar](http://www.pinkelstar.com) for giving me the time and the need to develop this gem.
+
+### Installation
+
+    gem install capybara-mechanize
+
+### Usage without Cucumber
+
+    require 'capybara/mechanize'
+
+### Usage with Cucumber and tags
+
+A @mechanize tag is added to your hooks when you add the following line to your env.rb
+
+    require 'capybara/mechanize/cucumber'
+
+The following scenario will then be using the Mechanize driver
+
+    @mechanize
+    Scenario: do something remote
+      When I click the remote link
+
+Todo
+----
+* Make the redirect specs pass 
+* Add specs for local to remote redirect (functionality is there though and works in our case)
+* Test this driver with non-rack/non-ruby projects
+
+Note on Patches/Pull Requests
+-----------------------------
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+Copyright
+---------
+Copyright (c) 2010 Jeroen van Dijk. See LICENSE for details.

data/lib/capybara/driver/mechanize.rb

@@ -0,0 +1,67 @@
+require 'mechanize'
+
+class Capybara::Driver::Mechanize < Capybara::Driver::RackTest
+  
+  def initialize(*args)
+    super
+    @agent = ::Mechanize.new
+  end
+  
+  def visit(url)
+    get url
+  end
+  
+  def response
+    response_proxy || super
+  end
+  
+  def get(url, params = {}, headers = {})
+    process_remote_request(:get, url) || super
+  end
+
+  def post(url, params = {}, headers = {})
+    process_remote_request(:post, url, params, headers) || super
+  end
+
+  def remote?(url)
+    if !Capybara.app_host.nil? 
+      true
+    elsif Capybara.default_host.nil?
+      false
+    else
+      host = URI.parse(url).host
+      !(host.nil? || host.include?(Capybara.default_host))
+    end
+  end
+
+  private
+
+  def process_remote_request(method, url, *options)
+    if remote?(url)
+      reset_cache
+      @agent.send *( [method, url] + options)
+      follow_redirects!
+      true
+    end
+  end
+
+  def response_proxy
+    ResponseProxy.new(@agent.current_page) if @agent.current_page
+  end
+  
+  class ResponseProxy
+    def initialize(page)
+      @page = page
+    end
+    
+    def redirect?
+      %w(301 302).include?(@page.code)
+    end
+    
+    def method_missing(method, *args, &block)
+      @page.send(method, *args, &block)
+    end
+    
+  end 
+   
+end

data/lib/capybara/mechanize.rb

@@ -0,0 +1 @@
+require 'capybara/driver/mechanize'

data/lib/capybara/mechanize/cucumber.rb

@@ -0,0 +1,5 @@
+require 'capybara/mechanize'
+
+Before('@mechanize') do
+  Capybara.current_driver = :mechanize
+end

data/spec/driver/mechanize_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+describe Capybara::Driver::Mechanize do
+  before do
+    @driver = Capybara::Driver::Mechanize.new(TestApp)
+  end
+  
+  it "should throw an error when no rack app is given" do
+    running do
+      Capybara::Driver::Mechanize.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"
+
+  # Pending:
+  # it_should_behave_like "driver with infinite redirect detection"
+
+
+  it "should default to local mode" do
+    @driver.remote?('http://www.local.com').should be false
+  end
+  
+  context "with an app_host" do
+    
+    before do
+      Capybara.app_host = 'remote.com'
+    end
+    
+    after do
+      Capybara.app_host = nil
+    end
+
+    it "should treat urls as remote" do
+      @driver.remote?('http://www.remote.com').should be true
+    end
+  end
+  
+  context "with a default url, no app host" do
+    before :each do
+      Capybara.default_host = 'local.com'
+    end
+    
+    it "should treat urls with the same host names as local" do
+      @driver.remote?('http://www.local.com').should be false
+    end
+    
+    it "should treat other urls as remote" do
+      @driver.remote?('http://www.remote.com').should be true
+    end
+    
+    after :each do
+      Capybara.default_host = nil
+    end
+  end
+
+end

data/spec/session/mechanize_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe Capybara::Session do
+  context 'with mechanize driver' do
+    before do
+      @session = Capybara::Session.new(:mechanize, TestApp)
+    end
+
+    describe '#driver' do
+      it "should be a mechanize driver" do
+        @session.driver.should be_an_instance_of(Capybara::Driver::Mechanize)
+      end
+    end
+
+    describe '#mode' do
+      it "should remember the mode" do
+        @session.mode.should == :mechanize
+      end
+    end
+
+    describe '#click_link' do
+      it "should use data-method if available" do
+        @session.visit "/with_html"
+        @session.click_link "A link with data-method"
+        @session.body.should == 'The requested object was deleted'
+      end
+    end
+
+    it_should_behave_like "session"
+    it_should_behave_like "session without javascript support"
+    it_should_behave_like "session with headers support"
+    it_should_behave_like "session with status code support"
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color --backtrace

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'capybara'
+require 'capybara/mechanize'
+
+require 'sinatra'
+require 'spec'
+
+# TODO move this stuff into capybara
+require 'capybara/spec/driver'
+require 'capybara/spec/session'
+
+alias :running :lambda
+
+Capybara.default_wait_time = 0 # less timeout so tests run faster
+
+Spec::Runner.configure do |config|
+  config.after do
+    Capybara.default_selector = :xpath
+  end
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification 
+name: capybara-mechanize
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Jeroen van Dijk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-12 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: capybara
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 0
+        - 3
+        - 9
+        version: 0.3.9
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id003
+description: RackTest driver for Capybara, but with remote request support thanks to mechanize
+email: jeroen@jeevidee.nl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/capybara/driver/mechanize.rb
+- lib/capybara/mechanize/cucumber.rb
+- lib/capybara/mechanize.rb
+- spec/driver/mechanize_spec.rb
+- spec/session/mechanize_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- README.mdown
+has_rdoc: true
+homepage: http://github.com/jeroenvandijk/capybara-mechanize
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: RackTest driver for Capybara with remote request support
+test_files: []
+