0.0
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Ruby on Rails engine for running qunit javascript tests using server-side factories and user login
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 0.4
< 5, > 3.2
 Project Readme

Qlive

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.

Benefits:

  • 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).

Installation

Ruby on Rails

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.

Non-Rails

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.

Usage

See the Qlive suites wiki page.