alloy-js-test-san 0.1.0

data/README.rdoc

@@ -0,0 +1,83 @@
+= JSTestSan
+
+A JavaScript test runner to run JavaScript 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.
+
+== Install & Usage
+
+  $ sudo gem install alloy-js-test-san -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 outside of testing the
+Prototype implementation, I hope. So it actually works quite well seeing how
+many tests pass ;)
+
+== Example:
+
+This is the output of the regression tests which are the Prototype unit tests:
+
+  $ ./bin/jstest test/regression/prototype/unit/*_test.html
+  EEFF.......F..............................................................................................................................F
+  ..............................................................F............................................................................
+  ..............................................................................
+
+    1) Error:
+  testSynchronousRequest (Unit test file | Ajax | default template | 2009-04-11 15:28) [test/regression/prototype/unit/ajax_test.html]:
+  TypeError: Null value, error=(TypeError: Null value)
+
+    2) Error:
+  testAsynchronousRequest (Unit test file | Ajax | default template | 2009-04-11 15:28) [test/regression/prototype/unit/ajax_test.html]:
+  TypeError: Null value, error=(TypeError: Null value)
+
+    3) Failed:
+  testUpdater (Unit test file | Ajax | default template | 2009-04-11 15:28) [test/regression/prototype/unit/ajax_test.html]:
+  Failure: assertEqual
+  expected: <'pack my box with <em>five dozen</em> liquor jugs! oh, how <strong>quickly</strong> daft jumping zebras vex...'>, actual: <''>
+  Failure: assertEqual
+  expected: <'pack my box with <em>five dozen</em> liquor jugs! oh, how <strong>quickly</strong> daft jumping zebras vex...'>, actual: <''>
+
+    4) Failed:
+  testUpdaterWithInsertion (Unit test file | Ajax | default template | 2009-04-11 15:28) [test/regression/prototype/unit/ajax_test.html]:
+  Failure: assertEqual
+  expected: <'pack my box with <em>five dozen</em> liquor jugs! oh, how <strong>quickly</strong> daft jumping zebras vex...'>, actual: <''>
+  Failure: assertEqual
+  expected: <'pack my box with <em>five dozen</em> liquor jugs! oh, how <strong>quickly</strong> daft jumping zebras vex...'>, actual: <''>
+  Failure: assertEqual
+  expected: <'five dozen'>, actual: <''>
+
+    5) Failed:
+  testResponseText (Unit test file | Ajax | default template | 2009-04-11 15:28) [test/regression/prototype/unit/ajax_test.html]:
+  Failure: assertEqual
+  expected: <'pack my box with <em>five dozen</em> liquor jugs! oh, how <strong>quickly</strong> daft jumping zebras vex...'>, actual: <''>
+
+    6) 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>
+
+    7) Failed:
+  testFormRequest (Unit test file | Form | default template | 2009-04-11 15:28) [test/regression/prototype/unit/form_test.html]:
+  Failure: wrong default action for form element with empty action attribute
+  got <false>
+
+  Finished in 17.729032 seconds.
+
+  356 tests, 2237 assertions, 9 failures, 2 errors

data/Rakefile

@@ -0,0 +1,27 @@
+task :default => :test
+
+desc "Run the tests"
+task :test do
+  sh "specrb -s #{Dir['test/unit/*_test.rb'].join(' ')}"
+end
+
+# JSTestSan::Rake::Runner.new :regression do |t|
+#   t.files = Dir['test/regression/prototype/unit/*.html']
+# end
+
+desc "Run the regression tests"
+task :ci do
+  sh "./bin/jstest #{Dir['test/regression/prototype/unit/*.html'].join(' ')}"
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "js-test-san"
+    gemspec.summary = gemspec.description = "A JavaScript test runner which runs from the comfort of the terminal. OS X only."
+    gemspec.email = "eloy.de.enige@gmail.com"
+    gemspec.homepage = "http://github.com/alloy/js-test-san/tree/master"
+    gemspec.authors = ["Eloy Duran"]
+  end
+rescue LoadError
+end

data/VERSION.yml

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

data/bin/jstest

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

data/lib/js_test_san/runner.rb

@@ -0,0 +1,70 @@
+require 'osx/cocoa'
+
+module JSTestSan
+  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/js_test_san/test.rb

@@ -0,0 +1,17 @@
+module JSTestSan
+  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/js_test_san/test_case.rb

@@ -0,0 +1,103 @@
+require "osx/cocoa"
+OSX.require_framework 'WebKit'
+
+require 'js_test_san/test'
+
+module JSTestSan
+  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
+    
+    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/js_test_san.rb

@@ -0,0 +1,2 @@
+require 'js_test_san/test_case'
+require 'js_test_san/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 JSTestSan 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>