everqueen 1.0.1

data/README.rdoc

@@ -0,0 +1,163 @@
+= Everqueen
+
+{<img src="http://travis-ci.org/hornairs/everqueen.png" />}[http://travis-ci.org/hornairs/everqueen]
+
+"Because QUnit is just really simple."
+
+Everqueen is a tool to run javascript unit tests for client side JavaScript. It
+combines a server which allows you to serve up and run your tests in a browser,
+as well as a runner which uses Capybara and any of its drivers to run your
+tests. Everqueen uses the QUnit unit testing framework for JavaScript.
+
+http://github.com/hornairs/everqueen
+
+== Fork Note
+
+Everqueen is a serious fork of {Evergreen}[http://github.com/jnicklas/evergreen] by Jonas Nicklas.
+Evergreen rocks, but we wanted to use QUnit instead of Jasmine, and use Sprockets for serving up
+test files instead of the homebrew require system in Evergreen. Thank Jonas for his awesome
+OSS work on Evergreen, because he took us 99% of the way there.
+
+== Philosophy
+
+Everqueen is a unit testing tool. Its purpose is to test JavaScript in
+isolation from your application. If you need a tool that tests how your
+JavaScript integrates with your application you should use an integration
+testing framework, such as {Capybara}[http://github.com/jnicklas/capybara].
+
+== Installation
+
+Install as a Ruby gem:
+
+    gem install everqueen
+
+== Usage
+
+Everqueen assumes a file and directory structure, place all your javascript
+code inside ./public and all test files inside ./test/javascripts. All test
+files should end in _test.js. For example:
+
+    public/javascripts/widget.js
+    test/javascripts/widget_test.js
+
+You can require files from the public directory inside your test file:
+
+    require('/javascripts/widget.js')
+
+    test('a widget', function() {
+      ...
+    });
+
+You can now look at your test files inside a browser by starting up the
+Everqueen server:
+
+    everqueen serve
+
+Alternatively you can run the tests headlessly by running:
+
+    everqueen run
+
+== Integrating with Rails 3
+
+Add Everqueen to your Gemfile:
+
+    gem 'everqueen', :require => 'everqueen/rails'
+
+Start your rails application and navigate to /everqueen. You should now see a
+list of all test files, click on one to run it.
+
+There's a rake task provided for you that you can use to run your tests:
+
+    rake test:javascripts
+
+== Integrating with Rails 2
+
+Add the following line to your Rakefile:
+
+    require 'everqueen/tasks'
+
+This will give you the `test:javascripts` rake task. Note that mounting is not
+possible under Rails 2 and that `require 'everqueen/rails'` will fail.
+
+== Configuration
+
+By default, Everqueen uses Selenium to run your tests and assumes a certain
+directory structure. If this standard is fine for you, then you don't need to
+do anything else. If you need to configure Everqueen to suit your needs,
+Everqueen will automatically look for and load the following files:
+
+    config/everqueen.rb
+    .everqueen
+    ~/.everqueen
+
+The content of these files could look like this:
+
+    require 'capybara-webkit'
+
+    Everqueen.configure do |config|
+      config.driver = :webkit
+      config.public_dir = 'public_html'
+      config.test_dir = 'test'
+    end
+
+
+== Test Helper
+
+If you add a test_helper file like so:
+
+    test/javascripts/test_helper.js
+
+It will automatically be loaded. This is a great place for adding custom
+matchers and the like.
+
+== CoffeeScript
+
+Everqueen supports tests written in
+{CoffeeScript}[http://github.com/jashkenas/coffee-script] via Sprockets. Just name your test
+file _test.coffee and it will automatically be translated for you.
+
+You can also add a CoffeeScript test helper, but remember that CoffeeScript
+encloses individual files in a closure, if you need something you define in the
+test helper to be available in your test files, attach it to the window object:
+
+    # test/javascripts/test_helper.coffee
+
+    MyThing: "foo"          # local to test helper
+    window.MyThing: "foo"   # global
+
+== Development
+
+If you plan to work on Everqueen, you need to checkout the QUnit library, which
+is added as a git submodule. Run the following command:
+
+    git submodule update --init
+
+If you're using a version of Everqueen from git with bundler, you need to tell
+bundler to use submodules, this can be achieved with the following command:
+
+    gem 'everqueen', :submodules => true, :git => 'git://github.com/jnicklas/everqueen.git'
+
+== License:
+
+(The MIT License)
+
+Copyright (c) 2009 Jonas Nicklas
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/bin/everqueen

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.dirname(__FILE__) + '/../lib') unless $:.include?(File.dirname(__FILE__) + '/../lib')
+
+require 'everqueen'
+
+begin
+  # The dup is to keep ARGV intact, so that tools like ruby-debug can respawn.
+  success = Everqueen::Cli.execute(ARGV.dup)
+  Kernel.exit(success ? 0 : 1)
+rescue SystemExit => e
+  Kernel.exit(e.status)
+rescue Exception => e
+  STDERR.puts("#{e.message} (#{e.class})")
+  STDERR.puts(e.backtrace.join("\n"))
+  Kernel.exit(1)
+end
+

data/config/routes.rb

@@ -0,0 +1,3 @@
+Rails.application.routes.draw do
+  mount Everqueen::Application, :at => '/everqueen'
+end

data/lib/everqueen.rb

@@ -0,0 +1,66 @@
+require 'rubygems'
+require 'sinatra/base'
+require 'capybara'
+require 'launchy'
+require 'coffee-script'
+require 'everqueen/version'
+require 'everqueen/application'
+require 'json'
+
+module Everqueen
+  autoload :Cli, 'everqueen/cli'
+  autoload :Server, 'everqueen/server'
+  autoload :Runner, 'everqueen/runner'
+  autoload :Suite, 'everqueen/suite'
+  autoload :Test, 'everqueen/test'
+
+  class << self
+    attr_accessor :driver, :public_dir, :test_dir, :root, :mounted_at, :application
+
+    def configure
+      yield self
+    end
+
+    def use_defaults!
+      configure do |config|
+        config.application = Everqueen::Application
+        config.driver = :selenium
+        config.public_dir = 'public'
+        config.test_dir = 'test/javascripts'
+        config.mounted_at = ""
+      end
+    end
+
+    def test_dir=(new_dir)
+      update_asset_paths(new_dir, test_dir)
+      @test_dir = new_dir
+    end
+
+    def public_dir=(new_dir)
+      update_asset_paths(new_dir, public_dir)
+      @public_dir = new_dir
+    end
+
+    def root=(new_root)
+      @root = new_root
+      update_asset_paths(test_dir, test_dir)
+      update_asset_paths(public_dir, public_dir)
+      @root
+    end
+
+    private
+
+    def update_asset_paths(new_dir, old_dir)
+      return if root.nil?
+      old_dir = File.expand_path(old_dir, root)
+      new_dir = File.expand_path(new_dir, root)
+      old_paths = Everqueen::AssetsEnvironment.clear_paths
+      old_paths.delete(old_dir)
+      old_paths.unshift(new_dir).each do |dir|
+        Everqueen::AssetsEnvironment.append_path(dir)
+      end
+    end
+  end
+end
+
+Everqueen.use_defaults!

data/lib/everqueen/application.rb

@@ -0,0 +1,47 @@
+require 'sprockets'
+
+module Everqueen
+  class TestApplication < Sinatra::Base
+
+    set :static, false
+    set :root, File.expand_path('.', File.dirname(__FILE__))
+
+    helpers do
+      def url(path)
+        Everqueen.mounted_at.to_s + path.to_s
+      end
+    end
+
+    get '/' do
+      @suite = Everqueen::Suite.new
+      erb :list
+    end
+
+    get '/run/all' do
+      @suite = Everqueen::Suite.new
+      erb :run
+    end
+
+    get '/run/*' do |name|
+      @suite = Everqueen::Suite.new
+      @test = @suite.get_test(name)
+      erb :run
+    end
+  end
+
+  AssetsEnvironment = Sprockets::Environment.new
+  assets_path = File.expand_path(File.join(File.dirname(__FILE__), 'assets'))
+  AssetsEnvironment.append_path assets_path
+  qunit_assets_path = File.expand_path(File.join(File.dirname(__FILE__), '..', 'qunit', 'qunit'))
+  AssetsEnvironment.append_path qunit_assets_path
+
+  Application = Rack::Builder.app do
+    map '/assets' do
+      run AssetsEnvironment
+    end
+
+    map '/' do
+      run TestApplication
+    end
+  end
+end

data/lib/everqueen/assets/everqueen.scss.css

@@ -0,0 +1,370 @@
+body {
+	font-family: "Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial, sans-serif;
+  background: #f0f0f0;
+}
+
+a {
+  color: #2A24A5;
+}
+
+#page, #test, .jasmine_reporter {
+  background: white;
+  -moz-border-radius: 3px;
+  padding: 20px;
+  margin: 10px auto 30px;
+  border: 1px solid #ddd;
+  box-shadow: 0 1px 3px 1px rgba(0,0,0,0.05)
+}
+
+#test {
+  min-height: 50px;
+  max-height: 300px;
+  overflow: auto;
+  margin: 30px auto 30px;
+}
+
+.jasmine_reporter {
+  margin: 30px auto 30px;
+}
+
+#page h1 {
+  font-size: 24px;
+  margin: 0 0 15px;
+  border-bottom: 3px solid #AEAEAE;
+  padding-bottom: 4px;
+}
+
+#page a.back {
+  font-size: 12px;
+}
+
+#page #all {
+  border-bottom: 3px solid #ECECEC;
+  padding: 12px 0;
+  margin-bottom: 20px;
+  overflow: hidden;
+}
+
+#page ul {
+  margin: 0;
+  padding: 0;
+}
+
+#page ul li {
+  list-style: none;
+  border-bottom: 1px solid #ECECEC;
+  margin: 1px 0 0;
+  padding: 8px 0;
+  position: relative;
+  overflow: hidden;
+}
+
+#page ul li:last-child {
+  border: none;
+}
+
+/*#page ul li:hover, #page #all:hover {
+  background: #FBFBFB;
+}*/
+
+#page ul li a:first-child, #page #all a:first-child {
+  margin-top: 3px;
+  float: left;
+  padding: 4px 2px;
+}
+
+#page ul li a:first-child:hover, #page #all a:first-child:hover {
+  background: #242DA5;
+  color: #fff;
+  text-decoration: none;
+  border-radius: 3px;
+}
+
+#page a.run {
+  display: block;
+  float: right;
+  border-radius: 3px;
+  padding: 4px 10px;
+  color: #484848;
+  text-decoration: none;
+  border: 1px solid #CBCBCB;
+  border-bottom-color: #BDBDBD;
+  background: #D8D8D8;
+  background: -moz-linear-gradient(top, #eaeaea 1%, #d1d1d1 100%); /* FF3.6+ */
+  background: -webkit-gradient(linear, left top, left bottom, color-stop(1%,#eaeaea), color-stop(100%,#d1d1d1)); /* Chrome,Safari4+ */
+  background: -webkit-linear-gradient(top, #eaeaea 1%,#d1d1d1 100%); /* Chrome10+,Safari5.1+ */
+  background: -o-linear-gradient(top, #eaeaea 1%,#d1d1d1 100%); /* Opera11.10+ */
+  background: -ms-linear-gradient(top, #eaeaea 1%,#d1d1d1 100%); /* IE10+ */
+  background: linear-gradient(top, #eaeaea 1%,#d1d1d1 100%); /* W3C */
+}
+
+#page a.run:hover {
+  box-shadow: inset 0 1px 6px 2px rgba(255,255,255,0.8);
+  text-shadow: 0px 0px 4px rgba(255,255,255,0.7);
+}
+
+#page a.run.pass {
+  border-color: #45991E;
+  color: #fff;
+  background: #4DA524;
+  background: -moz-linear-gradient(top, #4DA524 1%, #408B1D 100%); /* FF3.6+ */
+  background: -webkit-gradient(linear, left top, left bottom, color-stop(1%,#4DA524), color-stop(100%,#408B1D)); /* Chrome,Safari4+ */
+  background: -webkit-linear-gradient(top, #4DA524 1%,#408B1D 100%); /* Chrome10+,Safari5.1+ */
+  background: -o-linear-gradient(top, #4DA524 1%,#408B1D 100%); /* Opera11.10+ */
+  background: -ms-linear-gradient(top, #4DA524 1%,#408B1D 100%); /* IE10+ */
+  background: linear-gradient(top, #4DA524 1%,#408B1D 100%); /* W3C */
+  box-shadow: inset 0 1px 6px 1px rgba(255,255,255,0.2);
+  text-shadow: 0px 0px 4px rgba(255,255,255,0.2);
+}
+
+#page a.run.fail {
+  border-color: #CB3737;
+  color: #fff;
+  background: #E24040;
+  background: -moz-linear-gradient(top, #E24040 1%, #C53838 100%); /* FF3.6+ */
+  background: -webkit-gradient(linear, left top, left bottom, color-stop(1%,#E24040), color-stop(100%,#C53838)); /* Chrome,Safari4+ */
+  background: -webkit-linear-gradient(top, #E24040 1%,#C53838 100%); /* Chrome10+,Safari5.1+ */
+  background: -o-linear-gradient(top, #E24040 1%,#C53838 100%); /* Opera11.10+ */
+  background: -ms-linear-gradient(top, #E24040 1%,#C53838 100%); /* IE10+ */
+  background: linear-gradient(top, #E24040 1%,#C53838 100%); /* W3C */
+}
+
+#page a.run.pass:hover, #page a.run.fail:hover {
+box-shadow: inset 0 1px 6px 2px rgba(255,255,255,0.3);
+text-shadow: 0px 0px 4px rgba(255,255,255,0.3)
+}
+
+#page a.run.running, #page a.run.running:hover {
+  border-color: blue;
+  background-image: url("data:image/gif,GIF89a%10%00%10%00%F2%00%00%FF%FF%FF%00%00%00%C2%C2%C2BBB%00%00%00bbb%82%82%82%92%92%92!%FE%1ACreated%20with%20ajaxload.info%00!%F9%04%00%0A%00%00%00!%FF%0BNETSCAPE2.0%03%01%00%00%00%2C%00%00%00%00%10%00%10%00%00%033%08%BA%DC%FE0%CAIk%13c%08%3A%08%19%9C%07N%98f%09E%B11%C2%BA%14%99%C1%B6.%60%C4%C2q%D0-%5B%189%DD%A6%079%18%0C%07Jk%E7H%00%00!%F9%04%00%0A%00%01%00%2C%00%00%00%00%10%00%10%00%00%034%08%BA%DC%FEN%8C!%20%1B%84%0C%BB%B0%E6%8ADqBQT%601%19%20%60LE%5B%1A%A8%7C%1C%B5u%DF%EDa%18%07%80%20%D7%18%E2%86C%19%B2%25%24*%12%00!%F9%04%00%0A%00%02%00%2C%00%00%00%00%10%00%10%00%00%036%08%BA2%23%2B%CAA%C8%90%CC%94V%2F%06%85c%1C%0E%F4%19N%F1IBa%98%ABp%1C%F0%0A%CC%B3%BD%1C%C6%A8%2B%02Y%ED%17%FC%01%83%C3%0F2%A9d%1A%9F%BF%04%00!%F9%04%00%0A%00%03%00%2C%00%00%00%00%10%00%10%00%00%033%08%BAb%25%2B%CA2%86%91%EC%9CV_%85%8B%A6%09%85!%0C%041D%87a%1C%11%AAF%82%B0%D1%1F%03bR%5D%F3%3D%1F08%2C%1A%8F%C8%A4r9L%00%00!%F9%04%00%0A%00%04%00%2C%00%00%00%00%10%00%10%00%00%032%08%BAr'%2BJ%E7d%14%F0%18%F3L%81%0C%26v%C3%60%5CbT%94%85%84%B9%1EhYB)%CF%CA%40%10%03%1E%E9%3C%1F%C3%26%2C%1A%8F%C8%A4R%92%00%00!%F9%04%00%0A%00%05%00%2C%00%00%00%00%10%00%10%00%00%033%08%BA%20%C2%909%17%E3t%E7%BC%DA%9E0%19%C7%1C%E0!.B%B6%9D%CAW%AC%A21%0C%06%0B%14sa%BB%B05%F7%95%01%810%B0%09%89%BB%9Fm)J%00%00!%F9%04%00%0A%00%06%00%2C%00%00%00%00%10%00%10%00%00%032%08%BA%DC%FE%F0%09%11%D9%9CU%5D%9A%01%EE%DAqp%95%60%88%DDa%9C%DD4%96%85AF%C50%14%90%60%9B%B6%01%0D%04%C2%40%10%9B1%80%C2%D6%CE%91%00%00!%F9%04%00%0A%00%07%00%2C%00%00%00%00%10%00%10%00%00%032%08%BA%DC%FE0%CAI%ABeB%D4%9C)%D7%1E%08%08%C3%20%8E%C7q%0E%0410%A9%CA%B0%AEP%18%C2a%18%07V%DA%A5%02%20ub%18%82%9E%5B%11%90%00%00%3B%00%00%00%00%00%00%00%00%00");
+  background-repeat: no-repeat;
+  background-position: center center;
+  text-indent: -999999px;
+  padding-right: 14px;
+  padding-left: 14px;
+  border-color: #EDEDED;
+}
+
+#footer {
+  margin: 0 auto 30px;
+  width: 600px;
+  text-align: center;
+  font-size: 13px;
+  color: #aaa;
+}
+
+#footer a.elabs {
+  position: relative;
+  padding-left: 30px;
+}
+
+#footer a.elabs img {
+  width: 23px;
+  opacity: 0.6;
+  position: absolute;
+  top: -4px;
+  left: 3px;
+}
+#footer a.elabs:hover img {
+  opacity: 1;
+}
+
+/**
+ * QUnit v1.3.0pre - A JavaScript Unit Testing Framework
+ *
+ * http://docs.jquery.com/QUnit
+ *
+ * Copyright (c) 2011 John Resig, Jörn Zaefferer
+ * Dual licensed under the MIT (MIT-LICENSE.txt)
+ * or GPL (GPL-LICENSE.txt) licenses.
+ */
+
+/** Font Family and Sizes */
+
+
+#qunit-testrunner-toolbar, #qunit-userAgent, #qunit-testresult, #qunit-tests li { font-size: small; }
+#qunit-tests { font-size: smaller; }
+
+
+/** Resets */
+
+#qunit-tests, #qunit-tests ol, #qunit-header, #qunit-banner, #qunit-userAgent, #qunit-testresult {
+	margin: 0;
+	padding: 0;
+}
+
+
+#qunit-header a:hover,
+#qunit-header a:focus {
+	color: #fff;
+}
+
+#qunit-testrunner-toolbar {
+	padding: 0.5em 0 0.5em 2em;
+	color: #5E740B;
+}
+
+#qunit-userAgent {
+	padding: 0.5em 0 0.5em 2.5em;
+	color: #366097;
+	border-bottom: 1px solid #fff;
+}
+
+
+/** Tests: Pass/Fail */
+
+#qunit-tests {
+	list-style-position: inside;
+}
+
+#qunit-tests li {
+	padding: 0.4em 0.5em 0.4em 2.5em;
+	border-bottom: 1px solid #fff;
+	list-style-position: inside;
+}
+
+#qunit-tests.hidepass li.pass, #qunit-tests.hidepass li.running  {
+	display: none;
+}
+
+#qunit-tests li strong {
+	cursor: pointer;
+}
+
+#qunit-tests li a {
+	padding: 0.5em;
+	color: #c2ccd1;
+	text-decoration: none;
+}
+#qunit-tests li a:hover,
+#qunit-tests li a:focus {
+	color: #000;
+}
+
+#qunit-tests ol {
+	margin-top: 0.5em;
+	padding: 0.5em;
+
+	background-color: #fff;
+
+	border-radius: 5px;
+	-moz-border-radius: 5px;
+	-webkit-border-radius: 5px;
+
+	box-shadow: inset 0px 2px 3px #999;
+	-moz-box-shadow: inset 0px 2px 3px #999;
+	-webkit-box-shadow: inset 0px 2px 3px #999;
+}
+
+#qunit-tests table {
+	border-collapse: collapse;
+	margin-top: .2em;
+}
+
+#qunit-tests th {
+	text-align: right;
+	vertical-align: top;
+	padding: 0 .5em 0 0;
+}
+
+#qunit-tests td {
+	vertical-align: top;
+}
+
+#qunit-tests pre {
+	margin: 0;
+	white-space: pre-wrap;
+	word-wrap: break-word;
+}
+
+#qunit-tests del {
+	background-color: #e0f2be;
+	color: #374e0c;
+	text-decoration: none;
+}
+
+#qunit-tests ins {
+	background-color: #ffcaca;
+	color: #500;
+	text-decoration: none;
+}
+
+/*** Test Counts */
+
+#qunit-tests b.counts                       { color: black; }
+#qunit-tests b.passed                       { color: #5E740B; }
+#qunit-tests b.failed                       { color: #710909; }
+
+#qunit-tests li li {
+	margin: 0.5em;
+	padding: 0.4em 0.5em 0.4em 0.5em;
+	background-color: #fff;
+	border-bottom: none;
+	list-style-position: inside;
+}
+
+/*** Passing Styles */
+
+#qunit-tests li li.pass {
+	color: #5E740B;
+	background-color: #fff;
+	border-left: 26px solid #C6E746;
+}
+
+#qunit-tests .pass                          { color: #528CE0; background-color: #D2E0E6; }
+#qunit-tests .pass .test-name               { color: #366097; }
+
+#qunit-tests .pass .test-actual,
+#qunit-tests .pass .test-expected           { color: #999999; }
+
+#qunit-banner.qunit-pass                    { background-color: #C6E746; }
+
+/*** Failing Styles */
+
+#qunit-tests li li.fail {
+	color: #710909;
+	background-color: #fff;
+	border-left: 26px solid #EE5757;
+	white-space: pre;
+}
+
+#qunit-tests > li:last-child {
+	border-radius: 0 0 15px 15px;
+	-moz-border-radius: 0 0 15px 15px;
+	-webkit-border-bottom-right-radius: 15px;
+	-webkit-border-bottom-left-radius: 15px;
+}
+
+#qunit-tests .fail                          { color: #000000; background-color: #EE5757; }
+#qunit-tests .fail .test-name,
+#qunit-tests .fail .module-name             { color: #000000; }
+
+#qunit-tests .fail .test-actual             { color: #EE5757; }
+#qunit-tests .fail .test-expected           { color: green;   }
+
+#qunit-banner.qunit-fail                    { background-color: #EE5757; }
+
+
+/** Result */
+
+#qunit-testresult {
+	padding: 0.5em 0.5em 0.5em 2.5em;
+
+	color: #2b81af;
+	background-color: #D2E0E6;
+
+	border-bottom: 1px solid white;
+	border-radius: 15px 15px 0 0;
+	-moz-border-radius: 15px 15px 0 0;
+	-webkit-border-top-right-radius: 15px;
+	-webkit-border-top-left-radius: 15px;
+
+}
+
+/** Fixture */
+
+#qunit-fixture {
+	position: absolute;
+	top: -10000px;
+	left: -10000px;
+}