Fingertips-headless-squirrel 0.2.0

data/README.rdoc

@@ -0,0 +1,53 @@
+= Headless Squirrel
+
+A JavaScript test runner to run tests from the comfort of your terminal.
+
+== Why?
+
+Because we want to run tests in a real browser environment, in our case WebKit,
+but in the same fashion we run out other (Rails) unit tests.
+
+And we want to write the tests in a way that we can easily run them on other
+browsers as well, you know, html and js… This way we can run the tests from the
+terminal during regular development but still test on other browsers by loading
+the html/js files manually.
+
+Read more at http://superalloy.nl/2009/04/13/js-test-san.html
+
+== Install & Usage
+
+  $ sudo gem install Fingertips-headless-squirrel -s http://gems.github.com
+  $ jstest path/to/a/unit_test.html
+
+To automatically run your test see http://github.com/alloy/kicker/tree/master.
+
+== Problems?
+
+You betcha! (See the example.)
+
+But these shouldn't likely be a typical use case, I hope. So it actually works
+quite well seeing how many tests pass ;) The one that does fail has to do with
+the fact that there's no window at all. I haven't yet tried if it will simply
+work with a NSWindow. Also not sure yet why the end result says 2 failures…
+
+== Example:
+
+This is the output of the regression tests which are the Prototype unit tests:
+
+  $ ./bin/jstest test/regression/prototype/unit/*_test.html
+  ...................................................................................................................................
+  .......F...........................................................................................................................
+  ..............................................................................................
+
+    1) Failed:
+  testViewportDimensions (Unit test file | Dom | default template | 2009-04-11 15:28) [test/regression/prototype/unit/dom_test.html]:
+  Failure: NOTE: YOU MUST ALLOW JAVASCRIPT TO RESIZE YOUR WINDOW FOR THIS TEST TO PASS
+  expected: <50>, actual: <0>
+  Failure: NOTE: YOU MUST ALLOW JAVASCRIPT TO RESIZE YOUR WINDOW FOR THIS TEST TO PASS
+  expected: <50>, actual: <0>
+
+  Finished in 17.725139 seconds.
+
+  356 tests, 2246 assertions, 2 failures, 0 errors
+
+See regression_test.rdoc[link:regression_test.rdoc] for more tests.

data/Rakefile

@@ -0,0 +1,49 @@
+task :default => :test
+
+desc "Run the tests"
+task :test do
+  sh "specrb -s #{Dir['test/unit/*_test.rb'].join(' ')}"
+end
+
+# HeadlessSquirrel::Rake::Runner.new :regression do |t|
+#   t.files = Dir['test/regression/prototype/unit/*.html']
+# end
+
+desc "Run all the regression tests"
+task :ci do
+  sh "./bin/jstest #{Dir['test/regression/**/unit/*_test.html'].join(' ')}"
+end
+
+namespace :ci do
+  desc "Run the prototype regression tests"
+  task :prototype do
+    sh "./bin/jstest #{Dir['test/regression/prototype/unit/*_test.html'].join(' ')}"
+  end
+  
+  desc "Run the scriptaculous regression tests"
+  task :scriptaculous do
+    sh "./bin/jstest #{Dir['test/regression/scriptaculous/unit/*_test.html'].join(' ')}"
+  end
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "headless-squirrel"
+    gemspec.summary = "A command-line JavaScript test runner for the Mac."
+    gemspec.description = "A OS X command line tool to run JavaScript (Prototype) unit tests from the comfort of your terminal."
+    gemspec.homepage = "http://github.com/Fingertips/headless-squirrel/tree/master"
+    
+    gemspec.email = "eloy.de.enige@gmail.com"
+    gemspec.authors = ["Eloy Duran"]
+  end
+rescue LoadError
+end
+
+begin
+  require 'jewelry_portfolio/tasks'
+  JewelryPortfolio::Tasks.new do |p|
+    p.account = 'Fingertips'
+  end
+rescue LoadError
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:patch: 0
+:major: 0
+:minor: 2

data/bin/jstest

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'headless_squirrel'
+
+if ARGV.empty?
+  puts "Usage: #{$0} [html files]"
+else
+  HeadlessSquirrel::Runner.alloc.initWithHTMLFiles(ARGV).run
+end

data/lib/headless_squirrel/runner.rb

@@ -0,0 +1,70 @@
+require 'osx/cocoa'
+
+module HeadlessSquirrel
+  class Runner < OSX::NSObject
+    attr_reader :test_cases, :queued, :did_not_pass
+    
+    def initWithHTMLFiles(html_files)
+      if init
+        @test_cases = []
+        @test_cases = html_files.map { |file| TestCase.alloc.initWithHTMLFile_delegate(file, self) }
+        @queued = @test_cases.dup
+        @did_not_pass = []
+        
+        $stdout.sync = true
+        
+        self
+      end
+    end
+    
+    def run
+      @start_time = Time.now
+      @queued.first.run
+      OSX::NSApplication.sharedApplication.run
+    end
+    
+    def tests;      sum :tests      end
+    def assertions; sum :assertions end
+    def failures;   sum :failures   end
+    def errors;     sum :errors     end
+    
+    def test_ran(test)
+      @did_not_pass << test unless test.state == :passed
+      
+      print case test.state
+      when :passed
+        '.'
+      when :failed
+        'F'
+      when :error
+        'E'
+      end
+    end
+    
+    def test_case_finished(test_case)
+      @queued.delete(test_case)
+      @queued.empty? ? finalize : @queued.first.run
+    end
+    
+    def finished?
+      @finished
+    end
+    
+    private
+    
+    def sum(attr)
+      @test_cases.inject(0) { |sum, tc| sum += tc.send(attr) }
+    end
+    
+    def finalize
+      @finished = true
+      
+      puts
+      @did_not_pass.each_with_index { |test, index| puts "\n  #{index+1}) #{test}" }
+      puts "\nFinished in #{Time.now - @start_time} seconds."
+      puts "\n#{tests} tests, #{assertions} assertions, #{failures} failures, #{errors} errors"
+      
+      OSX::NSApplication.sharedApplication.terminate(self)
+    end
+  end
+end

data/lib/headless_squirrel/test.rb

@@ -0,0 +1,17 @@
+module HeadlessSquirrel
+  class TestCase < OSX::NSObject
+    class Test
+      attr_reader :test_case, :name, :state, :output
+      
+      def initialize(test_case, name, state, output)
+        @test_case, @name, @state, @output = test_case, name, state, output
+      end
+      
+      def to_s
+%{#{@state.to_s.capitalize}:
+#{@name} (#{@test_case.title}) [#{@test_case.html_file}]:
+#{@output}}
+      end
+    end
+  end
+end

data/lib/headless_squirrel/test_case.rb

@@ -0,0 +1,121 @@
+require "osx/cocoa"
+OSX.require_framework 'WebKit'
+
+require 'headless_squirrel/test'
+
+module HeadlessSquirrel
+  class TestCase < OSX::NSObject
+    class FileDoesNotExistError < StandardError; end
+    
+    def self.sharedWebView
+      @sharedWebView ||= OSX::WebView.alloc.init
+    end
+    
+    RESULTS_REGEXP = /^((\d+) tests, )?(\d+) assertions, (\d+) failures, (\d+) errors\n?/
+    
+    STATES = %w{ passed failed error }
+    
+    attr_reader :html_file, :delegate, :title
+    attr_reader :tests, :assertions, :failures, :errors
+    
+    def initWithHTMLFile_delegate(html_file, delegate)
+      if init
+        raise FileDoesNotExistError, "The file `#{html_file}' does not exist." unless File.exist?(html_file)
+        @html_file, @delegate = html_file, delegate
+        @tests = @assertions = @failures = @errors = 0
+        @title = ''
+        self
+      end
+    end
+    
+    def run
+      webView
+    end
+    
+    def finished?
+      @finished
+    end
+    
+    def webView
+      @webView ||= load_webView
+    end
+    
+    def document
+      webView.mainFrame.DOMDocument
+    end
+    
+    def log
+      document.getElementsByClassName('logsummary').item(0)
+    end
+    
+    def loglines
+      document.getElementsByClassName('loglines').item(0)
+    end
+    
+    # Not yet sure why the extra check for log not being nil is necessary.
+    # Might be a test only thing.
+    def webView_didFinishLoadForFrame(_, __)
+      @title = webView.mainFrameTitle.to_s
+      [log, loglines].each do |element|
+        element.addEventListener___('DOMSubtreeModified', self, true) if element
+      end
+    end
+    
+    # Catches resource load errors:
+    #
+    # webView.resourceLoadDelegate = self
+    #
+    # def webView_resource_didFailLoadingWithError_fromDataSource(w,r,e,d)
+    #   message = "#{e.userInfo['NSLocalizedDescription']}: #{e.userInfo['NSErrorFailingURLStringKey']}"
+    #   @delegate.test_ran(Test.new(self, "Unable to load test case", :failed, message))
+    #   @delegate.test_case_finished(self)
+    # end
+    
+    # Logs js errors:
+    #
+    # webView.setUIDelegate(self)
+    #
+    # def webView_addMessageToConsole(_, msg)
+    #   p msg
+    # end
+    
+    def handleEvent(event)
+      element = event.target
+      case element
+      when OSX::DOMText
+        finalize unless log.innerText == 'running...'
+      else
+        parent = element.parentNode
+        state = parent.className
+        
+        if element == parent.lastChild && STATES.include?(state)
+          output = parent.children.item(2).innerText.to_s
+          return if output.empty?
+          
+          output.sub!(RESULTS_REGEXP, '')
+          name = parent.children.item(0).innerText
+          
+          @delegate.test_ran(Test.new(self, name, state.to_sym, output))
+        end
+      end
+    end
+    
+    private
+    
+    def load_webView
+      url = OSX::NSURL.fileURLWithPath(@html_file)
+      req = OSX::NSURLRequest.requestWithURL(url)
+      webView = self.class.sharedWebView
+      webView.mainFrame.loadRequest(req)
+      webView.frameLoadDelegate = self
+      webView
+    end
+    
+    def finalize
+      @finished = true
+      results = log.innerText.to_s.scan(RESULTS_REGEXP).first[1..-1]
+      @tests, @assertions, @failures, @errors = results.map { |x| x.to_i }
+      @delegate.test_case_finished(self)
+    end
+  end
+end

data/lib/headless_squirrel.rb

@@ -0,0 +1,2 @@
+require 'headless_squirrel/test_case'
+require 'headless_squirrel/runner'

data/test/fixtures/a_unit_test.html

@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>A HeadlessSquirrel Unit Test HTML File</title>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+  
+  <script type="text/javascript" charset="utf-8">
+    var eventResults = {};
+    var originalElement = window.Element;
+  </script>
+  
+  <script src="../regression/prototype/unit/assets/prototype.js" type="text/javascript" charset="utf-8"></script>
+  <script src="../regression/prototype/unit/assets/unittest.js" type="text/javascript" charset="utf-8"></script>
+  <script src="a_unit_test.js" type="text/javascript" charset="utf-8"></script>
+</head>
+<body>
+
+<div id="testlog"></div>
+
+<div id="content"></div>
+
+</body>
+</html>
+<script type="text/javascript" charset="utf-8">
+  eventResults.endOfDocument = true;
+</script>

data/test/fixtures/a_unit_test.js

@@ -0,0 +1,22 @@
+// 3 tests, 2 assertions, 1 failures, 1 errors
+
+new Test.Unit.Runner({
+  setup: function() {
+    this.content = $('content');
+    this.content.update('');
+  },
+  
+  testHelloWorldSuccess: function() {
+    this.assertEqual("", this.content.innerHTML);
+    this.content.update('Hello world!');
+    this.assertEqual("Hello world!", this.content.innerHTML);
+  },
+  
+  testHelloWorldFailure: function() {
+    this.assertEqual("Hello world!", this.content.innerHTML);
+  },
+  
+  testHelloWorldError: function() {
+    this.content.foo();
+  },
+});

data/test/regression/prototype/unit/ajax_test.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Unit test file | Ajax | default template | 2009-04-11 15:28</title>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+  <script type="text/javascript" charset="utf-8">
+    var eventResults = {};
+    var originalElement = window.Element;
+  </script>
+  <script src="assets/prototype.js" type="text/javascript" charset="utf-8"></script>
+<script src="assets/unittest.js" type="text/javascript" charset="utf-8"></script>
+<link rel="stylesheet" href="assets/unittest.css" type="text/css" />
+  
+  <script src="fixtures/ajax.js" type="text/javascript" charset="utf-8"></script>
+  <script src="tests/ajax_test.js" type="text/javascript" charset="utf-8"></script>
+</head>
+<body>
+
+<div id="testlog"></div>
+
+<div id="content"></div>
+<div id="content2" style="color:red"></div>
+
+</body>
+</html>
+<script type="text/javascript" charset="utf-8">
+  eventResults.endOfDocument = true;
+</script>

data/test/regression/prototype/unit/array_test.html

@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Unit test file | Array | default template | 2009-04-11 15:28</title>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+  <script type="text/javascript" charset="utf-8">
+    var eventResults = {};
+    var originalElement = window.Element;
+  </script>
+  <script src="assets/prototype.js" type="text/javascript" charset="utf-8"></script>
+<script src="assets/unittest.js" type="text/javascript" charset="utf-8"></script>
+<link rel="stylesheet" href="assets/unittest.css" type="text/css" />
+  
+  
+  <script src="tests/array_test.js" type="text/javascript" charset="utf-8"></script>
+</head>
+<body>
+
+<div id="testlog"></div>
+
+<div id="test_node">22<span id="span_1"></span><span id="span_2"></span></div>
+
+</body>
+</html>
+<script type="text/javascript" charset="utf-8">
+  eventResults.endOfDocument = true;
+</script>