Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 73 lines (46 sloc) 2.908 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
6b724ef @jferris Update README instructions about compiler issues
jferris authored
6 Qt Dependency and Installation Issues
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
a4fcb8e @jferris Fixed Installing QT link
jferris authored
12 the [capybara-webkit wiki](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit)
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
f82d661 Fix typo
Lake Denman authored
18 generic failures, so we've included a debug version of the driver that prints a
d3f344a @jferris Added a note about crashes to the README
jferris authored
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
6b724ef @jferris Update README instructions about compiler issues
jferris authored
23 If you are having compiling issues please check out the
a4fcb8e @jferris Fixed Installing QT link
jferris authored
24 [capybara-webkit wiki](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit).
6b724ef @jferris Update README instructions about compiler issues
jferris authored
25 If you don't have any luck there, please post to the
26 [mailing list](http://groups.google.com/group/capybara-webkit). Please don't
27 open a Github issue for a system-specific compiler issue.
d8c640d @halogenandtoast Added note about mailing list for compilation errors.
halogenandtoast authored
28
d7f491d @croaky improving the install instructions
croaky authored
29 CI
30 --
31
32 If you're like us, you'll be using capybara-webkit on CI.
657ee68 @jferris Clarify installation notes
jferris authored
33
87a00ab @jferris Added more readme notes on Qt and Xvfb
jferris authored
34 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
35
59c4eae @jferris Updated license ane readme
jferris authored
36 Usage
37 -----
38
39 Add the capybara-webkit gem to your Gemfile:
40
41 gem "capybara-webkit"
42
43 Set your Capybara Javascript driver to webkit:
44
45 Capybara.javascript_driver = :webkit
46
7be8f94 @jferris Clean up README
jferris authored
47 In cucumber, tag scenarios with @javascript to run them using a headless WebKit browser.
59c4eae @jferris Updated license ane readme
jferris authored
48
7be8f94 @jferris Clean up README
jferris authored
49 In RSpec, use the :js => true flag.
50
e2c103c @halogenandtoast Update documentation to point to actual capybara readme.
halogenandtoast authored
51 Take note of the transactional fixtures section of the [capybara README](https://github.com/jnicklas/capybara/blob/master/README.md).
eb6165d @joemsak Add a couple of notes that :js => true should still be used, and to n…
joemsak authored
52
3e9527a @mike-burns a contributing guide
mike-burns authored
53 Contributing
54 ------------
55
56 See the CONTRIBUTING document.
57
59c4eae @jferris Updated license ane readme
jferris authored
58 About
59 -----
60
8674ef7 @jferris Update authors
jferris authored
61 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).
59c4eae @jferris Updated license ane readme
jferris authored
62
37b3d24 @nicholaides Documenting that some code was borrowed from Phantom.js
nicholaides authored
63 Code for rendering the current webpage to a PNG is borrowed from Phantom.js' implementation.
64
64cf394 @jferris Added a note about X servers and the thoughtbot logo
jferris authored
65 ![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
66
59c4eae @jferris Updated license ane readme
jferris authored
67 The names and logos for thoughtbot are trademarks of thoughtbot, inc.
68
69 License
70 -------
71
578e5c7 @gabebw Spruce up the README
gabebw authored
72 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.