jspec 2.11.2

data/Rakefile

@@ -0,0 +1,75 @@
+
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+def version
+  $1 if File.read('lib/jspec.js').match /version *: *'(.*?)'/
+end
+
+Echoe.new "jspec", version do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "JavaScript BDD Testing Framework"
+  p.url = "http://visionmedia.github.com/jspec"
+  p.runtime_dependencies << "sinatra"
+  p.runtime_dependencies << "json"
+  p.runtime_dependencies << "visionmedia-commander >=3.2.9"
+  p.runtime_dependencies << "visionmedia-bind >=0.2.6"
+end
+
+namespace :pkg do
+  desc 'Build package'
+  task :build => ['pkg:clear'] do
+    begin
+      sh 'mkdir pkg'
+      sh 'cp -fr lib/* pkg'
+      minify 'lib/jspec.js', 'pkg/jspec.min.js'
+      minify 'lib/jspec.jquery.js', 'pkg/jspec.jquery.min.js'
+      compress 'lib/jspec.css', 'pkg/jspec.min.css'
+      sh 'git add pkg/.'
+    rescue Exception => e
+      puts "Failed to package: #{e}."
+    else 
+      puts "Packaging of JSpec-#{version} completed."
+    end
+  end
+  
+  desc 'Clear packaging'
+  task :clear do
+    if File.directory? 'pkg'
+      sh 'rm -fr pkg/*'
+      sh 'rmdir pkg'
+    end
+  end
+  
+  desc 'Display compression savings of last release'
+  task :savings do
+    totals = Hash.new { |h, k|  h[k] = 0 }
+    format = '%-20s : %0.3f kb'
+    totals = %w( pkg/jspec.min.js pkg/jspec.jquery.min.js pkg/jspec.min.css ).inject totals do |total, file|
+      uncompressed = File.size(file.sub('.min', '')).to_f / 1024
+      compressed = File.size(file).to_f / 1024
+      saved = uncompressed - compressed
+      puts format % [file.sub('pkg/', ''), saved]
+      totals[:saved] += saved
+      totals[:uncompressed] += uncompressed
+      totals[:compressed] += compressed
+      totals
+    end
+    puts
+    puts format % ['total uncompressed', totals[:uncompressed]]
+    puts format % ['total compressed', totals[:compressed]]
+    puts format % ['total saved', totals[:saved]]
+  end
+end
+
+def minify from, to
+  sh "jsmin < #{from} > #{to}"
+end
+
+def compress from, to
+  File.open(to, 'w+') do |file|
+    file.write File.read(from).gsub(/(^[\t ]*)|\n/, '')
+  end
+end

data/bin/jspec

@@ -0,0 +1,305 @@
+#!/usr/bin/env ruby
+
+JSPEC_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+$:.unshift JSPEC_ROOT
+
+require 'rubygems'
+require 'commander'
+require 'bind'
+require 'fileutils'
+require 'server/server'
+
+RHINO = 'java org.mozilla.javascript.tools.shell.Main'
+
+program :name, 'JSpec'
+program :version, '2.11.2'
+program :description, 'JavaScript BDD Testing Framework'
+default_command :bind
+
+command :init do |c|
+  c.syntax = 'jspec init [dest]'
+  c.summary = 'Initialize a JSpec project template'
+  c.description = 'Initialize a JSpec project template. Defaults to the current directory
+    when [dest] is not specified. The template includes several files for 
+    running via Rhino, DOM, and the JSpec Rack server.
+    
+    Additional switches --freeze, and --symlink are available in order
+    to preserve the version of JSpec at the time of initialization. Otherwise
+    incompatibilities from later versions may prevent your suite from
+    running properly.'
+  c.option '-R', '--rails', 'Initialize rails template from rails root directory'
+  c.option '-f', '--freeze', 'Copy the JSpec library'
+  c.option '-s', '--symlink', 'Symlink the JSpec library instead of copying it'
+  c.example 'Create a directory foo, initialized with a jspec template', 'jspec init foo'
+  c.when_called do |args, options|
+    dest = args.shift || '.'
+    if options.rails
+      initialize_rails_at dest, options
+    else
+      initialize_at dest, options
+    end
+    say "Template initialized at `#{dest}'"
+  end
+end
+
+command :shell do |c|
+  c.syntax = 'jspec shell [path ...]'
+  c.summary = 'JSpec interactive shell'
+  c.description = 'Launch interactive shell with jspec.js, jspec.shell.js, 
+    and any [path]s given. Simply type "quit" or "exit" to 
+    terminate the shell.'
+  c.example 'Run shell', 'jspec shell'
+  c.example 'Run shell with glob of files', 'jspec shell lib/*.js'
+  c.example 'Run shell with list of files', 'jspec shell lib/foo.js lib/bar.js'
+  c.when_called do |args, options|
+    paths = ['jspec.js', 'jspec.shell.js'] | args
+    paths.map! do |path|
+      if path.include? 'jspec'
+        "-f #{JSPEC_ROOT}/lib/#{path}"
+      else
+        "-f #{path}"
+      end
+    end
+    say "JSpec #{program(:version)}"
+    `#{RHINO} #{paths.join(' ')} -f -`
+  end
+end
+
+command :update do |c|
+  c.syntax = 'jspec update [path ...]'
+  c.summary = 'Update JSpec releases'
+  c.description = 'Update JSpec release in [paths], this will allow you to utilize 
+    the latest JSpec features. Execute from JSpec project root without [paths] to
+    update the default template spec files.'
+  c.when_called do |args, options|
+    if args.empty?
+      if rails?
+        paths = 'jspec/spec.dom.html', 'jspec/spec.rhino.js'
+      else
+        paths = 'spec/spec.dom.html', 'spec/spec.rhino.js'
+      end
+    else
+      paths = args
+    end
+    update_version_in *paths
+  end
+end
+
+command :run do |c|
+  c.syntax = 'jspec run [path] [options]'
+  c.summary = 'Run specifications'
+  c.description = 'Run specifications, defaulting [path] to spec/spec.dom.html.
+    You will need to supply [path] if your specs do not reside 
+    in this location. `run --bind` is the default sub-command of
+    jspec so you may simply execute `jspec` in order to bind execution
+    of your specs when a file is altered.
+    
+    JSpec supports Rhino execution when installed. The [path] is assumed
+    to be spec/spec.rhino.js unless specified. See examples below for
+    using the --rhino switch.
+    
+    JSpec\'s server is also available via --server, which defaults 
+    the [path] to spec/server.html'
+  c.example 'Run once in Safari', 'jspec run'
+  c.example 'Run once in Safari and Firefox', 'jspec run --browsers Safari,Firefox'
+  c.example 'Run once in Opera, Firefox, and Chrome', 'jspec run --browsers opera,ff,chrome'
+  c.example 'Run custom spec file', 'jspec run foo.html'
+  c.example 'Auto-run browsers when a file is altered', 'jspec run --bind --browsers Safari,Firefox'
+  c.example 'Shortcut for the previous example', 'jspec --browsers Safari,Firefox'
+  c.example 'Auto-run rhino when a file is altered', 'jspec --rhino'
+  c.example 'Run Rhino specs at spec/rhino.js', 'jspec run --rhino'
+  c.example 'Run Rhino specs once', 'jspec run specs/something.js --rhino'
+  c.option '-b', '--browsers BROWSERS', Array, 'Specify browsers to test'
+  c.option '-p', '--paths PATHS', Array, 'Specify paths when binding, defaults to javascript within ./lib and ./spec'
+  c.option '-B', '--bind', 'Auto-run specs when source files or specs are altered'
+  c.option '-R', '--rhino', 'Run specs using Rhino'
+  c.option '-S', '--server', 'Run specs using the JSpec server'
+  c.option '-P', '--port NUMBER', Integer, 'Start JSpec server using the given port number'
+  c.when_called do |args, options|
+    
+    # Rails
+    if rails?
+      options.default :paths => ['public/javascripts/**/*.js', 'jspec/**/*.js'], :port => 4444
+    else              
+      options.default :paths => ['lib/**/*.js', 'spec/**/*.js'], :port => 4444
+    end
+    
+    # Actions
+    if options.rhino
+      suite = args.shift || path_to('spec.rhino.js')
+      action = lambda { rhino suite }
+    elsif options.server
+      raise 'Cannot use --server with --bind' if options.bind
+      suite = args.shift || path_to('spec.server.html')
+      action = lambda { start_server suite, options }
+    else
+      suite = args.shift || path_to('spec.dom.html')
+      browsers = browsers_for options.browsers || ['safari']
+      action = lambda do
+        browsers.each do |browser|
+          browser.visit File.expand_path(suite)
+        end
+      end
+    end
+    
+    # Binding
+    if options.bind
+      listener = Bind::Listener.new :paths => options.paths, :interval => 1, :actions => [action], :debug => $stdout
+      listener.run!
+    else
+      action.call File.new(suite)
+    end
+  end
+end
+alias_command :bind, :run, '--bind'
+
+##
+# Initialize template at _dest_. 
+
+def initialize_at dest, options
+  unless Dir[dest + '/*'].empty?
+    abort unless agree "'#{dest}' is not empty; continue? "
+  end
+  
+  copy_template_to 'default', dest
+  setup_lib_dir dest, options
+  replace_root_in dest, 'spec/spec.dom.html', 'spec/spec.rhino.js'
+end
+
+##
+# Initialize rails template at _dest_.
+
+def initialize_rails_at dest, options
+  unless looks_like_rails_root?(dest)
+    abort unless agree "'#{dest}' does not look like root of a rails project; continue? "
+  end
+  
+  copy_template_to 'rails', "#{dest}/jspec"
+  setup_lib_dir "#{dest}/jspec", options
+  replace_root_in "#{dest}/jspec", 'spec.dom.html', 'spec.rhino.js'
+end
+
+##
+# Copy template _name_ to _dest_.
+
+def copy_template_to name, dest
+  FileUtils.mkdir_p dest
+  FileUtils.cp_r path_to_template(name), dest
+end
+
+##
+# Return path to template _name_.
+
+def path_to_template name
+  File.join JSPEC_ROOT, 'templates', name, '.'
+end
+
+##
+# Resolve path to _file_. Supports rails and unbound projects.
+
+def path_to file
+  rails? ? "jspec/#{file}" : "spec/#{file}"
+end
+
+##
+# Execute _file_ with Rhino.
+
+def rhino file
+  raise "#{file} not found" unless File.exists? file
+  system "#{RHINO} #{file}"
+end
+
+##
+# Start server with _suite_ html and _options_.
+
+def start_server suite, options
+  set :port, options.port
+  set :server, 'Mongrel'
+  enable :sessions
+  disable :logging
+  hook = File.expand_path path_to('server.rb')
+  load hook if File.exists? hook
+  JSpec::Server.new(suite, options.port).start(options.browsers ? browsers_for(options.browsers) : nil)
+end
+
+##
+# Return array of browser instances for the given _names_.
+
+def browsers_for names
+  names.map do |name|
+    begin
+      Browser.subclasses.find do |browser|
+        browser.matches_name? name
+      end.new
+    rescue
+      raise "Unsupported browser `#{name}'"
+    end
+  end
+end
+
+##
+# Check if the current directory looks like a rails app.
+
+def rails?
+  File.directory? 'jspec'  
+end
+
+##
+# Replace JSPEC_ROOT placeholder in _paths_ relative to _dest_.
+
+def replace_root_in dest, *paths
+  if rails? && File.exist?("#{dest}/jspec/lib")
+    root = './jspec'
+  elsif File.exist?("#{dest}/spec/lib")
+    root = "./spec"
+  else
+    root = JSPEC_ROOT
+  end
+  
+  paths.each do |path|
+    path = File.join dest, path
+    contents = File.read(path).gsub 'JSPEC_ROOT', root
+    File.open(path, 'w') { |file| file.write contents }
+  end
+end
+
+##
+# Update JSpec version in _paths_. Matches visionmedia-jspec-TRIPLE
+
+def update_version_in *paths
+  paths.each do |path|
+    next unless File.exists? path
+    contents = File.read(path).gsub /visionmedia-jspec-(\d+\.\d+\.\d+)/, "visionmedia-jspec-#{program(:version)}"
+    File.open(path, 'r+'){ |file| file.write contents } 
+    say "Updated #{path}; #{$1} -> #{program(:version)}"
+  end
+  say "Finished updating JSpec"
+end
+
+##
+# Check if _path_ looks like a rails root directory.
+
+def looks_like_rails_root? path = '.'
+  File.directory? "#{path}/vendor"
+end
+
+##
+# Copy or symlink library to the specified path.
+
+def setup_lib_dir dest, options
+  return unless options.symlink || options.freeze
+  
+  if rails?
+    dest = File.join dest, "lib"
+  else
+    dest = File.join dest, "spec", "lib"
+  end
+  
+  from = File.join JSPEC_ROOT, "lib"
+  
+  if options.symlink
+    FileUtils.symlink from, dest, :force => true
+  else
+    FileUtils.cp_r from, dest
+  end
+end

data/jspec.gemspec

@@ -0,0 +1,44 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{jspec}
+  s.version = "2.11.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-09-21}
+  s.default_executable = %q{jspec}
+  s.description = %q{JavaScript BDD Testing Framework}
+  s.email = %q{tj@vision-media.ca}
+  s.executables = ["jspec"]
+  s.extra_rdoc_files = ["README.rdoc", "bin/jspec", "lib/images/bg.png", "lib/images/hr.png", "lib/images/loading.gif", "lib/images/sprites.bg.png", "lib/images/sprites.png", "lib/images/vr.png", "lib/jspec.css", "lib/jspec.jquery.js", "lib/jspec.js", "lib/jspec.shell.js", "lib/jspec.timers.js", "lib/jspec.xhr.js"]
+  s.files = ["History.rdoc", "Manifest", "README.rdoc", "Rakefile", "bin/jspec", "jspec.gemspec", "lib/images/bg.png", "lib/images/hr.png", "lib/images/loading.gif", "lib/images/sprites.bg.png", "lib/images/sprites.png", "lib/images/vr.png", "lib/jspec.css", "lib/jspec.jquery.js", "lib/jspec.js", "lib/jspec.shell.js", "lib/jspec.timers.js", "lib/jspec.xhr.js", "server/browsers.rb", "server/helpers.rb", "server/routes.rb", "server/server.rb", "spec/async", "spec/env.js", "spec/fixtures/test.html", "spec/fixtures/test.json", "spec/fixtures/test.xml", "spec/helpers.js", "spec/server.rb", "spec/spec.dom.html", "spec/spec.fixtures.js", "spec/spec.grammar-less.js", "spec/spec.grammar.js", "spec/spec.jquery.js", "spec/spec.jquery.xhr.js", "spec/spec.js", "spec/spec.matchers.js", "spec/spec.modules.js", "spec/spec.node.js", "spec/spec.rhino.js", "spec/spec.server.html", "spec/spec.shared-behaviors.js", "spec/spec.utils.js", "spec/spec.xhr.js", "templates/default/History.rdoc", "templates/default/README.rdoc", "templates/default/lib/yourlib.core.js", "templates/default/spec/server.rb", "templates/default/spec/spec.core.js", "templates/default/spec/spec.dom.html", "templates/default/spec/spec.rhino.js", "templates/default/spec/spec.server.html", "templates/rails/server.rb", "templates/rails/spec.application.js", "templates/rails/spec.dom.html", "templates/rails/spec.rhino.js", "templates/rails/spec.server.html"]
+  s.homepage = %q{http://visionmedia.github.com/jspec}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Jspec", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{jspec}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{JavaScript BDD Testing Framework}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<sinatra>, [">= 0"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_runtime_dependency(%q<visionmedia-commander>, [">= 3.2.9"])
+      s.add_runtime_dependency(%q<visionmedia-bind>, [">= 0.2.6"])
+    else
+      s.add_dependency(%q<sinatra>, [">= 0"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<visionmedia-commander>, [">= 3.2.9"])
+      s.add_dependency(%q<visionmedia-bind>, [">= 0.2.6"])
+    end
+  else
+    s.add_dependency(%q<sinatra>, [">= 0"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<visionmedia-commander>, [">= 3.2.9"])
+    s.add_dependency(%q<visionmedia-bind>, [">= 0.2.6"])
+  end
+end

data/lib/jspec.css

@@ -0,0 +1,145 @@
+body.jspec {
+  margin: 45px 0;
+  font: 12px "Helvetica Neue Light", "Lucida Grande", "Calibri", "Arial", sans-serif;
+  background: #efefef url(images/bg.png) top left repeat-x;
+}
+#jspec {
+  margin: 0 auto;
+  padding-top: 25px;
+  width: 1008px;
+  background: url(images/vr.png) top left repeat-y;
+  text-align: left;
+}
+#jspec-top {
+  position: relative;
+  margin: 0 auto;
+  width: 1008px;
+  height: 40px;
+  background: url(images/sprites.bg.png) top left no-repeat;
+}
+#jspec-bottom {
+  margin: 0 auto;
+  width: 1008px;
+  height: 15px;
+  background: url(images/sprites.bg.png) bottom left no-repeat;
+}
+#jspec .loading {
+  margin-top: -45px;
+  width: 1008px;
+  height: 80px;
+  background: url(images/loading.gif) 50% 50% no-repeat;
+}
+#jspec-title {
+  position: relative;
+  top: 35px;
+  left: 20px;
+  width: 160px;
+  font-size: 22px;
+  font-weight: normal;
+  background: url(images/sprites.png) 0 -126px no-repeat;
+  text-align: center;
+}
+#jspec-title em {
+  font-size: 10px;
+  font-style: normal;
+  color: #BCC8D1;
+}
+#jspec-report * {
+	margin: 0;
+	padding: 0;
+	background: none;
+	border: none;
+}
+#jspec-report {
+  padding: 15px 40px;
+	font: 11px "Helvetica Neue Light", "Lucida Grande", "Calibri", "Arial", sans-serif;
+	color: #7B8D9B;
+}
+#jspec-report.has-failures {
+  padding-bottom: 30px;
+}
+#jspec-report .hidden {
+  display: none;
+}
+#jspec-report .heading {
+  margin-bottom: 15px;
+}
+#jspec-report .heading span {
+  padding-right: 10px;
+}
+#jspec-report .heading .passes em {
+  color: #0ea0eb;
+}
+#jspec-report .heading .failures em {
+  color: #FA1616;
+}
+#jspec-report table {
+  width: 100%;
+  font-size: 11px;
+  border-collapse: collapse;
+}
+#jspec-report td {
+  padding: 8px;
+  text-indent: 30px;
+  color: #7B8D9B;
+}
+#jspec-report tr.body {
+  display: none;
+}
+#jspec-report tr.body pre {
+  margin: 0;
+  padding: 0 0 5px 25px;
+}
+#jspec-report tr:not(.body):hover + tr.body {
+  display: block;
+}
+#jspec-report tr td:first-child em {
+  font-style: normal;
+  font-weight: normal;
+  color: #7B8D9B;
+}
+#jspec-report tr:not(.description):hover {
+  text-shadow: 1px 1px 1px #fff;
+  background: #F2F5F7;
+}
+#jspec-report td + td {
+  padding-right: 0;
+  width: 15px;
+}
+#jspec-report td.pass {
+  background: url(images/sprites.png) 3px -7px no-repeat;
+}
+#jspec-report td.fail {
+  background: url(images/sprites.png) 3px -47px no-repeat;
+  font-weight: bold;
+  color: #FC0D0D;
+}
+#jspec-report td.requires-implementation {
+  background: url(images/sprites.png) 3px -87px no-repeat;
+}
+#jspec-report tr.description td {
+  margin-top: 25px;
+  padding-top: 25px;
+  font-size: 12px;
+  font-weight: bold;
+  text-indent: 0;
+  color: #1a1a1a;
+}
+#jspec-report tr.description:first-child td {
+  border-top: none;  
+}
+#jspec-report .assertion {
+  display: block;
+  float: left;
+  margin: 0 0 0 1px;
+  padding: 0;
+  width: 1px;
+  height: 5px;
+  background: #7B8D9B;
+}
+#jspec-report .assertion.failed {
+  background: red;
+}
+.jspec-sandbox {
+  display: none;
+}

data/lib/jspec.jquery.js

@@ -0,0 +1,71 @@
+
+// JSpec - jQuery - Copyright TJ Holowaychuk <tj@vision-media.ca> (MIT Licensed)
+
+JSpec
+.requires('jQuery', 'when using jspec.jquery.js')
+.include({
+  name: 'jQuery',
+  
+  // --- Initialize
+  
+  init : function() {
+    jQuery.ajaxSetup({ async: false })
+  },
+  
+  // --- Utilities
+  
+  utilities : {
+    element:  jQuery,
+    elements: jQuery,
+    sandbox : function() {
+      return jQuery('<div class="sandbox"></div>')
+    }
+  },
+  
+  // --- Matchers
+  
+  matchers : {
+    have_tag      : "jQuery(expected, actual).length == 1",
+    have_one      : "alias have_tag",
+    have_tags     : "jQuery(expected, actual).length > 1",
+    have_many     : "alias have_tags",
+    have_child    : "jQuery(actual).children(expected).length == 1",
+    have_children : "jQuery(actual).children(expected).length > 1",
+    have_text     : "jQuery(actual).text() == expected",
+    have_value    : "jQuery(actual).val() == expected",
+    be_enabled    : "!jQuery(actual).attr('disabled')",
+    have_class    : "jQuery(actual).hasClass(expected)",
+    
+    be_visible : function(actual) {
+      return jQuery(actual).css('display') != 'none' &&
+             jQuery(actual).css('visibility') != 'hidden' &&
+             jQuery(actual).attr('type') != 'hidden'
+    },
+    
+    be_hidden : function(actual) {
+      return !JSpec.does(actual, 'be_visible')
+    },
+
+    have_classes : function(actual) {
+      return !JSpec.any(JSpec.argumentsToArray(arguments, 1), function(arg){
+        return !JSpec.does(actual, 'have_class', arg)
+      })
+    },
+
+    have_attr : function(actual, attr, value) {
+      return value ? jQuery(actual).attr(attr) == value:
+                     jQuery(actual).attr(attr)
+    },
+    
+    'be disabled selected checked' : function(attr) {
+      return 'jQuery(actual).attr("' + attr + '")'
+    },
+    
+    'have type id title alt href src sel rev name target' : function(attr) {
+      return function(actual, value) {
+        return JSpec.does(actual, 'have_attr', attr, value)
+      }
+    }
+  }
+})
+