matcha 0.9.0

data/lib/matcha/engine.rb

@@ -0,0 +1,31 @@
+module Matcha
+  class Engine < Rails::Engine
+    config.matcha = ActiveSupport::OrderedOptions.new
+
+    def self.application(app)
+      Rack::Builder.app do
+        map app.config.assets.prefix do
+          run app.assets
+        end
+
+        run Matcha::Engine
+      end
+    end
+
+    initializer "matcha.environment" do |app|
+      unless app.config.assets.enabled
+        raise RuntimeError, "matcha requires the asset pipeline to be enabled"
+      end
+
+      options = app.config.matcha
+
+      options.spec_dir    ||= "spec/javascripts"
+      options.port        ||= 8888
+      options.interface   ||= :bdd
+      options.application ||= self.class.application(app)
+      options.driver      ||= :selenium
+
+      app.config.assets.paths << app.root.join(options.spec_dir).to_s
+    end
+  end
+end

data/lib/matcha/runner.rb

@@ -0,0 +1,151 @@
+module Matcha
+  class Runner
+    def self.start
+      new.run
+    end
+
+    class Example
+      def initialize(row)
+        @row = row
+      end
+
+      def passed?
+        @row['passed']
+      end
+
+      def failure_message
+        unless passed?
+          msg = []
+          msg << "  Failed: #{@row['name']}"
+          msg << "    #{@row['message']}"
+          msg << "    in #{@row['trace']['fileName']}:#{@row['trace']['lineNumber']}" if @row['trace']
+          msg.join("\n")
+        end
+      end
+    end
+
+    class SpecRunner
+      attr_reader :runner, :spec
+
+      def initialize(runner, spec)
+        @runner = runner
+        @spec = spec
+      end
+
+      def session
+        runner.session
+      end
+
+      def io
+        runner.io
+      end
+
+      def run
+        io.puts dots
+        io.puts failure_messages
+        io.puts "\n#{examples.size} examples, #{failed_examples.size} failures"
+        passed?
+      end
+
+      def examples
+        @results ||= begin
+          session.visit(spec.url)
+
+          previous_results = ""
+
+          session.wait_until(300) do
+            dots = session.evaluate_script('Matcha.dots')
+            io.print dots.sub(/^#{Regexp.escape(previous_results)}/, '')
+            io.flush
+            previous_results = dots
+            session.evaluate_script('Matcha.done')
+          end
+
+          dots = session.evaluate_script('Matcha.dots')
+          io.print dots.sub(/^#{Regexp.escape(previous_results)}/, '')
+
+          JSON.parse(session.evaluate_script('Matcha.getResults()')).map do |row|
+            Example.new(row)
+          end
+        end
+      end
+
+      def failed_examples
+        examples.select { |example| not example.passed? }
+      end
+
+      def passed?
+        examples.all? { |example| example.passed? }
+      end
+
+      def dots
+        examples; ""
+      end
+
+      def failure_messages
+        unless passed?
+          examples.map { |example| example.failure_message }.compact.join("\n\n")
+        end
+      end
+    end
+
+    attr_reader :suite, :io
+
+    def initialize(options = {})
+      @io = options[:output] || STDOUT
+    end
+
+    def spec_runner(spec)
+      SpecRunner.new(self, spec)
+    end
+
+    def run
+      before = Time.now
+
+      io.puts ""
+      io.puts dots.to_s
+      io.puts ""
+      if failure_messages
+        io.puts failure_messages
+        io.puts ""
+      end
+
+      seconds = "%.2f" % (Time.now - before)
+      io.puts "Finished in #{seconds} seconds"
+      io.puts "#{examples.size} examples, #{failed_examples.size} failures"
+      passed?
+    end
+
+    def examples
+      spec_runners.map { |spec_runner| spec_runner.examples }.flatten
+    end
+
+    def failed_examples
+      examples.select { |example| not example.passed? }
+    end
+
+    def passed?
+      spec_runners.all? { |spec_runner| spec_runner.passed? }
+    end
+
+    def dots
+      spec_runners.map { |spec_runner| spec_runner.dots }.join
+    end
+
+    def failure_messages
+      unless passed?
+        spec_runners.map { |spec_runner| spec_runner.failure_messages }.compact.join("\n\n")
+      end
+    end
+
+    def session
+      @session ||= Capybara::Session.new(Matcha.driver, Matcha.application)
+    end
+
+  protected
+
+    def spec_runners
+      @spec_runners ||= Matcha::Spec.all.map { |spec| SpecRunner.new(self, spec) }
+    end
+  end
+end

data/lib/matcha/server.rb

@@ -0,0 +1,7 @@
+module Matcha
+  class Server
+    def self.start
+      Rack::Server.start(:app => Matcha.application, :Port => Matcha.port, :AccessLog => [])
+    end
+  end
+end

data/lib/tasks/matcha.rake

@@ -0,0 +1,11 @@
+namespace :matcha do
+  desc "Run JavaScript specs interactively"
+  task :server => :environment do
+    Matcha.serve
+  end
+
+  desc "Run JavaScript specs non-interactively"
+  task :ci => :environment do
+    Matcha.run
+  end
+end

data/matcha.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["John Firebaugh"]
+  gem.email         = ["john.firebaugh@gmail.com"]
+  gem.description   = %q{Unit test your Rails JavaScript with the mocha test framework and chai assertion library}
+  gem.summary       = %q{Matcha is a Rails engine that allows you to test your JavaScript with the
+mocha test framework and chai assertion library.
+
+It is similar to Jasmine and Evergreen, but does not attempt to be framework
+agnostic. By sticking with Rails, Matcha can take full advantage of features such as
+the asset pipeline and engines.}
+  gem.homepage      = "http://github.com/jfirebaugh/matcha"
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "matcha"
+  gem.require_paths = ["lib"]
+  gem.version       = "0.9.0"
+
+  gem.add_dependency "jquery-rails"
+  gem.add_dependency "rails", "~> 3.1"
+  gem.add_dependency "capybara"
+
+  gem.add_development_dependency "rspec-rails"
+  gem.add_development_dependency "capybara-firebug", "~> 1.1"
+  gem.add_development_dependency "coffee-script"
+  gem.add_development_dependency "ejs"
+end

data/spec/controllers/specs_controller_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe Matcha::SpecsController do
+  before do
+    @routes = Matcha::Engine.routes
+  end
+
+  describe "#set_interface" do
+    it "assigns Matcha.interface to @interface" do
+      Matcha.should_receive(:interface) { :tdd }
+      subject.set_interface
+      assigns[:interface].should == :tdd
+    end
+  end
+
+  describe "#set_mode" do
+    it "assigns Matcha.mode to @mode" do
+      Matcha.should_receive(:mode) { :runner }
+      subject.set_mode
+      assigns[:mode].should == :runner
+    end
+  end
+
+  describe "#index" do
+    it "assigns Matcha::Spec.all to @specs" do
+      Matcha::Spec.should_receive(:all) { :all }
+      get :index
+      assigns[:specs].should == :all
+    end
+  end
+
+  describe "#show" do
+    it "finds the spec with the given basename and assigns it to @spec" do
+      Matcha::Spec.should_receive(:find).with("array_spec") { :spec }
+      get :show, :spec => "array_spec"
+      assigns[:spec].should == :spec
+    end
+
+    it "404s if there is no spec with the given basename" do
+      Matcha::Spec.should_receive(:find).with("array_spec") { nil }
+      get :show, :spec => "array_spec"
+      response.status.should == 404
+      response.should_not render_template("matcha/specs/show")
+    end
+  end
+end

data/spec/dummy/app/assets/javascripts/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+//= require_tree .

data/spec/dummy/app/assets/javascripts/array_sum.js.coffee

@@ -0,0 +1,4 @@
+Array.prototype.sum = ->
+  sum = 0
+  sum += i for i in this
+  sum

data/spec/dummy/config.ru

@@ -0,0 +1,4 @@
+# This file is used by Rack-based servers to start the application.
+
+require ::File.expand_path('../config/environment',  __FILE__)
+run Dummy::Application

data/spec/dummy/config/application.rb

@@ -0,0 +1,17 @@
+require File.expand_path('../boot', __FILE__)
+
+require "action_controller/railtie"
+require "action_view/railtie"
+require "sprockets/railtie"
+
+if defined?(Bundler)
+  Bundler.require(*Rails.groups(:assets => %w(development test)))
+end
+
+module Dummy
+  class Application < Rails::Application
+    config.encoding = "utf-8"
+    config.assets.enabled = true
+    config.assets.version = '1.0'
+  end
+end

data/spec/dummy/config/boot.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/spec/dummy/config/environment.rb

@@ -0,0 +1,5 @@
+# Load the rails application
+require File.expand_path('../application', __FILE__)
+
+# Initialize the rails application
+Dummy::Application.initialize!

data/spec/dummy/config/environments/test.rb

@@ -0,0 +1,29 @@
+Dummy::Application.configure do
+  # Settings specified here will take precedence over those in config/application.rb
+
+  # The test environment is used exclusively to run your application's
+  # test suite. You never need to work with it otherwise. Remember that
+  # your test database is "scratch space" for the test suite and is wiped
+  # and recreated between test runs. Don't rely on the data there!
+  config.cache_classes = true
+
+  # Configure static asset server for tests with Cache-Control for performance
+  config.serve_static_assets = true
+  config.static_cache_control = "public, max-age=3600"
+
+  # Log error messages when you accidentally call methods on nil
+  config.whiny_nils = true
+
+  # Show full error reports and disable caching
+  config.consider_all_requests_local       = true
+  config.action_controller.perform_caching = false
+
+  # Raise exceptions instead of rendering exception templates
+  config.action_dispatch.show_exceptions = false
+
+  # Disable request forgery protection in test environment
+  config.action_controller.allow_forgery_protection    = false
+
+  # Print deprecation notices to the stderr
+  config.active_support.deprecation = :stderr
+end

data/spec/dummy/config/initializers/matcha.rb

@@ -0,0 +1,3 @@
+Matcha.configure do |config|
+  config.configured = true
+end if defined?(Matcha)

data/spec/dummy/spec/javascripts/array_sum_cs_spec.js.coffee

@@ -0,0 +1,8 @@
+#= require array_sum
+
+describe "Array#sum (cs)", ->
+  it "returns 0 when the Array is empty", ->
+    [].sum().should.equal(0);
+
+  it "returns the sum of numeric elements", ->
+    [1,2,3].sum().should.equal(6);

data/spec/dummy/spec/javascripts/array_sum_js_spec.js

@@ -0,0 +1,11 @@
+//= require array_sum
+
+describe("Array#sum (js)", function(){
+  it("returns 0 when the Array is empty", function(){
+    [].sum().should.equal(0);
+  });
+
+  it("returns the sum of numeric elements", function(){
+    [1,2,3].sum().should.equal(6);
+  });
+});

data/spec/dummy/spec/javascripts/assert_spec.js.coffee

@@ -0,0 +1,9 @@
+describe "assert styles", ->
+  it "supports expect style", ->
+    expect(2 + 2).to.equal(4)
+
+  it "supports should style", ->
+    (2 + 2).should.equal(4)
+
+  it "supports assert style", ->
+    assert.equal(2 + 2, 4)

data/spec/dummy/spec/javascripts/failing_spec.js

@@ -0,0 +1,5 @@
+describe("failure", function(){
+  it("fails", function(){
+    (2 + 2).should.equal(5);
+  });
+});

data/spec/dummy/spec/javascripts/spec_helper.js

@@ -0,0 +1,3 @@
+//= require_tree ./templates
+
+var two_plus_two = function () { return 2 + 2; };

data/spec/dummy/spec/javascripts/spec_helper_spec.js

@@ -0,0 +1,7 @@
+//= require spec_helper
+
+describe("two_plus_two", function(){
+  it("equals four", function(){
+    two_plus_two().should.equal(4);
+  })
+});

data/spec/dummy/spec/javascripts/subdirectory/subdirectory_spec.js

@@ -0,0 +1,5 @@
+describe("spec in subdirectory", function(){
+  it("passes", function(){
+    (2 + 2).should.equal(4);
+  });
+});

data/spec/dummy/spec/javascripts/templates/hello.jst.ejs

@@ -0,0 +1 @@
+<h1>Hello Matcha!</h1>

data/spec/dummy/spec/javascripts/templating_spec.js

@@ -0,0 +1,8 @@
+//= require spec_helper
+
+describe("templating", function(){
+  it("is built in to Sprockets", function(){
+    $('#test').html(JST['templates/hello']());
+    $('#test h1').text().should.equal('Hello Matcha!');
+  });
+});