test_squad 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8558931146248c1acab78a3a1927c68d27fac067
+  data.tar.gz: f852e96638b6e735c0380aef4067c5660d207a5e
+SHA512:
+  metadata.gz: 7f4084ca3a280d2fc46c8a152e28832b507cb2f49899650ad07ab17d7c55c01737add06d838afbce4680d92fb9e5600d927ee3ed3320f0555946502ff58a04dc
+  data.tar.gz: 8793c9502f41d95046be6aed10cdcfbaee7176f0b30b6e371bd4228bd275f44d84202962d238a91f1927f33273b9968041abd1f142be486597f50f6a054feb56

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2015 Nando Vieira
+
+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/README.md

@@ -0,0 +1,194 @@
+# TestSquad
+
+Running JavaScript tests on your Rails app, the easy way.
+
+- Supports QUnit, Ember.js, Mocha and Jasmine
+- Go headless with [Phantom.js](http://phantomjs.org)
+- Colored output
+- Asset pipeline support
+
+## Installation
+
+Add these lines to your application's Gemfile:
+
+```ruby
+group :development, :test do
+  gem 'test_squad'
+end
+```
+
+And then execute:
+
+```console
+$ bundle
+```
+
+## Usage
+
+After installing TestSquad, generate your tests skeleton. The generator will detect if you're using RSpec or TestUnit and will generate the `javascript` directory basead on that detection. Just use the command `rails generate test_squad:install --framework FRAMEWORK`.
+
+```console
+$ rails generate test_squad:install --framework jasmine
+    create  test/javascript/squad_sample
+    create  test/javascript/squad_sample/.keep
+    create  test/javascript/spec_helper.js
+    source  https://rails-assets.org
+     exist  test/javascript
+    create  test/javascript/test_squad.rb
+```
+
+## Running tests
+
+You can run your tests with `rake test_squad`. You can also visit `http://localhost:3000/tests` for in-browser testing.
+
+![Jasmine](https://github.com/fnando/test_squad/raw/master/screenshots/jasmine.png)
+
+![Mocha](https://github.com/fnando/test_squad/raw/master/screenshots/mocha.png)
+
+![QUnit](https://github.com/fnando/test_squad/raw/master/screenshots/qunit.png)
+
+![Terminal](https://github.com/fnando/test_squad/raw/master/screenshots/terminal.png)
+
+### Configure Ember
+
+When using the Ember framework, you must configure your application name. It'll default to your Rails application name.
+
+```javascript
+//= require application
+//= require_self
+//= require_tree ./components
+//= require_tree ./models
+//= require_tree ./routes
+//= require_tree ./unit
+//= require_tree ./views
+
+// Set the application.
+App = SquadSample;
+
+// Set up Ember testing.
+App.rootElement = '#ember-testing';
+App.setupForTesting();
+App.injectTestHelpers();
+```
+
+To disable all Ember logging, add the following line to `test_helper.js`, just before the `//= require application` line.
+
+```javascript
+//= require ./logging
+```
+
+Then create the file `spec/javascript/logging.js` with this content:
+
+```javascript
+Ember = {ENV: {
+  LOG_TRANSITIONS: false,
+  LOG_VIEW_LOOKUPS: false,
+  LOG_ACTIVE_GENERATION: false,
+  LOG_RESOLVER: false,
+  LOG_TRANSITIONS: false,
+  LOG_TRANSITIONS_INTERNAL: false,
+  LOG_VERSION: false
+}};
+```
+
+### Configure Mocha
+
+By default, Mocha is configured with [expect.js](https://github.com/Automattic/expect.js). You can use different libraries like [should.js](https://github.com/visionmedia/should.js) or [chai](http://chaijs.com/).
+
+Just add the dependency to your `Gemfile`. Use `rails-assets-chai` or `rails-assets-should`:
+
+```ruby
+source 'https://rubygems.org'
+source 'https://rails-assets.org'
+
+gem 'rails', '4.2.0'
+gem 'sass-rails', '~> 5.0'
+gem 'uglifier', '>= 1.3.0'
+
+gem 'ember-rails'
+gem 'rails-assets-jquery'
+
+group :development, :test do
+  gem 'test_squad', path: '../../test_squad'
+  gem 'rails-assets-mocha'
+  gem 'rails-assets-chai'
+end
+```
+
+Install the dependency with `bundle install`. Then require the library on `{test/spec}/javascript/spec_helper.js`.
+
+```javascript
+//= require application
+//= require chai
+//= require_self
+//= require_tree ./squad_sample
+
+var assert = chai.assert;
+
+mocha.setup('bdd');
+mocha.checkLeaks();
+mocha.globals(['jQuery']);
+mocha.reporter(mocha.TestSquad);
+window.onload = function(){
+  mocha.run();
+};
+```
+
+## Troubleshooting
+
+If you have a catch-all route, add the following line to your `config/routes.rb` file. This will be required if you configure Ember.js to use `history.pushState`.
+
+```ruby
+get :tests, to: 'test_squad#tests' unless Rails.env.production?
+```
+
+Otherwise you won't be able to to run your in-browser tests.
+
+## Configuration
+
+The rake task accepts some env variables.
+
+- `HOST`: the binding host. Defaults to `localhost`.
+- `PORT`: the server port. Defaults to `50000`.
+- `TIMEOUT`: how much time a test can take. Defaults to `10` (seconds).
+- `LOG`: set if console messages should be logged. Defaults to `false`.
+- `PHANTOMJS_BIN`: set the PhantomJS binary. Defaults to `phantomjs`.
+
+## Contributing
+
+Before starting, create an issue asking if it'd be a useful/wanted feature. This will avoid wasting your time.
+
+1. Fork it ( http://github.com/fnando/test_squad/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+Remember:
+
+- Don't mess with versioning.
+- Follow the code style already present.
+- Opening an issue asking if your feature/change will be welcomed it's recommended. That way you don't waste your time.
+
+## License
+
+(The MIT License)
+
+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/Rakefile

@@ -0,0 +1,18 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/app/assets/javascripts/jasmine/boot.js

@@ -0,0 +1,67 @@
+(function() {
+  window.jasmine = jasmineRequire.core(jasmineRequire);
+  jasmineRequire.html(jasmine);
+  jasmineRequire.phantom(jasmine);
+  var env = jasmine.getEnv();
+  var jasmineInterface = jasmineRequire.interface(jasmine, env);
+
+  if (typeof window == 'undefined' && typeof exports == 'object') {
+    extend(exports, jasmineInterface);
+  } else {
+    extend(window, jasmineInterface);
+  }
+
+  var queryString = new jasmine.QueryString({
+    getWindowLocation: function() { return window.location; }
+  });
+
+  var catchingExceptions = queryString.getParam('catch');
+  env.catchExceptions(typeof catchingExceptions === 'undefined' ? true : catchingExceptions);
+
+  var htmlReporter = new jasmine.HtmlReporter({
+    env: env,
+    onRaiseExceptionsClick: function() { queryString.setParam('catch', !env.catchingExceptions()); },
+    getContainer: function() { return document.body; },
+    createElement: function() { return document.createElement.apply(document, arguments); },
+    createTextNode: function() { return document.createTextNode.apply(document, arguments); },
+    timer: new jasmine.Timer()
+  });
+
+  var phantomReporter = new jasmine.PhantomReporter({
+    env: env,
+    onRaiseExceptionsClick: function() { queryString.setParam('catch', !env.catchingExceptions()); },
+    timer: new jasmine.Timer()
+  });
+
+  env.addReporter(jasmineInterface.jsApiReporter);
+  env.addReporter(htmlReporter);
+  env.addReporter(phantomReporter);
+
+  var specFilter = new jasmine.HtmlSpecFilter({
+    filterString: function() { return queryString.getParam('spec'); }
+  });
+
+  env.specFilter = function(spec) {
+    return specFilter.matches(spec.getFullName());
+  };
+
+  window.setTimeout = window.setTimeout;
+  window.setInterval = window.setInterval;
+  window.clearTimeout = window.clearTimeout;
+  window.clearInterval = window.clearInterval;
+
+  var currentWindowOnload = window.onload;
+
+  window.onload = function() {
+    if (currentWindowOnload) {
+      currentWindowOnload();
+    }
+    htmlReporter.initialize();
+    env.execute();
+  };
+
+  function extend(destination, source) {
+    for (var property in source) destination[property] = source[property];
+    return destination;
+  }
+}());

data/app/assets/javascripts/test_squad/jasmine-phantom.js

@@ -0,0 +1,85 @@
+(function(){
+  jasmineRequire.phantom = function(j$) {
+    if (!navigator.userAgent.match(/phantomjs/i)) {
+      j$.PhantomReporter = function() { /* noop */ };
+    } else {
+      j$.PhantomReporter = jasmineRequire.PhantomReporter();
+    }
+  };
+
+  jasmineRequire.PhantomReporter = function() {
+    function PhantomReporter(options) {
+      var stats = {
+        passes: 0,
+        fails: 0,
+        pending: 0,
+        elapsed: 0,
+        assertions: 0,
+        tests: 0
+      };
+
+      var start;
+
+      this.jasmineStarted = function() {
+        start = new Date().getTime();
+      };
+
+      this.jasmineDone = function() {
+        stats.elapsed = new Date().getTime() - start;
+
+        callPhantom({
+          name: 'end',
+          stats: stats
+        });
+      };
+
+      this.specStarted = function(result) {
+        stats.tests += 1;
+
+        callPhantom({
+          name: 'test start',
+          title: result.description
+        });
+      };
+
+      this.specDone = function(result) {
+        var pending = result.status === 'pending';
+        var passed = result.status === 'passed';
+        var failed = result.status === 'failed';
+        var error, assertion;
+
+        stats.assertions += result.failedExpectations.length;
+        stats.assertions += result.passedExpectations.length;
+        stats.pending += (pending ? 1 : 0);
+        stats.passes += (passed ? 1 : 0);
+        stats.fails += (failed ? 1 : 0);
+
+        if (failed) {
+          assertion = result.failedExpectations[0];
+          error = assertion.stack.replace(/^\s*/gm, '    ');
+          error = error.replace(/^\s+at .*?assets\/jasmine\/(jasmine|boot).*?\.js.*?$/mg, '');
+          error = error.replace(/\n+$/, '');
+        }
+
+        callPhantom({
+          name: 'test end',
+          title: result.description,
+          passed: passed,
+          pending: pending,
+          failure: error
+        });
+      };
+
+      this.suiteStarted = function(result) {
+        callPhantom({
+          name: 'suite start',
+          title: result.description
+        });
+      };
+
+      return this;
+    }
+
+    return PhantomReporter;
+  };
+})();

data/app/assets/javascripts/test_squad/mocha-reporter.js

@@ -0,0 +1,104 @@
+Mocha.reporters.PhantomJS = function(runner) {
+  if (!navigator.userAgent.match(/phantomjs/i)) {
+    return;
+  }
+
+  var stats = {
+    passes: 0,
+    fails: 0,
+    pending: 0,
+    elapsed: 0,
+    assertions: 0,
+    tests: 0
+  };
+
+  var start;
+
+  runner.on('pass', function(test){
+    stats.passes += 1;
+  });
+
+  runner.on('fail', function(test, err){
+    stats.fails += 1;
+  });
+
+  runner.on('pending', function(suite){
+    stats.pending += 1;
+  });
+
+  runner.on('start', function(test){
+    start = new Date().getTime();
+  });
+
+  runner.on('end', function(){
+    stats.elapsed = new Date().getTime() - start;
+    callPhantom({
+      name: 'end',
+      stats: stats
+    });
+  });
+
+  runner.on('test', function(test){
+    stats.tests += 1;
+
+    callPhantom({
+      name: 'test start',
+      title: test.title
+    });
+  });
+
+  runner.on('test end', function(test){
+    if (test.state === 'failed') {
+      var error = test.err.stack || test.err.toString();
+
+      // FF / Opera do not add the message
+      if (!~error.indexOf(test.err.message)) {
+        error = test.err.message + '\n' + error;
+      }
+
+      // <=IE7 stringifies to [Object Error]. Since it can be overloaded, we
+      // check for the result of the stringifying.
+      if ('[object Error]' == error) {
+        error = test.err.message;
+      }
+
+      // Safari doesn't give you a stack. Let's at least provide a source line.
+      if (!test.err.stack && test.err.sourceURL && test.err.line !== undefined) {
+        error += "\n(" + test.err.sourceURL + ":" + test.err.line + ")";
+      }
+
+      error = error.replace(/^\s+at .*?assets\/mocha\/.*?\.js.*?$/mg, '');
+      error = error.replace(/^\s+at .*?assets\/expect\/.*?\.js.*?$/mg, '');
+      error = error.replace(/^\s+at .*?assets\/should\/.*?\.js.*?$/mg, '');
+      error = error.replace(/^\s+at .*?assets\/chai\/.*?\.js.*?$/mg, '');
+      error = error.replace(/\n+$/, '');
+    }
+
+    callPhantom({
+      name: 'test end',
+      title: test.title,
+      passed: test.state === 'passed',
+      pending: test.pending,
+      failure: error
+    });
+  });
+
+  runner.on('suite', function(suite){
+    callPhantom({
+      name: 'suite start',
+      title: suite.title
+    });
+  });
+
+  runner.on('suite end', function(suite){
+    callPhantom({
+      name: 'suite end',
+      title: suite.title
+    });
+  });
+};
+
+mocha.TestSquad = function(runner) {
+  new Mocha.reporters.HTML(runner);
+  new Mocha.reporters.PhantomJS(runner);
+};