This is an project to perform remote integration testing using RSpec, Capybara, and Poltergeist/PhantomJS. The tests being run in spec/requests/ require variables not presented in this repository so you will want to modify these to fit your own tests.
You will want to Install PhantomJS. It is a headless WebKit scriptable with a JavaScript API.
You will need to install Poltergeist. This is the driver for Capybara. Poltergeist allows for you to run your Capybara tests on a headless WebKit browser, provided by PhantomJS.
You need at least PhantomJS 1.8.1. There are no other external dependencies (you don't need Qt, or a running X server, etc.)
You will want to run the following commands to setup the project locally:
git clone git@github.com:gmckeever/ihf-testing.git
cd ihf-testing
bundle installYou will also need to install the gems located in the Gemfile.
gem install capybara
gem install poltergeist
gem install rspecTo run the tests, you could run ./bin/run-tests .
Alternatively, you could execute rspec with bundle exec rspec .
You can add more tests by placing a file into the request folder with the name ending in spec. ex:spec/requests/filename_spec.rb.
This is being designed for Jenkins CI, as it supports the headless WebKit testing of PhantomJS. More details for this coming soon.
If running locally, you may want to add Launchy to the project and create a debug method to open a browser window where the test fails.