Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 68 lines (42 sloc) 2.266 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
f493b22 @gabebw make it read better
gabebw authored
6 Qt Dependency
c5e6396 @jferris Moved info about installing QT into the Wiki
jferris authored
7 -------------
5965f8a @jasonm Added README with a link to download Qt on OSX
jasonm authored
8
578e5c7 @gabebw Spruce up the README
gabebw authored
9 capybara-webkit depends on a WebKit implementation from Qt, a cross-platform
10 development toolkit. You'll need to download the Qt libraries to build and
c5e6396 @jferris Moved info about installing QT into the Wiki
jferris authored
11 install the gem. You can find instructions for downloading and installing QT on
12 the [capybara-webkit wiki](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-QT)
657ee68 @jferris Clarify installation notes
jferris authored
13
d3f344a @jferris Added a note about crashes to the README
jferris authored
14 Reporting Issues
15 ----------------
16
17 Without access to your application code we can't easily debug most crashes or
18 generic failures, so we've included a debug vesion of the driver that prints a
19 log of what happened during each test. Before filing a crash bug, please see
20 [Reporting Crashes](https://github.com/thoughtbot/capybara-webkit/wiki/Reporting-Crashes).
21 You're much more likely to get a fix if you follow those instructions.
22
d7f491d @croaky improving the install instructions
croaky authored
23 CI
24 --
25
26 If you're like us, you'll be using capybara-webkit on CI.
657ee68 @jferris Clarify installation notes
jferris authored
27
87a00ab @jferris Added more readme notes on Qt and Xvfb
jferris authored
28 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
29
59c4eae @jferris Updated license ane readme
jferris authored
30 Usage
31 -----
32
33 Add the capybara-webkit gem to your Gemfile:
34
35 gem "capybara-webkit"
36
37 Set your Capybara Javascript driver to webkit:
38
39 Capybara.javascript_driver = :webkit
40
41 Tag scenarios with @javascript to run them using a headless WebKit browser.
42
3e9527a @mike-burns a contributing guide
mike-burns authored
43 Contributing
44 ------------
45
46 See the CONTRIBUTING document.
47
59c4eae @jferris Updated license ane readme
jferris authored
48 About
49 -----
50
51 The capybara WebKit driver was written by Joe Ferris, Tristan Dunn, and Jason Morrison from [thoughtbot, inc](http://thoughtbot.com/community).
52
37b3d24 @nicholaides Documenting that some code was borrowed from Phantom.js
nicholaides authored
53 Code for rendering the current webpage to a PNG is borrowed from Phantom.js' implementation.
54
64cf394 @jferris Added a note about X servers and the thoughtbot logo
jferris authored
55 ![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
56
59c4eae @jferris Updated license ane readme
jferris authored
57 The names and logos for thoughtbot are trademarks of thoughtbot, inc.
58
644d85d @leehambley Change Capybara-webkit to listen on poty 8200, simple patch removes coll...
leehambley authored
59 Notes
60 -----
61
578e5c7 @gabebw Spruce up the README
gabebw authored
62 capybara-webkit will listen on port 8200. This may conflict with other services.
644d85d @leehambley Change Capybara-webkit to listen on poty 8200, simple patch removes coll...
leehambley authored
63
59c4eae @jferris Updated license ane readme
jferris authored
64 License
65 -------
66
578e5c7 @gabebw Spruce up the README
gabebw authored
67 capybara-webkit is Copyright (c) 2011 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.
Something went wrong with that request. Please try again.