capybara-webkit 0.1.0

data/.gitignore

@@ -0,0 +1,13 @@
+*.swp
+bin
+*.swo
+*~
+*.o
+*.moc
+Makefile*
+qrc_*
+*.xcodeproj
+*.app
+moc_*.cpp
+.bundle
+pkg

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+gem "rake"
+gem "rspec", :require => false
+gem "capybara"
+gem "sinatra", :require => false
+

data/Gemfile.lock

@@ -0,0 +1,55 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    capybara (0.4.1.2)
+      celerity (>= 0.7.9)
+      culerity (>= 0.2.4)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (>= 0.0.27)
+      xpath (~> 0.1.3)
+    celerity (0.8.8)
+    childprocess (0.1.7)
+      ffi (~> 0.6.3)
+    culerity (0.2.15)
+    diff-lcs (1.1.2)
+    ffi (0.6.3)
+      rake (>= 0.8.7)
+    json_pure (1.5.1)
+    mime-types (1.16)
+    nokogiri (1.4.4)
+    rack (1.2.1)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+    rubyzip (0.9.4)
+    selenium-webdriver (0.1.3)
+      childprocess (~> 0.1.5)
+      ffi (~> 0.6.3)
+      json_pure
+      rubyzip
+    sinatra (1.1.2)
+      rack (~> 1.1)
+      tilt (~> 1.2)
+    tilt (1.2.2)
+    xpath (0.1.3)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capybara
+  rake
+  rspec
+  sinatra

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 thoughtbot, inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,37 @@
+capybara-webkit
+===============
+
+A [capybara](https://github.com/jnicklas/capybara) driver that uses [WebKit](http://webkit.org) via [QtWebKit](http://doc.qt.nokia.com/4.7/qtwebkit.html).
+
+Dependencies
+------------
+
+capybara-webkit depends on a WebKit implementation from Qt, a cross-platform development toolkit. You'll need to download Qt to build and install the gem.
+
+* [Download Qt](http://qt.nokia.com/downloads/downloads)
+
+Usage
+-----
+
+Add the capybara-webkit gem to your Gemfile:
+
+    gem "capybara-webkit"
+
+Set your Capybara Javascript driver to webkit:
+
+    Capybara.javascript_driver = :webkit
+
+Tag scenarios with @javascript to run them using a headless WebKit browser.
+
+About
+-----
+
+The capybara WebKit driver was written by Joe Ferris, Tristan Dunn, and Jason Morrison from [thoughtbot, inc](http://thoughtbot.com/community).
+
+The names and logos for thoughtbot are trademarks of thoughtbot, inc.
+
+License
+-------
+
+capybara-webkit is Copyright © 2011 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.
+

data/Rakefile

@@ -0,0 +1,76 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'fileutils'
+require 'rspec/core/rake_task'
+require 'rake/gempackagetask'
+
+desc "Generate a Makefile using qmake"
+file 'Makefile' do
+  sh("qmake -spec macx-g++")
+end
+
+desc "Regenerate dependencies using qmake"
+task :qmake => 'Makefile' do
+  sh("make qmake")
+end
+
+desc "Build the webkit server"
+task :build => :qmake do
+  sh("make")
+
+  FileUtils.mkdir("bin") unless File.directory?("bin")
+
+  if File.exist?("src/webkit_server.app")
+    FileUtils.cp("src/webkit_server.app/Contents/MacOS/webkit_server", "bin")
+  else
+    FileUtils.cp("src/webkit_server", "bin")
+  end
+end
+
+file 'bin/webkit_server' => :build
+
+unless ENV["BUILD"]
+  RSpec::Core::RakeTask.new do |t|
+    t.pattern = "spec/**/*_spec.rb"
+    t.rspec_opts = "--format progress"
+  end
+
+  desc "Default: build and run all specs"
+  task :default => [:build, :spec]
+
+  eval("$specification = begin; #{IO.read('capybara-webkit.gemspec')}; end")
+  Rake::GemPackageTask.new($specification) do |package|
+    package.need_zip = true
+    package.need_tar = true
+  end
+
+  desc "Generate a new command called NAME"
+  task :generate_command do
+    name = ENV['NAME'] or raise "Provide a name with NAME="
+
+    header = "src/#{name}.h"
+    source = "src/#{name}.cpp"
+
+    %w(h cpp).each do |extension|
+      File.open("templates/Command.#{extension}", "r") do |source_file|
+        contents = source_file.read
+        contents.gsub!("NAME", name)
+        File.open("src/#{name}.#{extension}", "w") do |target_file|
+          target_file.write(contents)
+        end
+      end
+    end
+
+    Dir.glob("src/*.pro").each do |project_file_name|
+      project = IO.read(project_file_name)
+      project.gsub!(/^(HEADERS = .*)/, "\\1 #{name}.h")
+      project.gsub!(/^(SOURCES = .*)/, "\\1 #{name}.cpp")
+      File.open(project_file_name, "w") { |file| file.write(project) }
+    end
+
+    File.open("src/find_command.h", "a") do |file|
+      file.write("CHECK_COMMAND(#{name})")
+    end
+  end
+end
+

data/capybara-webkit.gemspec

@@ -0,0 +1,15 @@
+Gem::Specification.new do |s|
+  s.name = "capybara-webkit"
+  s.version = "0.1.0"
+  s.authors = ["thoughtbot", "Joe Ferris", "Jason Morrison", "Tristan Dunn"]
+  s.email = "support@thoughtbot.com"
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {spec,features}/*`.split("\n")
+  s.homepage = "http://github.com/thoughtbot/capybara-webkit"
+  s.require_path = "lib"
+  s.rubygems_version = "1.3.5"
+  s.summary = "Headless Webkit driver for Capybara"
+  s.add_runtime_dependency "capybara", "~> 0.4.1"
+  s.extensions = "extconf.rb"
+end
+

data/extconf.rb

@@ -0,0 +1,2 @@
+system("rake build BUILD=true")
+

data/lib/capybara-webkit.rb

@@ -0,0 +1,7 @@
+require "capybara"
+require "capybara/driver/webkit"
+
+Capybara.register_driver :webkit do |app|
+  Capybara::Driver::Webkit.new(app)
+end
+

data/lib/capybara/driver/webkit.rb

@@ -0,0 +1,84 @@
+require "capybara"
+require "capybara/driver/webkit/node"
+require "capybara/driver/webkit/browser"
+
+class Capybara::Driver::Webkit
+  class WebkitError < StandardError
+  end
+
+  attr_reader :browser
+
+  def initialize(app, options={})
+    @app = app
+    @options = options
+    @rack_server = Capybara::Server.new(@app)
+    @rack_server.boot if Capybara.run_server
+    @browser = options[:browser] || Browser.new
+  end
+
+  def current_url
+    browser.url
+  end
+
+  def visit(path)
+    browser.visit(url(path))
+  end
+
+  def find(query)
+    browser.find(query).map { |native| Node.new(self, native) }
+  end
+
+  def source
+    browser.source
+  end
+
+  def body
+    source
+  end
+
+  def execute_script(script)
+    browser.execute_script script
+  end
+
+  def evaluate_script(script)
+    browser.evaluate_script script
+  end
+
+  def response_headers
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def status_code
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def within_frame(frame_id)
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def within_window(handle)
+    raise Capybara::NotSupportedByDriverError
+  end
+
+  def wait?
+    false
+  end
+
+  def wait_until(*args)
+  end
+
+  def reset!
+    browser.reset!
+  end
+
+  def has_shortcircuit_timeout?
+    false
+  end
+
+  private
+
+  def url(path)
+    @rack_server.url(path)
+  end
+end
+

data/lib/capybara/driver/webkit/browser.rb

@@ -0,0 +1,86 @@
+require 'socket'
+require 'capybara/util/timeout'
+require 'json'
+
+class Capybara::Driver::Webkit
+  class Browser
+    def initialize(options = {})
+      @socket_class = options[:socket_class] || TCPSocket
+      start_server
+      connect
+    end
+
+    def visit(url)
+      command "Visit", url
+    end
+
+    def find(query)
+      command("Find", query).split(",")
+    end
+
+    def reset!
+      command("Reset")
+    end
+
+    def source
+      command("Source")
+    end
+
+    def url
+      command("Url")
+    end
+
+    def command(name, *args)
+      @socket.puts name
+      @socket.puts args.size
+      args.each do |arg|
+        @socket.puts arg.to_s.bytesize
+        @socket.print arg
+      end
+      check
+      read_response
+    end
+
+    def evaluate_script(script)
+      json = command('Evaluate', script)
+      JSON.parse("[#{json}]").first
+    end
+
+    def execute_script(script)
+      command('Execute', script)
+    end
+
+    private
+
+    def start_server
+      server_path = File.expand_path("../../../../../bin/webkit_server", __FILE__)
+      @pid = fork { exec(server_path) }
+      at_exit { Process.kill("INT", @pid) }
+    end
+
+    def connect
+      Capybara.timeout(5) do
+        attempt_connect
+        !@socket.nil?
+      end
+    end
+
+    def attempt_connect
+      @socket = @socket_class.open("localhost", 9200)
+    rescue Errno::ECONNREFUSED
+    end
+
+    def check
+      result = @socket.gets.strip
+
+      unless result == 'ok'
+        raise WebkitError, read_response
+      end
+    end
+
+    def read_response
+      response_length = @socket.gets.to_i
+      @socket.read(response_length)
+    end
+  end
+end

data/lib/capybara/driver/webkit/node.rb

@@ -0,0 +1,87 @@
+class Capybara::Driver::Webkit
+  class Node < Capybara::Driver::Node
+    def text
+      invoke "text"
+    end
+
+    def [](name)
+      value = invoke("attribute", name)
+      if name == 'checked'
+        value == 'true'
+      else
+        value
+      end
+    end
+
+    def value
+      if multiple_select?
+        self.find(".//option").select do |option|
+          option["selected"] == "selected"
+        end.map do |option|
+          option.value
+        end
+      else
+        invoke "value"
+      end
+    end
+
+    def set(value)
+      invoke "set", value
+    end
+
+    def select_option
+      invoke "selectOption"
+    end
+
+    def unselect_option
+      invoke "unselectOption"
+    end
+
+    def click
+      invoke "click"
+    end
+
+    def drag_to(element)
+      trigger('mousedown')
+      element.trigger('mousemove')
+      element.trigger('mouseup')
+    end
+
+    def tag_name
+      invoke "tagName"
+    end
+
+    def visible?
+      invoke("visible") == "true"
+    end
+
+    def path
+      raise NotSupportedByDriverError
+    end
+
+    def trigger(event)
+      invoke "trigger", event
+    end
+
+    def find(xpath)
+      invoke("findWithin", xpath).split(',').map do |native|
+        self.class.new(driver, native)
+      end
+    end
+
+    def invoke(name, *args)
+      browser.command "Node", name, native, *args
+    end
+
+    def browser
+      driver.browser
+    end
+
+    private
+
+    def multiple_select?
+      self.tag_name == "select" && self["multiple"] == "multiple"
+    end
+  end
+end
+