jaspec 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a5e7a8197c96a47c7fd54f02e816898e64debb71
+  data.tar.gz: 2a8be4e40167491dd740504a69a4225752cde816
+SHA512:
+  metadata.gz: b915f71e545b71f3c798785bd681ce0781f555cb08a72839fa4507a5a4bae0e65f191a479f9d9281157286dc44e73f21856892ceae095e99132bedba7bc5ec3c
+  data.tar.gz: 7d3d40ef06ff06d33f21ef575636aad6895a028b2c27a364c8f070e7fe742c0b67f70010260caa6f04856588e3dca09ae99406c0b7d04a107913a2b2cb87e067

data/.gitignore

@@ -0,0 +1,25 @@
+*.gem
+*.rbc
+*.swp
+*.swo
+*.DS_Store*
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - ruby-head
+  - jruby-head

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in jaspec.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Kevin Gisi
+
+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/README.md

@@ -0,0 +1,82 @@
+# Jaspec
+
+Jaspec is a dirt-simple Jasmine spec runner. It runs off of [Jasmine](http://jasmine.github.io/) standalone, [RequireJS](http://requirejs.org/), and [PhantomJS](http://phantomjs.org/). It doesn't care about sprockets; it doesn't start a web server; it does something really really simple:
+
+It runs your specs.
+
+## Installation
+
+You can install jaspec via:
+
+    $ gem install jaspec
+
+Or, if you're using it with an application that includes a Gemfile, add this line:
+
+    gem 'jaspec'
+
+And then execute:
+
+    $ bundle
+
+## Usage
+
+Running your specs is nice and easy. Just execute:
+
+    $ jaspec specs/myCoolSpec.js
+
+Or, if you're using CoffeeScript:
+
+    $ jaspec specs/myCoolerSpec.coffee
+
+Finally, if you want to run across an entire directory:
+
+    $ jaspec specs/
+
+This will execute against all \*Spec.js, and \*Spec.coffee files within that directory.
+
+## Writing Your Specs
+
+You can format your specs normally:
+
+```coffeescript
+describe 'A useless spec', ->
+  it 'should be useless', ->
+    expect(true).toBe true
+```
+
+...but you'll get a LOT more power out of Jaspec if you use AMD-style definitions (RequireJS will include source files that way!)
+
+```coffeescript
+define ['../myLibrary/foo.js'], (foo) ->
+  describe 'foo', ->
+    it 'should have a value of 5', ->
+      expect(foo.value).toBe 5
+```
+
+You can use these dependencies to load non-AMD compliant JS, and stuff will still work!
+
+```coffeescript
+define ['../vendor/jQuery.js'], ->
+  # do stuff with $
+```
+
+Best of all, since each spec runs in isolation, you can pre-define your dependencies, in order to provide useful stubs and mocks.
+
+```coffeescript
+define 'foo', -> 'Fake foo'
+
+define ['../thingThatNeedsFoo.js'], (thing) ->
+  describe 'thing', ->
+    it 'should have a stubbed foo', ->
+      expect(thing.foo).toBe 'Fake Foo'
+```
+
+Get testing!
+
+## Contributing
+
+1. Fork it ( https://github.com/gisikw/jaspec/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 a new Pull Request

data/Rakefile

@@ -0,0 +1,13 @@
+$LOAD_PATH.unshift File.expand_path("#{File.dirname(__FILE__)}/lib")
+
+require "bundler/gem_tasks"
+require "jaspec"
+
+namespace :spec do
+  desc "Run all the jaspect tests"
+  task :jaspec do
+    Jaspec::Runner.run_all(File.join(File.dirname(__FILE__),'spec','javascripts')) || exit(1)
+  end
+end
+
+task :default => 'spec:jaspec'

data/bin/jaspec

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'jaspec'
+
+Jaspec::Cli.new.process(ARGV)

data/jaspec.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'jaspec/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "jaspec"
+  spec.version       = Jaspec::VERSION
+  spec.authors       = ["Kevin Gisi"]
+  spec.email         = ["kevin@kevingisi.com"]
+  spec.summary       = %q{A stupid simple Jasmine spec-runner for AMD modules}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+
+  spec.add_dependency 'phantomjs'
+end

data/lib/jaspec.rb

@@ -0,0 +1,9 @@
+jaspec_files = [
+  'version',
+  'runner',
+  'cli'
+]
+
+jaspec_files.each do |file|
+  require File.join('jaspec', file)
+end

data/lib/jaspec/cli.rb

@@ -0,0 +1,20 @@
+module Jaspec
+  class Cli
+    def process(argv)
+      @argv = argv
+      if @argv.size > 0
+        run
+      else
+        print_help
+      end
+    end
+
+    def print_help
+      puts "Usage: jaspec [file or directory]"
+    end
+
+    def run
+      Jaspec::Runner.run File.expand_path(@argv[0])
+    end
+  end
+end

data/lib/jaspec/runner.rb

@@ -0,0 +1,35 @@
+module Jaspec
+  class Runner
+    PHANTOM_RUNNER  = File.expand_path('runner/phantom.js',   File.dirname(__FILE__))
+    HTML_RUNNER     = File.expand_path('runner/runner.html',  File.dirname(__FILE__))
+
+    class << self
+
+      def run(spec)
+        if File.directory?(spec)
+          run_all(spec)
+        else
+          system("phantomjs #{PHANTOM_RUNNER} #{HTML_RUNNER} #{spec}")
+        end
+      end
+
+      def run_all(dir)
+        failures = []
+
+        Dir.glob(File.join(dir,'**','*Spec.{js,coffee}')).each do |spec|
+          failures << spec if !run(spec)
+        end
+
+        if failures.empty?
+          puts "\nAll specs passing. Badass!"
+          return true
+        else
+          puts "\n#{failures.length} failing spec file#{'s' if failures.length > 1}:"
+          puts failures.join("\n")
+          return false
+        end
+      end
+
+    end
+  end
+end

data/lib/jaspec/runner/phantom.js

@@ -0,0 +1,99 @@
+var
+  system  = require('system'),
+  page    = require('webpage').create(),
+  colorWrap,
+  interval,
+  timeout,
+  report,
+  yellow,
+  green,
+  file = system.args[2],
+  red;
+
+colorWrap = function (code) {
+  return function (str) {
+    return '\033[' + code + 'm' + str + '\033[0m';
+  };
+}
+
+page.onConsoleMessage = function(msg) {
+  console.log(msg);
+};
+
+yellow  = colorWrap(33);
+green   = colorWrap(32);
+red     = colorWrap(31);
+
+report = function () {
+  var specs = page.evaluate(function () {
+    return jsApiReporter.specResults(0, jsApiReporter.specs().length);
+  });
+
+  if (specs.every(function (spec) { return spec.status === 'passed'; })) {
+    console.log(green(file));
+    page.close();
+    setTimeout(function () { phantom.exit(0); });
+  } else {
+    if (specs.some(function (spec) { return spec.status === 'failed'; })) {
+      console.log(red(file));
+    } else {
+      console.log(yellow(file));
+    }
+    specs.forEach(function (spec) {
+      if (spec.status === 'passed') {
+        console.log(green('- ' + spec.fullName));
+      } else if (spec.status === 'pending') {
+        console.log(yellow('- ' + spec.fullName));
+      } else {
+        console.log(red('- ' + spec.fullName));
+      }
+    });
+    page.close();
+    setTimeout(function () { phantom.exit(1); });
+  }
+}
+
+page.onInitialized = function () {
+  page.evaluate(function (file) {
+    document.addEventListener('DOMContentLoaded', function () {
+      window.callPhantom();
+    });
+  });
+};
+
+page.onCallback = function () {
+  var specsDone;
+
+  page.evaluate(function (file) {
+    window.runSpec(file);
+  }, file);
+
+  specsDone = function () {
+    return page.evaluate(function () {
+      return window.jsApiReporter && window.jsApiReporter.finished;
+    });
+  };
+
+  interval = setInterval(function () {
+    if (specsDone()) {
+      clearInterval(interval);
+      clearTimeout(timeout);
+      report();
+    }
+  });
+
+  timeout = setTimeout(function () {
+    clearInterval(interval);
+    console.log(red(file));
+    page.close();
+    setTimeout(function () { phantom.exit(1); });
+  }, 10000);
+};
+
+page.open(system.args[1], function (status) {
+  if (status !== 'success') {
+    console.log(red(file));
+    page.close();
+    setTimeout(function () { phantom.exit(1); });
+  }
+});

data/lib/jaspec/runner/runner.html

@@ -0,0 +1,83 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <title>Jaspec Runner</title>
+    <link rel='shortcut icon' type='image/png' href='../../../vendor/jasmine-2.1.3/lib/jasmine-2.1.3/jasmine_favicon.png'>
+    <link rel='stylesheet' href='../../../vendor/jasmine-2.1.3/lib/jasmine-2.1.3/jasmine.css'>
+    <script src='../../../vendor/jasmine-2.1.3/lib/jasmine-2.1.3/jasmine.js'></script>
+    <script src='../../../vendor/jasmine-2.1.3/lib/jasmine-2.1.3/jasmine-html.js'></script>
+    <script src='../../../vendor/jasmine-2.1.3/lib/jasmine-2.1.3/console.js'></script>
+    <script src='../../../vendor/requirejs-2.1.15.min.js'></script>
+
+    <!-- Custom Jasmine Boot -->
+    <script>
+      window.jasmine = jasmineRequire.core(jasmineRequire);
+
+      jasmineRequire.html(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()
+      });
+
+      env.addReporter(jasmineInterface.jsApiReporter);
+      env.addReporter(htmlReporter);
+
+      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;
+
+      function extend(destination, source) {
+        for (var property in source) destination[property] = source[property];
+        return destination;
+      }
+
+      require.config({
+        paths: {
+          'coffee-script': '../../../vendor/coffee-script-1.8.0',
+          'cs': '../../../vendor/cs-0.5.0'
+        }
+      });
+
+      window.runSpec = function(file) {
+        require([file.indexOf('.coffee') !== -1 ? 'cs!' + file : file], function () {
+          htmlReporter.initialize();
+          env.execute();
+        });
+      };
+
+    </script>
+  </head>
+</html>