otherinbox-capybara-webkit 0.12.0

data/.gitignore

@@ -0,0 +1,19 @@
+*.swp
+bin/webkit_server*
+*.swo
+*~
+*.o
+*.moc
+Makefile*
+qrc_*
+*.xcodeproj
+*.app
+moc_*.cpp
+.bundle
+pkg
+src/webkit_server
+src/webkit_server.exe
+.DS_Store
+tmp
+.rvmrc
+src/debug

data/.rspec

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

data/Appraisals

@@ -0,0 +1,7 @@
+appraise "1.0" do
+  gem "capybara", "~> 1.0.0"
+end
+
+appraise "1.1" do
+  gem "capybara", "~> 1.1.0"
+end

data/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+We love pull requests. Here's a quick guide:
+
+Dependencies
+
+Some of the tests depend on the `identify` command that comes with Imagemagick.
+Imagemagick can be installed via [homebrew](http://mxcl.github.com/homebrew/).
+
+    brew install imagemagick
+
+Contributing
+
+1. Fork the repo.
+
+2. Run the tests. We only take pull requests with passing tests, and it's great
+to know that you have a clean slate: `bundle && bundle exec rake`
+
+3. Add a test for your change. Only refactoring and documentation changes
+require no new tests. If you are adding functionality or fixing a bug, we need
+a test!
+
+4. Make the test pass.
+
+5. Push to your fork and submit a pull request.
+
+
+At this point you're waiting on us. We like to at least comment on, if not
+accept, pull requests within three business days (and, typically, one business
+day). We may suggest some changes or improvements or alternatives.
+
+Some things that will increase the chance that your pull request is accepted,
+taken straight from the Ruby on Rails guide:
+
+* Use Rails idioms and helpers
+* Include tests that fail without your code, and pass with it
+* Update the documentation, the surrounding one, examples elsewhere, guides,
+  whatever is affected by your contribution
+
+Syntax:
+
+* Two spaces, no tabs.
+* No trailing whitespace. Blank lines should not have any space.
+* Prefer &&/|| over and/or.
+* MyClass.my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
+* a = b and not a=b.
+* Follow the conventions you see used in the source already.
+
+And in case we didn't emphasize it enough: we love tests!

data/ChangeLog

@@ -0,0 +1,70 @@
+2012-03-09  Joe Ferris  <jferris@thoughtbot.com>
+  * node.rb, driver_spec.rb: Allow interaction with invisible elements
+
+2012-03-02  Joe Ferris  <jferris@thoughtbot.com>
+  * browser.rb: Use Timeout from stdlib since Capybara.timeout is being removed
+
+2012-03-02  Matthew Mongeau  <halogenandtoast@gmail.com>
+  * capybara_webkit_builder.rb:
+	set LANG to en_US.UTF-8 to prevent string encoding issues during install
+
+2012-03-02  Marc Schwieterman
+  * Rakefile: pro, find_command, and CommandFactory are more structured
+
+2012-02-27  Joe Ferris  <jferris@thoughtbot.com>
+  * README.md: Fixed broken wiki link
+
+2012-02-24  Joe Ferris  <jferris@thoughtbot.com>
+  * README.md: Update instructions for platform specific installation issues
+
+2012-02-17  Matthew Mongeau  <halogenandtoast@gmail.com>
+  * driver_spec.rb, capybara.js: Send proper keycode during keypress event
+
+2012-02-17  Matthew Mongeau  <halogenandtoast@gmail.com>
+  * ChangeLog, version.rb:
+	Bump to 0.10.0
+
+2012-02-17  Marc Schwieterman
+  * driver_spec.rb, Reset.cpp, Reset.h: Reset history when resetting session.
+	* driver_spec.rb, webkit.rb, browser.rb, CommandFactory.cpp, CurrentUrl.cpp,
+	CurrentUrl.h, find_command.h, webkit_server.pro:
+	current_url now conforms more closely to the behavior of Selenium.
+
+2012-02-17  Igor Zubkov  <igor.zubkov@gmail.com>
+  * spec_helper.rb: Fix typo.
+
+2012-02-17  Matthew Mongeau  <halogenandtoast@gmail.com>
+  * capybara_webkit_builder.rb, capybara_webkit_builder_spec.rb,
+	spec_helper.rb:
+	Allow for overriding MAKE, QMAKE, and SPEC options via the environment.
+
+2012-02-12  Jason Petersen  <jasonmp85@gmail.com>
+  * driver_spec.rb, node.rb, capybara.js:
+	Selected attribute is no longer removed when selecting/deselecting. Only the
+	property is changed.
+
+2012-02-09  Gabe Berke-Williams  <gabe@thoughtbot.com>
+  * capybara-webkit.gemspec: Note capybara-webkit's usage of Sinatra.
+
+2012-02-03  Matthew Mongeau  <halogenandtoast@gmail.com>
+  * version.rb:
+	Bump to 0.9.0
+
+2012-02-01  Joe Ferris  <jferris@thoughtbot.com>
+	* driver_spec.rb, Connection.cpp, Connection.h:
+	Try to detect when a command starts a page load and wait for it to finish.
+
+2012-01-27  Matthew Mongeau  <halogenandtoast@gmail.com>
+	* driver_spec.rb, capybara.js: Trigger mousedown and mouseup events.
+	* driver_spec.rb, capybara.js: Simulate browser events more closely.
+
+2012-01-19  Marco Antonio  <marcofognog@gmail.com>
+	* node.rb, driver_spec.rb:
+	Raise ElementNotDisplayedError also for #drag_to and #select_option when they are invisible.
+
+2012-01-18  Marco Antonio  <marcofognog@gmail.com>
+	* node.rb, driver_spec.rb:
+	Raise error when an invisible element receives #click so it resembles a browser more closely.
+
+2012-01-15  Marc Schwieterman
+	* CONTRIBUTING.md: add imagemagick dependency to contributing guide.

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,68 @@
+PATH
+  remote: .
+  specs:
+    capybara-webkit (0.12.0)
+      capybara (>= 1.0.0, < 1.2)
+      json
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    appraisal (0.4.0)
+      bundler
+      rake
+    capybara (1.1.2)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (~> 2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.3.1)
+      ffi (~> 1.0.6)
+    diff-lcs (1.1.2)
+    ffi (1.0.11)
+    json (1.7.1)
+    mime-types (1.18)
+    mini_magick (3.2.1)
+      subexec (~> 0.0.4)
+    multi_json (1.0.4)
+    nokogiri (1.5.0)
+    nokogiri (1.5.0-x86-mingw32)
+    rack (1.3.2)
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    rubyzip (0.9.7)
+    selenium-webdriver (2.19.0)
+      childprocess (>= 0.2.5)
+      ffi (~> 1.0.9)
+      multi_json (~> 1.0.4)
+      rubyzip
+    sinatra (1.1.2)
+      rack (~> 1.1)
+      tilt (~> 1.2)
+    subexec (0.0.4)
+    tilt (1.2.2)
+    xpath (0.1.4)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+  x86-mingw32
+
+DEPENDENCIES
+  appraisal (~> 0.4.0)
+  capybara-webkit!
+  mini_magick
+  rake
+  rspec (~> 2.6.0)
+  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/NEWS.md

@@ -0,0 +1,36 @@
+New for 0.12.0:
+* Better windows support
+* Support for localStorage
+* Added support for oninput event
+* Added resize_window method
+* Server binds on LocalHost to prevent having to add firewall exceptions
+* Reuse NetworkAccessManager to prevent "too many open files" errors
+* Response messages are stored as QByteArray to prevent truncating content
+* Browser no longer tries to read empty responses (Fixes jruby issues).
+* Server will timeout if it can not start
+
+New for 0.11.0:
+
+* Allow interaction with invisible elements
+* Use Timeout from stdlib since Capybara.timeout is being removed
+
+New for 0.10.1:
+
+* LANG environment variable is set to en_US.UTF-8 in order to avoid string encoding issues from qmake.
+* pro, find_command, and CommandFactory are more structured.
+* Changed wiki link and directing platform specific issues to the google group.
+* Pass proper keycode value for keypress events.
+
+New for 0.10.0:
+
+* current_url now more closely matches the behavior of Selenium
+* custom MAKE, QMAKE, and SPEC options can be set from the environment
+* BUG: Selected attribute is no longer removed when selecting/deselecting. Only the property is changed.
+
+New for 0.9.0:
+
+* Raise an error when an invisible element receives #click.
+* Raise ElementNotDisplayedError for #drag_to and #select_option when element is invisible.
+* Trigger mousedown and mouseup events.
+* Model mouse events more closely to the browser.
+* Try to detech when a command starts a page load and wait for it to finish

data/README.md

@@ -0,0 +1,114 @@
+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).
+
+Qt Dependency and Installation Issues
+-------------
+
+capybara-webkit depends on a WebKit implementation from Qt, a cross-platform
+development toolkit. You'll need to download the Qt libraries to build and
+install the gem. You can find instructions for downloading and installing QT on
+the [capybara-webkit wiki](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit)
+
+Windows Support
+---------------
+
+Currently 32bit Windows will compile Capybara-webkit. Support for Windows is provided by the open source community and Windows related issues should be posted to the [mailing list](http://groups.google.com/group/capybara-webkit)
+
+Reporting Issues
+----------------
+
+Without access to your application code we can't easily debug most crashes or
+generic failures, so we've included a debug version of the driver that prints a
+log of what happened during each test. Before filing a crash bug, please see
+[Reporting Crashes](https://github.com/thoughtbot/capybara-webkit/wiki/Reporting-Crashes).
+You're much more likely to get a fix if you follow those instructions.
+
+If you are having compiling issues please check out the
+[capybara-webkit wiki](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit).
+If you don't have any luck there, please post to the
+[mailing list](http://groups.google.com/group/capybara-webkit). Please don't
+open a Github issue for a system-specific compiler issue.
+
+CI
+--
+
+If you're like us, you'll be using capybara-webkit on CI.
+
+On Linux platforms, capybara-webkit requires an X server to run, although it doesn't create any visible windows. Xvfb works fine for this. You can setup Xvfb yourself and set a DISPLAY variable, or try out the [headless gem](https://github.com/leonid-shevtsov/headless).
+
+Usage
+-----
+
+Add the capybara-webkit gem to your Gemfile:
+
+    gem "capybara-webkit"
+
+Set your Capybara Javascript driver to webkit:
+
+    Capybara.javascript_driver = :webkit
+
+In cucumber, tag scenarios with @javascript to run them using a headless WebKit browser.
+
+In RSpec, use the :js => true flag.
+
+Take note of the transactional fixtures section of the [capybara README](https://github.com/jnicklas/capybara/blob/master/README.md).
+
+If you're using capybara-webkit with Sinatra, don't forget to set
+
+    Capybara.app = MySinatraApp.new
+
+Non-Standard Driver Methods
+---------------------------
+
+capybara-webkit supports a few methods that are not part of the standard capybara API. You can access these by calling `driver` on the capybara session. When using the DSL, that will look like `page.driver.method_name`.
+
+**console_messages**: returns an array of messages printed using console.log
+
+    # In Javascript:
+    console.log("hello")
+    # In Ruby:
+    page.driver.console_messages
+    => {:source=>"http://example.com", :line_number=>1, :message=>"hello"}
+
+**error_messages**: returns an array of Javascript errors that occurred
+
+    page.driver.error_messages
+    => {:source=>"http://example.com", :line_number=>1, :message=>"SyntaxError: Parse error"}
+
+**resize_window**: change the viewport size to the given width and height
+
+    page.driver.resize_window(500, 300)
+    page.driver.evaluate_script("window.innerWidth")
+    => 500
+
+**render**: render a screenshot of the current view (requires [mini_magick](https://github.com/probablycorey/mini_magick) and [ImageMagick](http://www.imagemagick.org))
+
+    page.driver.render "tmp/screenshot.png"
+
+**cookies**: allows read-only access of cookies for the current session
+
+    page.driver.cookies["alpha"]
+    => "abc"
+
+Contributing
+------------
+
+See the CONTRIBUTING document.
+
+About
+-----
+
+The capybara WebKit driver is maintained by Joe Ferris and Matt Mongeau. It was written by [thoughtbot, inc](http://thoughtbot.com/community) with the help of numerous [contributions from the open source community](https://github.com/thoughtbot/capybara-webkit/contributors).
+
+Code for rendering the current webpage to a PNG is borrowed from Phantom.js' implementation.
+
+![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
+
+The names and logos for thoughtbot are trademarks of thoughtbot, inc.
+
+License
+-------
+
+capybara-webkit is Copyright (c) 2011 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.

data/Rakefile

@@ -0,0 +1,65 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+require 'capybara_webkit_builder'
+require 'appraisal'
+
+Bundler::GemHelper.install_tasks
+
+desc "Generate a Makefile using qmake"
+file 'Makefile' do
+  CapybaraWebkitBuilder.makefile or exit(1)
+end
+
+desc "Regenerate dependencies using qmake"
+task :qmake => 'Makefile' do
+  CapybaraWebkitBuilder.qmake or exit(1)
+end
+
+desc "Build the webkit server"
+task :build => :qmake do
+  CapybaraWebkitBuilder.build or exit(1)
+end
+
+file 'bin/webkit_server' => :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]
+
+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\n  #{name}.h \\")
+    project.gsub!(/^(SOURCES = .*)/, "\\1\n  #{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})\n")
+  end
+
+  command_factory_file_name = "src/CommandFactory.cpp"
+  command_factory = IO.read(command_factory_file_name)
+  command_factory.sub!(/^$/, "#include \"#{name}.h\"\n")
+  File.open(command_factory_file_name, "w") { |file| file.write(command_factory) }
+end