Qlive is a full-stack integration testing tool for running QUnit JavaScript tests against a live Rack server. It is mainly intended to be used for testing JavaScript-heavy, single-page web applications (like those built using Backbone, AngularJS, Ember.js, etc.).
Qlive's primary purpose is to enable testing with deterministic fixturing. It lets you precisely define a page's content and user login state server-side, so you can avoid the problem of tests that sometimes pass and sometimes fail.
- Precisely set fixture content and user login state for your QUnit tests using your favorite fixtures library (like factory_girl).
- Run the same tests both in a browser or headlessly, alongside your normal integration test suite (with the qlive-rspec gem).
- A dashboard page to link to all of your qlive test suites (with the qlive-rails gem).
If you are using Ruby on Rails, you should use one of these gems:
- qlive-rails Configures qlive for use with Ruby On Rails and provides an index page linking to your qlive test suites.
- qlive-rspec Run your QUnit tests headlessly as an Rspec example. (Builds on qlive-rails.)
You can install them with gem install qlive-rspec or by adding the appropriate Gemfile entry.
To test Sinatra or other Rack applications, use the core qlive gem direclty:
- qlive middleware Rack middleware for inserting the QUnit-related scripts and for triggering fixturing hooks.
See the Qlive suites wiki page.