Skip to content
Newer
Older
100644 46 lines (25 sloc) 1.82 KB
5965f8a @jasonm Added README with a link to download Qt on OSX
jasonm authored
1 capybara-webkit
2 ===============
3
59c4eae @jferris Updated license ane readme
jferris authored
4 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).
5965f8a @jasonm Added README with a link to download Qt on OSX
jasonm authored
5
59c4eae @jferris Updated license ane readme
jferris authored
6 Dependencies
7 ------------
5965f8a @jasonm Added README with a link to download Qt on OSX
jasonm authored
8
ce8254c @jferris Clarify Qt requirements further
jferris authored
9 capybara-webkit depends on a WebKit implementation from Qt, a cross-platform development toolkit. You'll need to download the Qt Framework to build and install the gem.
59c4eae @jferris Updated license ane readme
jferris authored
10
11 * [Download Qt](http://qt.nokia.com/downloads/downloads)
12
87a00ab @jferris Added more readme notes on Qt and Xvfb
jferris authored
13 If you're on OS X, the installer at the above link will set up everything you need. You can download just the framework, as the full SDK isn't required to build the gem. We recommend downloading the non-Debug Cocoa package with just the framework. Note that installing Qt via homebrew takes more than an hour, so we recommend just downloading the precompiled framework for OS X.
657ee68 @jferris Clarify installation notes
jferris authored
14
15 If you're on Ubuntu, you can install the libqt4-dev package.
16
87a00ab @jferris Added more readme notes on Qt and Xvfb
jferris authored
17 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).
f754e93 @jferris Added Ubunutu instructions to the README
jferris authored
18
59c4eae @jferris Updated license ane readme
jferris authored
19 Usage
20 -----
21
22 Add the capybara-webkit gem to your Gemfile:
23
24 gem "capybara-webkit"
25
26 Set your Capybara Javascript driver to webkit:
27
28 Capybara.javascript_driver = :webkit
29
30 Tag scenarios with @javascript to run them using a headless WebKit browser.
31
32 About
33 -----
34
35 The capybara WebKit driver was written by Joe Ferris, Tristan Dunn, and Jason Morrison from [thoughtbot, inc](http://thoughtbot.com/community).
36
64cf394 @jferris Added a note about X servers and the thoughtbot logo
jferris authored
37 ![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
38
59c4eae @jferris Updated license ane readme
jferris authored
39 The names and logos for thoughtbot are trademarks of thoughtbot, inc.
40
41 License
42 -------
43
44 capybara-webkit is Copyright © 2011 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.
5965f8a @jasonm Added README with a link to download Qt on OSX
jasonm authored
45
Something went wrong with that request. Please try again.