2011-02-28 16:01:34 +00:00
capybara-webkit
===============
2011-03-09 22:55:40 +00:00
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 ).
2011-02-28 16:01:34 +00:00
2011-07-04 13:49:00 +00:00
Dependent on Qt
---------------
2011-02-28 16:01:34 +00:00
2011-06-05 21:49:16 +00:00
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.
2011-03-09 22:55:40 +00:00
2011-08-04 18:02:03 +00:00
OS X Lion 10.7:
2011-03-09 22:55:40 +00:00
2011-08-04 18:02:03 +00:00
Install Qt via [homebrew ](http://mxcl.github.com/homebrew/ )(can take more than an hour) using:
2011-07-27 17:20:45 +00:00
brew install qt --build-from-source
2011-07-04 13:49:00 +00:00
2011-08-04 18:02:03 +00:00
OS X < 10.7:
[Download the non-debug Cocoa package ](http://qt.nokia.com/downloads/qt-for-open-source-cpp-development-on-mac-os-x ).
2011-07-04 13:49:00 +00:00
Ubuntu:
apt-get install libqt4-dev
Fedora:
yum install qt-webkit-devel
2011-08-04 13:44:56 +00:00
Gentoo Linux:
2011-08-04 13:54:51 +00:00
emerge x11-libs/qt-webkit
2011-08-04 13:44:56 +00:00
2011-07-04 13:49:00 +00:00
Other Linux distributions:
[Download this package ](http://qt.nokia.com/downloads/linux-x11-cpp ).
2011-04-13 18:55:54 +00:00
2011-06-05 21:49:16 +00:00
CI
--
If you're like us, you'll be using capybara-webkit on CI.
2011-04-13 18:55:54 +00:00
2011-04-14 20:48:53 +00:00
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 ).
2011-04-13 16:17:59 +00:00
2011-03-09 22:55:40 +00:00
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.
2011-07-22 20:59:13 +00:00
Contributing
------------
See the CONTRIBUTING document.
2011-03-09 22:55:40 +00:00
About
-----
The capybara WebKit driver was written by Joe Ferris, Tristan Dunn, and Jason Morrison from [thoughtbot, inc ](http://thoughtbot.com/community ).
2011-07-03 13:39:47 +00:00
Code for rendering the current webpage to a PNG is borrowed from Phantom.js' implementation.
2011-04-13 17:31:27 +00:00
![thoughtbot ](http://thoughtbot.com/images/tm/logo.png )
2011-03-09 22:55:40 +00:00
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
2011-06-29 17:14:27 +00:00
Notes
-----
This capybara WebKit driver will listen on port 8200, this may conflict
with other services.
2011-03-09 22:55:40 +00:00
License
-------
capybara-webkit is Copyright © 2011 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.
2011-02-28 16:01:34 +00:00