jazz 0.1.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Steven Parkes
+
+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.rdoc

@@ -0,0 +1,129 @@
+= jazz
+
+Jazz provides support for running JavaScript specs written using
+frameworks such as Jasmine under env.js. It includes support for
+running via wake.
+
+Discussion at http://groups.google.com/group/jazz-talk or #jazz-talk at freenode.
+
+== Install
+
+You can install the gem via <tt>gem install smparkes-jazz</tt>.  If
+you want to install from github (http://github.com/smparkes/jazz),
+you'll need to checkout the Jasmine submodule (<tt>git submodule
+update --init</tt>) and also need to make sure you have the
+prerequisites listed in the gemspec in the Rakefile. <tt>rake
+gemspec</tt> will then build and copy the necessary parts of Jasmine.
+
+If you want to run the examples/tests, you'll need jQuery. The <tt>git
+submodule update --init</tt> command will have brought in jQuery, but
+you'll need to build it: <tt>cd vendor/jquery && make</tt>.
+
+Even if you install the gem, you may want to get the github files to
+see and run the examples.
+
+== Use
+
+From the root of a project, i.e., the parent of the <tt>spec</tt>
+directory, you can use the <tt>jazz</tt> command as you would the
+rspec <tt>spec</tt> command, e.g.,
+
+     jazz spec/foo_spec.js spec/bar_spec.js
+
+You can also execute HTML specs via jazz:
+
+     jazz spec/foo_spec.html
+
+or even normal pages, that have the proper hooks to run as examples
+(see below).
+
+HTML files must be valid XML, i.e., XHTML, at this time.
+
+The HTML fixture must load the necessary test files. Any number of
+fixtures can be passed to the <tt>jazz</tt> command.
+
+jazz uses env.js to run the tests, feeding it your HTML and
+JavaScript, plus the necessary JavaScript and controls to make the tests
+run correctly. You can see the entire <tt>envjsrb</tt> command by
+passing <tt>jazz</tt> the <tt>-v</tt> flag.
+
+The Jasmine tests are configured to report results in streaming XML
+(JUnit format, more or less), which <tt>jazz</tt> turns into the
+familiar rspec format. The <tt>--xml</tt> flag
+causes <tt>jazz</tt> to display the raw XML output.
+
+To run all the tests in the <tt>spec</tt> directory repeatedly you can
+use wake:
+
+  rake test
+
+or
+
+  wake
+
+See jazz's <tt>Wakefile</tt> file and the
+discussion on examples below.
+
+You can also try using <tt>autojaz</tt> as
+you would use <tt>autospec</tt>:
+
+   autojaz
+
+You'll need to install the ZenTest gem if you don't have it installed;
+<tt>jazz</tt> can be used without ZenTest installed, but
+<tt>autojaz</tt> cannot be. Note that <tt>autojaz</tt> may be
+deprecated in favor of <tt>wake</tt>.
+
+Screen shot at http://www.scrnshots.com/users/smparkes/screenshots/206033
+
+== Examples
+
+There are examples in <tt>examples/*</tt> and <tt>spec/examples/*</tt>. You can run the
+tests with <tt>rake test</tt> which will run wake against the Wakefile.
+(Wake as a runner will probably replace
+autojaz.)  You'll need the wake gem.
+
+Running wake will run all the
+tests and then watch the file system for changes. When it sees a change,
+it reruns the test. It knows how to find the HTML fixtures for specs
+where they exist in the right place, or it just runs the JavaScript
+spec itself. An example of the former is the pair
+<tt>example/hello_world.html</tt> and
+<tt>spec/example/hello_world_spec.js</tt>: jazz will reload the HTML if either file is changed.
+An example of the latter
+is <tt>spec/example/plain_spec.js</tt>.
+
+You can also load the individual HTML files in the browser to run the
+tests there. For example, on a Mac, <tt>open
+example/hello_world.html</tt>. (The idea is that for production, the
+spec helper files are changed to not load the tests: that should be
+the only change necessary. Or the <tt><script></tt> tag could be
+ripped out.)  Note that to run the tests from the filesystem in Firefox, you'll
+need to set the <tt>security.fileuri.strict_origin_policy</tt> option
+to true.
+
+== Recent Changes
+
+1. Pass dependence flag to envjsrb to support wake dependences
+
+1. Add wake support
+
+1. Add example
+
+1. Support multiple fixtures on the <tt>jazz</tt> command. (Actually, this is entirely due to <tt>envjsrb</tt> supporting multiple fixtures. You need a recent build from github or an smparkes-envjs gem version of at least 0.0.5.)
+
+== Things to do
+
+1. Complete and test support for loading against an HTTP server.
+
+1. Focus on failing tests until fixed, a la autotest.
+
+1. Extend to more frameworks, e.g., qunit. There's little here that's actually Jasmine-specific.
+
+1. Including a missing script should be an error
+
+1. Make work in interactive mode (requires intro/outro/out:blank intergration with envjsrb)
+
+== Copyright
+
+Copyright (c) 2009 Steven Parkes. See LICENSE for details.

data/bin/jazz

@@ -0,0 +1,230 @@
+#!/usr/bin/env ruby
+
+$VERBOSE = true
+
+require 'jazz/options'
+
+ENV["JAZZ_JS_PATH"] =
+  JAZ_DIR = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'jazz'))
+
+intro = File.join(JAZ_DIR, "intro.js")
+outro = File.join(JAZ_DIR, "outro.js")
+
+if $jazz_qunit
+  intro = File.join(JAZ_DIR, "qintro.js")
+  outro = File.join(JAZ_DIR, "qoutro.js")
+end
+
+args = [ "envjsrb" ]
+if $jazz_deps
+  args += [ "--deps", $jazz_deps ]
+end
+args << intro
+
+introd = true
+outrod = true
+
+ARGV.each do |f|
+
+  if f =~  /\.x?html?$/ || f =~ %r(^https?://)
+    if introd && !outrod
+      args << outro
+      args << "about:blank"
+      outrod = true
+      introd = false
+    end
+    if !introd
+      args << intro
+    end
+    args << f
+    introd = true
+    outrod = false
+  elsif f == "about:blank"
+    if introd && !outrod
+      args << outro
+      outrod = true
+      introd = false
+    end
+    args << f
+  else
+    args << f
+  end
+
+end
+
+args << outro
+
+cmd = args.join(" ")
+
+puts cmd if $jazz_verbose 
+
+require 'eventmachine'
+require 'nokogiri'
+
+class Restart < Exception; end
+
+def colour(text, colour_code)
+  # return text unless ENV['RSPEC_COLOR'] || (colour? & (autospec? || output_to_tty?))
+  "#{colour_code}#{text}\e[0m"
+end
+
+def green(text); colour(text, "\e[32m"); end
+def red(text); colour(text, "\e[31m"); end
+def yellow(text); colour(text, "\e[33m"); end
+def blue(text); colour(text, "\e[34m"); end
+
+$spec_info = {}
+$spec_info[:specs] = []
+$spec_info[:failures] = []
+$spec_info[:pending] = []
+
+class SAX < Nokogiri::XML::SAX::Document
+
+  def start_element name, attrs
+    # p attrs
+    attrs = Hash[*attrs]
+    # p attrs
+    case name
+    when "testsuites";
+    when "testsuite";
+      @testsuite_name = attrs["name"]
+      if @testsuite_pending = ( attrs["skipped"] == "true" )
+        $spec_info[:specs] << (tc = {})
+        tc[:name] = @testsuite_name
+        $spec_info[:pending] << $spec_info[:specs].last
+      end
+    when "testcase";
+      $spec_info[:specs] << (tc = {})
+      tc[:name] = @testsuite_name + " : " + attrs["name"]
+      @testcase_failed = false
+    when "failure";
+      $spec_info[:failures] << (tc = $spec_info[:specs].last)
+      tc[:message] = attrs["message"]
+      @testcase_failed = true
+    else; raise "hell: #{name}"
+    end
+  end
+
+  def cdata_block string
+    if @testcase_failed
+      $spec_info[:failures].last[:stack] ||= ""
+      $spec_info[:failures].last[:stack] << string
+    end
+  end
+
+  def end_element name
+    case name
+    when "testsuites";
+      raise Restart
+    when "testsuite";
+      if !$jazz_xml
+        if @testsuite_pending
+          char = yellow("*")
+          print char
+          $stdout.flush
+        end
+      end
+    when "testcase";
+      if !$jazz_xml
+        char = nil
+        if @testcase_failed
+          char = red("F")
+        else
+          char = green(".")
+        end
+        print char
+        $stdout.flush
+      end
+    when "failure";
+    else; raise "hell: #{name}"
+    end
+  end
+end
+
+$failed_processes = 0
+
+module WriteToNokogiri
+  def post_init
+    @parser = Nokogiri::XML::SAX::PushParser.new( SAX.new )
+  end
+  def receive_data data
+    begin
+      if $jazz_xml
+        # $stderr.print data
+        puts data
+        $stdout.flush
+      end
+      @parser << data
+    rescue Restart
+      @parser = Nokogiri::XML::SAX::PushParser.new( SAX.new )
+    rescue Exception => e
+      $stderr.puts "Parser raised #{e} on #{data}"
+      exit 1
+    end
+  end
+  def unbind
+    $failed_processes += 1  if get_status.exitstatus &&
+                               get_status.exitstatus  > 0
+    EM.stop
+  end
+end
+
+date = Time.now
+failures = nil
+examples = nil
+pending = nil
+
+EM.run do
+  EM.popen cmd, WriteToNokogiri
+end
+
+puts
+puts
+
+if !$jazz_xml
+  if $spec_info[:pending].length > 0
+    puts "Pending:"
+    $spec_info[:pending].each do |pending|
+      puts
+      puts yellow(pending[:name])
+    end
+    puts "\n"
+  end
+  $spec_info[:failures].each_with_index do |failure,i|
+    print i+1,")\n"
+    print red("#{failure[:name]} FAILED\n")
+    print red(failure[:message]),"\n"
+    # double check, but is there really anything in the jaz stack that's useful?
+    stack = failure[:stack]
+    stack and ( stack = stack.split "\n" )
+    stack and stack.each do |line|
+      if line =~ %r(/jasmine.js:\d+) || line =~ %r(/jasmine/src/.*\.js:\d+)
+        break
+      end
+      print line, "\n"
+    end
+    # p stack
+    # print failure[:stack],"\n"
+  end
+  puts "Finished in #{Time.now - date} seconds"
+  puts
+  examples = $spec_info[:specs].length
+  # require 'pp'
+  # pp $spec_info[:specs]
+  failures = $spec_info[:failures].length
+  pending = $spec_info[:pending].length
+  if $failed_processes > 0
+    examples += $failed_processes 
+    failures += $failed_processes 
+  end
+  msg = "#{examples} examples, #{failures} failures, #{pending} pending"
+  if failures > 0
+    msg = red(msg)
+  elsif pending > 0
+    msg = yellow(msg)
+  else
+    msg = green(msg)
+  end
+  puts msg
+end
+exit ( !failures.nil? && failures > 0 ) ? 1 : 0

data/doc/jasmine/files.html

@@ -0,0 +1,460 @@
+<!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>
+		<meta http-equiv="content-type" content="text/html; charset=utf-8"" />
+		
+		<title>JsDoc Reference - File Index</title>
+		<meta name="generator" content="JsDoc Toolkit" />
+		
+		<style type="text/css">
+		/* default.css */
+body
+{
+	font: 12px "Lucida Grande", Tahoma, Arial, Helvetica, sans-serif;
+	width: 800px;
+}
+
+.header
+{
+	clear: both;
+	background-color: #ccc;
+	padding: 8px;
+}
+
+h1
+{
+	font-size: 150%;
+	font-weight: bold;
+	padding: 0;
+	margin: 1em 0 0 .3em;
+}
+
+hr
+{
+	border: none 0;
+	border-top: 1px solid #7F8FB1;
+	height: 1px;
+}
+
+pre.code
+{
+	display: block;
+	padding: 8px;
+	border: 1px dashed #ccc;
+}
+
+#index
+{
+	margin-top: 24px;
+	float: left;
+	width: 160px;
+	position: absolute;
+	left: 8px;
+	background-color: #F3F3F3;
+	padding: 8px;
+}
+
+#content
+{
+	margin-left: 190px;
+	width: 600px;
+}
+
+.classList
+{
+	list-style-type: none;
+	padding: 0;
+	margin: 0 0 0 8px;
+	font-family: arial, sans-serif;
+	font-size: 1em;
+	overflow: auto;
+}
+
+.classList li
+{
+	padding: 0;
+	margin: 0 0 8px 0;
+}
+
+.summaryTable { width: 100%; }
+
+h1.classTitle
+{
+	font-size:170%;
+	line-height:130%;
+}
+
+h2 { font-size: 110%; }
+caption, div.sectionTitle
+{
+	background-color: #7F8FB1;
+	color: #fff;
+	font-size:130%;
+	text-align: left;
+	padding: 2px 6px 2px 6px;
+	border: 1px #7F8FB1 solid;
+}
+
+div.sectionTitle { margin-bottom: 8px; }
+.summaryTable thead { display: none; }
+
+.summaryTable td
+{
+	vertical-align: top;
+	padding: 4px;
+	border-bottom: 1px #7F8FB1 solid;
+	border-right: 1px #7F8FB1 solid;
+}
+
+/*col#summaryAttributes {}*/
+.summaryTable td.attributes
+{
+	border-left: 1px #7F8FB1 solid;
+	width: 140px;
+	text-align: right;
+}
+
+td.attributes, .fixedFont
+{
+	line-height: 15px;
+	color: #002EBE;
+	font-family: "Courier New",Courier,monospace;
+	font-size: 13px;
+}
+
+.summaryTable td.nameDescription
+{
+	text-align: left;
+	font-size: 13px;
+	line-height: 15px;
+}
+
+.summaryTable td.nameDescription, .description
+{
+	line-height: 15px;
+	padding: 4px;
+	padding-left: 4px;
+}
+
+.summaryTable { margin-bottom: 8px; }
+
+ul.inheritsList
+{
+	list-style: square;
+	margin-left: 20px;
+	padding-left: 0;
+}
+
+.detailList {
+	margin-left: 20px; 
+	line-height: 15px;
+}
+.detailList dt { margin-left: 20px; }
+
+.detailList .heading
+{
+	font-weight: bold;
+	padding-bottom: 6px;
+	margin-left: 0;
+}
+
+.light, td.attributes, .light a:link, .light a:visited
+{
+	color: #777;
+	font-style: italic;
+}
+
+.fineprint
+{
+	text-align: right;
+	font-size: 10px;
+}
+		</style>
+	</head>
+	
+	<body>
+		<div id="header">
+</div>
+		
+		<div id="index">
+			<div align="center"><a href="index.html">Class Index</a>
+| <a href="files.html">File Index</a></div>
+<hr />
+<h2>Classes</h2>
+<ul class="classList">
+	
+	<li><i><a href="symbols/_global_.html">_global_</a></i></li>
+	
+	<li><a href="symbols/jasmine.html">jasmine</a></li>
+	
+	<li><a href="symbols/jasmine.Block.html">jasmine.Block</a></li>
+	
+	<li><a href="symbols/jasmine.Clock.html">jasmine.Clock</a></li>
+	
+	<li><a href="symbols/jasmine.Env.html">jasmine.Env</a></li>
+	
+	<li><a href="symbols/jasmine.JsApiReporter.html">jasmine.JsApiReporter</a></li>
+	
+	<li><a href="symbols/jasmine.Matchers.html">jasmine.Matchers</a></li>
+	
+	<li><a href="symbols/jasmine.MultiReporter.html">jasmine.MultiReporter</a></li>
+	
+	<li><a href="symbols/jasmine.NestedResults.html">jasmine.NestedResults</a></li>
+	
+	<li><a href="symbols/jasmine.Reporter.html">jasmine.Reporter</a></li>
+	
+	<li><a href="symbols/jasmine.Runner.html">jasmine.Runner</a></li>
+	
+	<li><a href="symbols/jasmine.Spec.html">jasmine.Spec</a></li>
+	
+	<li><a href="symbols/jasmine.Spy.html">jasmine.Spy</a></li>
+	
+	<li><a href="symbols/jasmine.Suite.html">jasmine.Suite</a></li>
+	
+	<li><a href="symbols/jasmine.util.html">jasmine.util</a></li>
+	
+</ul>
+<hr />
+		</div>
+		
+		<div id="content">
+			<h1 class="classTitle">File Index</h1>
+			
+			
+			<div>
+				<h2><a href="symbols/src/lib_TrivialReporter.js.html">lib/TrivialReporter.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_base.js.html">src/base.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Block.js.html">src/Block.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Env.js.html">src/Env.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_JsApiReporter.js.html">src/JsApiReporter.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Matchers.js.html">src/Matchers.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_mock-timeout.js.html">src/mock-timeout.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_MultiReporter.js.html">src/MultiReporter.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_NestedResults.js.html">src/NestedResults.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_PrettyPrinter.js.html">src/PrettyPrinter.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Queue.js.html">src/Queue.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Reporter.js.html">src/Reporter.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Reporters.js.html">src/Reporters.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Runner.js.html">src/Runner.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Spec.js.html">src/Spec.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_Suite.js.html">src/Suite.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_util.js.html">src/util.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_WaitsBlock.js.html">src/WaitsBlock.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			<div>
+				<h2><a href="symbols/src/src_WaitsForBlock.js.html">src/WaitsForBlock.js</a></h2>
+				
+				<dl>
+					
+					
+					
+					
+				</dl>
+			</div>
+			<hr />
+			
+			
+		</div>
+		<div class="fineprint" style="clear:both">
+			
+			Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blankt">JsDoc Toolkit</a> 2.1.0 on Tue Nov 24 2009 15:21:26 GMT-0800 (PST)
+		</div>
+	</body>
+</html>