jazrb 0.1.0

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,134 @@
+= jazrb
+
+Jazrb provides support for running JavaScript specs written using the
+Jasmine JavaScript BDD framework under env.js. It includes support for
+running via watchr and autotest.
+
+Discussion at http://groups.google.com/group/jazrb.
+
+== Install
+
+You can install the gem via <tt>gem install smparkes-jazrb</tt>.  If
+you want to install from github (http://github.com/smparkes/jazrb),
+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>jazrb</tt> command as you would the
+rspec <tt>spec</tt> command, e.g.,
+
+     jazrb spec/foo_spec.js spec/bar_spec.js
+
+You can also execute HTML specs via jazrb:
+
+     jazrb 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>jazrb</tt> command.
+
+jazrb 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>jazrb</tt> the <tt>-v</tt> flag.
+
+The Jasmine tests are configured to report results in streaming XML
+(JUnit format, more or less), which <tt>jazrb</tt> turns into the
+familiar rspec format. The <tt>--xml</tt> flag
+causes <tt>jazrb</tt> to display the raw XML output.
+
+To run all the tests in the <tt>spec</tt> directory repeatedly you can
+use watchr:
+
+  rake test
+
+or
+
+  watchr jazrb.watchr
+
+or even
+
+  ./jazrb.watchr
+
+See jazrb's own <tt>jazrb.watchr</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>jazrb</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>watchr</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 the watchr control file,
+<tt>jazrb.watchr</tt>. (Watchr as a runner will probably replace
+autojaz.)  You'll need the smparkes-watchr gem.
+
+Running <tt>jazrb.watchr</tt> (either with <tt>watchr jazrb.watchr</tt>
+or as <tt>./jazrb.watchr</tt> 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>: jazrb 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 watchr dependences
+
+1. Add watchr support
+
+1. Add example
+
+1. Support multiple fixtures on the <tt>jazrb</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/autojaz

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+ENV['JAZRB'] = 'true'           # allows autotest to discover jazrb
+ENV['AUTOTEST'] = 'true'        # allows autotest to run w/ color on linux
+system (RUBY_PLATFORM =~ /mswin|mingw/ ? 'autotest.bat' : 'autotest'), *ARGV

data/bin/jazrb

@@ -0,0 +1,230 @@
+#!/usr/bin/env ruby
+
+$VERBOSE = true
+
+require 'jazrb/options'
+
+ENV["JAZRB_JS_PATH"] =
+  JAZ_DIR = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'jazrb'))
+
+intro = File.join(JAZ_DIR, "intro.js")
+outro = File.join(JAZ_DIR, "outro.js")
+
+if $jazrb_qunit
+  intro = File.join(JAZ_DIR, "qintro.js")
+  outro = File.join(JAZ_DIR, "qoutro.js")
+end
+
+args = [ "envjsrb" ]
+if $jazrb_deps
+  args += [ "--deps", $jazrb_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 $jazrb_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 !$jazrb_xml
+        if @testsuite_pending
+          char = yellow("*")
+          print char
+          $stdout.flush
+        end
+      end
+    when "testcase";
+      if !$jazrb_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 $jazrb_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 !$jazrb_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