jasmine 1.0.1.1 → 1.0.2.0

data/.gitignore

@@ -0,0 +1,11 @@
+.idea
+pkg
+bin
+!bin/jasmine
+.bundle
+.DS_Store
+.rvmrc
+.pairs
+*.swp
+Gemfile.lock
+spec/reports

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "jasmine"]
+	path = jasmine
+	url = git://github.com/pivotal/jasmine.git

data/Gemfile

@@ -0,0 +1,5 @@
+source "http://rubygems.org"
+
+# dependencies are specified in jasmine.gemspec
+
+gemspec

data/HOW_TO_TEST.markdown

@@ -0,0 +1,11 @@
+At the moment we don't have an automated way to test the Jasmine Gem in both configurations: Rails 2 / RSpec 1.x & Rails 3 / RSpec 2.  CI will handle a broad matrix, but you need to ensure that your changes work across Rails 2&3.
+
+So here are the manual steps:
+
+* Edit jasmine.gemspec and uncomment the lines for Rails 2, comment out the lines for Rails 3
+* Delete `Gemfile.lock`
+* exec a `bundle install`
+* `rake` until specs are green
+* Repeat with the Rails 3 development gems
+* Repeat again with the Rails 2 development gems
+* Check in

data/README.markdown

@@ -1,13 +1,19 @@
-jasmine-gem
-============
+# The Jasmine Gem
 
-Jasmine Gem dynamically serves and runs suites for [Jasmine](http://github.com/pivotal/jasmine).
+The [Jasmine](http://github.com/pivotal/jasmine) Ruby Gem is a package of helper code for developing Jasmine projects for Ruby-based web projects (Rails, Sinatra, etc.) or for JavaScript projects where Ruby is a welcome partner. It serves up a project's Jasmine suite in a browser so you can focus on your code instead of manually editing script tags in the Jasmine runner HTML file.
 
-To use:
+## Contents
+This gem contains:
 
-`gem install jasmine`
+* A small server that builds and executes a Jasmine suite for a project
+* A script that sets up a project to use the Jasmine gem's server
+* Generators for Ruby on Rails projects (Rails 2 and Rails 3)
 
-Post-installation:
+You can get all of this by: `gem install jasmine` or by adding Jasmine to your `Gemfile`.
+
+## Init A Project
+
+To initialize a project for Jasmine, it depends on your web framework
 
 For Rails2 support, use
 
@@ -15,29 +21,51 @@ For Rails2 support, use
 
 For Rails3 support, use
 
-`bundle exec jasmine init`
+`rails g jasmine:install`
+`rails g jasmine:examples`
 
-For other Ruby projects (including Merb), use
+For any other project (Sinatra, Merb, or something we don't yet know about) use
 
 `jasmine init`
 
-After initializing a project, you may
+## Usage
+
+Start the Jasmine server:
 
 `rake jasmine`
 
-to set up a server. Opening localhost:8888 in a web browser will now run your jasmine specs.
+Point your browser to `localhost:8888`. The suite will run every time this page is re-loaded.
 
-You may also
+For Continuous Integration environments, add this task to the project build steps:
 
 `rake jasmine:ci`
 
-which will run your Jasmine suites using selenium and rspec. This task is suitable for running in continuous integration environments.  There is currently a known issue using this rake task with RSpec2 beta.
+This uses Selenium to launch a browser and run the Jasmine suite. Then it uses RSpec to extract the results from the Jasmine reporter and write them to your build log.
 
-Simple Configuration:
+## Configuration
 
 Customize `spec/javascripts/support/jasmine.yml` to enumerate the source files, stylesheets, and spec files you would like the Jasmine runner to include.
 You may use dir glob strings.
 
-It is also possible to add overrides into the `spec/javascripts/support/jasmine_config.rb` file directly if you require further customization.
+For more complex configuration (e.g., port number), edit `spec/javascripts/support/jasmine_config.rb` file directly.
+
+## Note about the CI task and RSpec
+
+This gem requires RSpec for the `jasmine:ci` rake task to work. But this gem does not explicitly *depend* on any version of the RSpec gem.
+
+If you're writing a Rails application then as long as you've installed RSpec before you install Jasmine and attempt a `rake jasmine:ci`, then you will be fine.
+
+If you're using another Ruby framework, or don't care about Ruby, then run
+
+`gem install rspec`
+
+before you attempt the CI task.
+
+## Support
+
+Jasmine Mailing list: [jasmine-js@googlegroups.com](mailto:jasmine-js@googlegroups.com)
+Twitter: [@jasminebdd](http://twitter.com/jasminebdd)
+
+Please file issues here at Github
 
 Copyright (c) 2008-2010 Pivotal Labs. This software is licensed under the MIT License.

data/RELEASE.markdown

@@ -0,0 +1,22 @@
+# Releasing Jasmine
+
+Add release notes to gh-pages branch /release-notes.html.markdown
+
+## Jasmine core
+
+* update version.json with new version
+* rake jasmine:dist
+* add pages/downloads/*.zip
+* commit, tag, and push both jasmine/pages and jasmine
+* * git push
+* * git tag -a x.x.x-release
+* * git push --tags
+
+## Jasmine Gem
+
+* update version in version.rb
+  * for release candidates, add "rc" + number to the end of the appropriate version part,
+  e.g. we should have tagged the 1.0 RC's as 1.0.0rc1, not 1.0.0.rc1. Likewise 1.0.0.1rc1.
+* rake jeweler:install and try stuff out
+* * (jasmine init and script/generate jasmine)
+* rake site

data/Rakefile

@@ -0,0 +1,76 @@
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift File.expand_path("#{File.dirname(__FILE__)}/lib")
+require "bundler"
+Bundler.setup
+
+def rspec2?
+  Gem.available? "rspec", ">= 2.0"
+end
+
+def rails3?
+  Gem.available? "rails", ">= 3.0"
+end
+
+if rspec2?
+  require 'rspec'
+  require 'rspec/core/rake_task'
+else
+  require 'spec'
+  require 'spec/rake/spectask'
+end
+require 'ci/reporter/rake/rspec'
+
+desc "Run all examples"
+if rspec2?
+  RSpec::Core::RakeTask.new(:spec) do |t|
+    t.pattern = 'spec/**/*.rb'
+  end
+else
+  Spec::Rake::SpecTask.new('spec') do |t|
+    t.spec_files = FileList['spec/**/*.rb']
+  end
+end
+
+task :spec => ['jasmine:copy_examples_to_gem', 'bundle_install', 'ci:setup:rspec']
+
+task :spex do
+  `bundle install`
+  Rake::Task["spec"].invoke
+end
+
+task :default => :spec
+
+namespace :jasmine do
+  require './spec/jasmine_self_test_config'
+  task :server do
+    puts "your tests are here:"
+    puts "  http://localhost:8888/"
+
+    JasmineSelfTestConfig.new.start_server
+  end
+
+  desc "Copy examples from Jasmine JS to the gem"
+  task :copy_examples_to_gem do
+    unless File.exist?('jasmine/lib')
+      raise "Jasmine submodule isn't present.  Run git submodule update --init"
+    end
+
+    require "fileutils"
+
+    # copy jasmine's example tree into our generator templates dir
+    FileUtils.rm_r('generators/jasmine/templates/jasmine-example', :force => true)
+    FileUtils.cp_r('jasmine/example', 'generators/jasmine/templates/jasmine-example', :preserve => true)
+  end
+end
+
+desc "Run specs via server"
+task :jasmine => ['jasmine:server']
+
+desc "Install Bundle"
+task "bundle_install" do
+  `bundle install`
+end
+
+
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/generators/jasmine/jasmine_generator.rb

@@ -1,26 +1,28 @@
 class JasmineGenerator < Rails::Generator::Base
   def manifest
-    record do |m|
+    m = ::Rails::Generator::Manifest.new
 
-      m.directory "public/javascripts"
-      m.file "jasmine-example/src/Player.js", "public/javascripts/Player.js"
-      m.file "jasmine-example/src/Song.js", "public/javascripts/Song.js"
+    m.directory "public/javascripts"
+    m.file "jasmine-example/src/Player.js", "public/javascripts/Player.js"
+    m.file "jasmine-example/src/Song.js", "public/javascripts/Song.js"
 
-      m.directory "spec/javascripts"
-      m.file "jasmine-example/spec/PlayerSpec.js", "spec/javascripts/PlayerSpec.js"
+    m.directory "spec/javascripts"
+    m.file "jasmine-example/spec/PlayerSpec.js", "spec/javascripts/PlayerSpec.js"
 
-      m.directory "spec/javascripts/helpers"
-      m.file "jasmine-example/spec/SpecHelper.js", "spec/javascripts/helpers/SpecHelper.js"
+    m.directory "spec/javascripts/helpers"
+    m.file "jasmine-example/spec/SpecHelper.js", "spec/javascripts/helpers/SpecHelper.js"
 
-      m.directory "spec/javascripts/support"
-      m.file "spec/javascripts/support/jasmine_runner.rb", "spec/javascripts/support/jasmine_runner.rb"
-      m.file "spec/javascripts/support/jasmine-rails.yml", "spec/javascripts/support/jasmine.yml"
+    m.directory "spec/javascripts/support"
+    m.file "spec/javascripts/support/jasmine_runner.rb", "spec/javascripts/support/jasmine_runner.rb"
+    m.file "spec/javascripts/support/jasmine_config.rb", "spec/javascripts/support/jasmine_config.rb"
+    m.file "spec/javascripts/support/jasmine-rails.yml", "spec/javascripts/support/jasmine.yml"
+    m.readme "INSTALL"
 
+    unless ::Rails::VERSION::STRING[0,1] == "3"
       m.directory "lib/tasks"
       m.file "lib/tasks/jasmine.rake", "lib/tasks/jasmine.rake"
-
-      m.readme "INSTALL"
     end
+    m
   end
 
   def file_name

data/generators/jasmine/templates/spec/javascripts/support/jasmine_config.rb

@@ -0,0 +1,23 @@
+module Jasmine
+  class Config
+
+    # Add your overrides or custom config code here
+
+  end
+end
+
+
+# Note - this is necessary for rspec2, which has removed the backtrace
+module Jasmine
+  class SpecBuilder
+    def declare_spec(parent, spec)
+      me = self
+      example_name = spec["name"]
+      @spec_ids << spec["id"]
+      backtrace = @example_locations[parent.description + " " + example_name]
+      parent.it example_name, {} do
+        me.report_spec(spec["id"])
+      end
+    end
+  end
+end

data/install.rb

@@ -0,0 +1,2 @@
+xjasmine_bin = File.expand_path(File.join(File.dirname(__FILE__), 'bin', 'jasmine'))
+`#{jasmine_bin} init`

data/jasmine.gemspec

@@ -0,0 +1,52 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "jasmine/version"
+
+Gem::Specification.new do |s|
+  s.name               = %q{jasmine}
+  s.version            = Jasmine::VERSION
+  s.platform           = Gem::Platform::RUBY
+
+  s.authors            = ["Rajan Agaskar", "Christian Williams", "Davis Frank"]
+  s.summary            = %q{JavaScript BDD framework}
+  s.description        = %q{Test your JavaScript without any framework dependencies, in any environment, and with a nice descriptive syntax.}
+  s.email              = %q{jasmine-js@googlegroups.com}
+  s.homepage           = "http://pivotal.github.com/jasmine"
+
+  s.files              = `git ls-files`.split("\n") | Dir.glob('jasmine/**/*')
+  s.test_files         = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables        = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.default_executable = %q{jasmine}
+  s.require_paths      = ["lib"]
+  s.rdoc_options       = ["--charset=UTF-8"]
+
+  if ENV['RAILS_VERSION'] == 'pojs-rspec1'
+    s.add_development_dependency 'rspec', '~> 1.3.1'
+    s.add_development_dependency 'rake-tasks'
+    s.add_development_dependency 'rack', "1.1" if ENV["RUBY_VERSION"] =~ /1\.8\.6/
+  elsif ENV['RAILS_VERSION'] == 'pojs-rspec2'
+    s.add_development_dependency 'rspec', '~> 2.5.0'
+    s.add_development_dependency 'rake-tasks'
+    s.add_development_dependency 'rack', "1.1" if ENV["RUBY_VERSION"] =~ /1\.8\.6/
+  elsif ENV['RAILS_VERSION'] == 'rails2'
+    # for development & test of Rails 2 Generators
+    s.add_development_dependency 'rspec', '~> 1.3.1'
+    s.add_development_dependency 'rails', '~> 2.3.10'
+    s.add_development_dependency 'rack', '1.1'
+  else
+    # for development & test of Rails 3 Generators
+    s.add_development_dependency 'rspec', '>= 2.5.0'
+    s.add_development_dependency 'rails', '>= 3.0.3 '
+    s.add_development_dependency 'rack', '>= 1.2.1'
+  end
+
+  s.add_development_dependency 'rack-test'
+  s.add_development_dependency 'gem-release', ">= 0.0.16"
+  s.add_development_dependency 'ci_reporter'
+
+  s.add_dependency 'rack', '>= 1.1'
+  s.add_dependency 'rspec', '>= 1.3.1'
+  s.add_dependency 'json_pure', '>= 1.4.3'
+  s.add_dependency 'selenium-webdriver', '>= 0.1.3'
+
+end

data/jasmine/Gemfile

@@ -0,0 +1,6 @@
+source :gemcutter
+
+gem "jekyll", "0.6.2"
+gem "json_pure", "~>1.4.3"
+gem "ragaskar-jsdoc_helper"
+gem "rake", "0.8.7"

data/jasmine/MIT.LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2010 Pivotal Labs
+
+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/jasmine/README.markdown

@@ -0,0 +1,28 @@
+<a name="README">[Jasmine](http://pivotal.github.com/jasmine/)</a>
+=======
+**A JavaScript Testing Framework**
+
+Want to use Jasmine in a project? Go HERE: [http://pivotal.github.com/jasmine/](http://pivotal.github.com/jasmine/)
+
+Want to contribute to Jasmine? Read on...
+
+<i>(More developer docs to come...)</i>
+
+## Support
+We now have a Google Group for support & discussion.
+
+* Discussion: [http://groups.google.com/group/jasmine-js](http://groups.google.com/group/jasmine-js)
+* Group email: [jasmine-js@googlegroups.com](jasmine-js@googlegroups.com)
+* Current build status of Jasmine is visible at [ci.pivotallabs.com](http://ci.pivotallabs.com)
+* Pivotal Tracker project: [http://www.pivotaltracker.com/projects/10606](http://www.pivotaltracker.com/projects/10606)
+* Twitter: [@JasmineBDD](http://twitter.com/JasmineBDD)
+
+## Maintainers
+* [Davis W. Frank](mailto:dwfrank@pivotallabs.com), Pivotal Labs
+* [Rajan Agaskar](mailto:rajan@pivotallabs.com), Pivotal Labs
+* [Christian Williams](mailto:xian@pivotallabs.com), Pivotal Labs
+
+## Developers
+We welcome your contributions! Jasmine is currently maintained by Davis Frank ([infews](http://github.com/infews)), Rajan Agaskar ([ragaskar](http://github.com/ragaskar)), and Christian Williams ([Xian](http://github.com/Xian)). You can help us by removing all other recipients from your pull request.
+
+Copyright (c) 2008-2010 Pivotal Labs. This software is licensed under the MIT License.

data/jasmine/Rakefile

@@ -0,0 +1,182 @@
+def jasmine_sources
+  sources  = ["src/base.js", "src/util.js", "src/Env.js", "src/Reporter.js", "src/Block.js"]
+  sources += Dir.glob('src/*.js').reject { |f| f == 'src/base.js' || sources.include?(f) }.sort
+  sources
+end
+
+def jasmine_html_sources
+  ["src/html/TrivialReporter.js"]
+end
+
+def jasmine_version
+  "#{version_hash['major']}.#{version_hash['minor']}.#{version_hash['build']}"
+end
+
+def version_hash
+  require 'json'
+  @version ||= JSON.parse(File.new("src/version.json").read);
+end
+
+task :default => 'jasmine:dist'
+
+def substitute_jasmine_version(filename)
+  contents = File.read(filename)
+  contents = contents.gsub(/##JASMINE_VERSION##/, (jasmine_version))
+  contents = contents.gsub(/[^\n]*REMOVE_THIS_LINE_FROM_BUILD[^\n]*/, '')
+  File.open(filename, 'w') { |f| f.write(contents) }
+end
+
+namespace :jasmine do
+
+  desc 'Prepares for distribution'
+  task :dist => ['jasmine:build', 'jasmine:doc', 'jasmine:build_example_project', 'jasmine:fill_index_downloads']
+
+  desc 'Check jasmine sources for coding problems'
+  task :lint do
+    passed = true
+    jasmine_sources.each do |src|
+      lines = File.read(src).split(/\n/)
+      lines.each_index do |i|
+        line = lines[i]
+        undefineds = line.scan(/.?undefined/)
+        if undefineds.include?(" undefined") || undefineds.include?("\tundefined")
+          puts "Dangerous undefined at #{src}:#{i}:\n > #{line}"
+          passed = false
+        end
+
+        if line.scan(/window/).length > 0
+          puts "Dangerous window at #{src}:#{i}:\n > #{line}"
+          passed = false
+        end
+      end
+    end
+
+    unless passed
+      puts "Lint failed!"
+      exit 1
+    end
+  end
+
+  desc 'Builds lib/jasmine from source'
+  task :build => :lint do
+    puts 'Building Jasmine from source'
+
+    sources = jasmine_sources
+    version = version_hash
+
+    old_jasmine_files = Dir.glob('lib/jasmine*.js')
+    old_jasmine_files.each { |file| File.delete(file) }
+
+    File.open("lib/jasmine.js", 'w') do |jasmine|
+      sources.each do |source_filename|
+        jasmine.puts(File.read(source_filename))
+      end
+
+      jasmine.puts %{
+jasmine.version_= {
+  "major": #{version['major'].to_json},
+  "minor": #{version['minor'].to_json},
+  "build": #{version['build'].to_json},
+  "revision": #{Time.now.to_i}
+};
+}
+    end
+
+    File.open("lib/jasmine-html.js", 'w') do |jasmine_html|
+      jasmine_html_sources.each do |source_filename|
+        jasmine_html.puts(File.read(source_filename))
+      end
+    end
+
+    FileUtils.cp("src/html/jasmine.css", "lib/jasmine.css")
+  end
+
+  downloads_file = 'pages/download.html.md'
+  task :need_pages_submodule do
+    unless File.exists?(downloads_file)
+      raise "Jasmine pages submodule isn't present.  Run git submodule update --init"
+    end
+  end
+
+  desc "Build jasmine documentation"
+  task :doc => :need_pages_submodule do
+    puts 'Creating Jasmine Documentation'
+    require 'rubygems'
+    require 'jsdoc_helper'
+
+    FileUtils.rm_r "pages/jsdoc", :force => true
+
+    JsdocHelper::Rake::Task.new(:lambda_jsdoc) do |t|
+      t[:files] = jasmine_sources << jasmine_html_sources
+      t[:options] = "-a"
+      t[:out] = "pages/jsdoc"
+      # JsdocHelper bug: template must be relative to the JsdocHelper gem, ick
+      t[:template] = File.join("../".*(100), Dir::getwd, "jsdoc-template")
+    end
+    Rake::Task[:lambda_jsdoc].invoke
+  end
+
+  desc "Build example project"
+  task :build_example_project => :need_pages_submodule do
+    require 'tmpdir'
+
+    temp_dir = File.join(Dir.tmpdir, 'jasmine-standalone-project')
+    puts "Building Example Project in #{temp_dir}"
+    FileUtils.rm_r temp_dir if File.exists?(temp_dir)
+    Dir.mkdir(temp_dir)
+
+    root = File.expand_path(File.dirname(__FILE__))
+    FileUtils.cp_r File.join(root, 'example/.'), File.join(temp_dir)
+    substitute_jasmine_version(File.join(temp_dir, "SpecRunner.html"))
+
+    lib_dir = File.join(temp_dir, "lib/jasmine-#{jasmine_version}")
+    FileUtils.mkdir_p(lib_dir)
+    {
+        "lib/jasmine.js" => "jasmine.js",
+        "lib/jasmine-html.js" => "jasmine-html.js",
+        "src/html/jasmine.css" => "jasmine.css",
+        "MIT.LICENSE"  => "MIT.LICENSE"
+    }.each_pair do |src, dest|
+      FileUtils.cp(File.join(root, src), File.join(lib_dir, dest))
+    end
+
+    dist_dir = File.join(root, 'pages/downloads')
+    zip_file_name = File.join(dist_dir, "jasmine-standalone-#{jasmine_version}.zip")
+    puts "Zipping Example Project and moving to #{zip_file_name}"
+    FileUtils.mkdir(dist_dir) unless File.exist?(dist_dir)
+    if File.exist?(zip_file_name)
+      puts "WARNING!!! #{zip_file_name} already exists!"
+      FileUtils.rm(zip_file_name)
+    end
+    exec "cd #{temp_dir} && zip -r #{zip_file_name} . -x .[a-zA-Z0-9]*"
+  end
+
+  task :fill_index_downloads do
+    require 'digest/sha1'
+
+    download_html = "<!-- START_DOWNLOADS -->\n"
+    Dir.glob('pages/downloads/*.zip').sort.reverse.each do |f|
+      sha1 = Digest::SHA1.hexdigest File.read(f)
+
+      fn = f.sub(/^pages\//, '')
+      version = /jasmine-standalone-(.*).zip/.match(f)[1]
+      prerelease = /\.rc/.match(f)
+      download_html += prerelease ? "<tr class=\"rc\">\n" : "<tr>\n"
+      download_html += "  <td class=\"link\"><a href=\"#{fn}\">#{fn.sub(/downloads\//, '')}</a></td>\n"
+      download_html += "  <td class=\"version\">#{version}</td>\n"
+      download_html += "  <td class=\"size\">#{File.size(f) / 1024}k</td>\n"
+      download_html += "  <td class=\"date\">#{File.mtime(f).strftime("%Y/%m/%d %H:%M:%S %Z")}</td>\n"
+      download_html += "  <td class=\"sha\">#{sha1}</td>\n"
+      download_html += "</tr>\n"
+    end
+    download_html += "<!-- END_DOWNLOADS -->"
+
+    downloads_page = File.read(downloads_file)
+    matcher = /<!-- START_DOWNLOADS -->.*<!-- END_DOWNLOADS -->/m
+    downloads_page = downloads_page.sub(matcher, download_html)
+    File.open(downloads_file, 'w') {|f| f.write(downloads_page)}
+    puts "rewrote that file"
+  end
+end
+
+task :jasmine => ['jasmine:dist']