rally-jasmine 1.2.0

data/.gitignore

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,58 @@
+before_script:
+  - "sh -e /etc/init.d/xvfb start"
+script: "DISPLAY=:99.0 bundle exec rake"
+
+rvm:
+  - "1.8.7"
+  - "1.9.2"
+  - "1.9.3"
+  - "ree"
+  - "jruby"
+  - "rbx"
+
+env:
+ - "RAILS_VERSION=rails2"
+ - "RAILS_VERSION=rails2_3_5"
+ - "RAILS_VERSION=rails3"
+ - "RAILS_VERSION=pojs-rspec1"
+ - "RAILS_VERSION=pojs-rspec2"
+
+matrix:
+  exclude:
+    - rvm: rbx
+      env: RAILS_VERSION=rails2
+    - rvm: rbx
+      env: RAILS_VERSION=rails2_3_5
+    - rvm: rbx
+      env: RAILS_VERSION=pojs-rspec1
+    - rvm: rbx
+      env: RAILS_VERSION=pojs-rspec2
+    - rvm: jruby
+      env: RAILS_VERSION=rails2
+    - rvm: jruby
+      env: RAILS_VERSION=rails2_3_5
+    - rvm: jruby
+      env: RAILS_VERSION=pojs-rspec1
+    - rvm: jruby
+      env: RAILS_VERSION=pojs-rspec2
+    - rvm: 1.9.2
+      env: RAILS_VERSION=rails2
+    - rvm: 1.9.2
+      env: RAILS_VERSION=rails2_3_5
+    - rvm: 1.9.2
+      env: RAILS_VERSION=pojs-rspec1
+    - rvm: 1.9.2
+      env: RAILS_VERSION=pojs-rspec2
+    - rvm: ree
+      env: RAILS_VERSION=pojs-rspec2
+    - rvm: 1.8.7
+      env: RAILS_VERSION=rails2
+    - rvm: 1.8.7
+      env: RAILS_VERSION=rails2_3_5
+    - rvm: 1.8.7
+      env: RAILS_VERSION=pojs-rspec1
+    - rvm: 1.8.7
+      env: RAILS_VERSION=pojs-rspec2
+  allow_failures:
+    - rvm: rbx
+    - rvm: jruby

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+gemspec
+
+unless ENV["TRAVIS"]
+  group :debug do
+    gem 'debugger'
+  end
+end

data/HOW_TO_TEST.markdown

@@ -0,0 +1,9 @@
+To test changes to the jasmine-gem:
+
+* Export RAILS_VERSION as either "pojs-rspec1",  "pojs-rspec2", or "rails2" to test environments other than Rails 3.
+* Delete `Gemfile.lock`
+* Clear out your current gemset
+* exec a `bundle install`
+* `rake` until specs are green
+* Repeat
+* Check in

data/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/README.markdown

@@ -0,0 +1,77 @@
+# The Jasmine Gem <a title="Build at Travis CI" href="http://travis-ci.org/#!/pivotal/jasmine-gem"><img src="https://secure.travis-ci.org/pivotal/jasmine-gem.png" /></a>
+
+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.
+
+## Contents
+This gem contains:
+
+* 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)
+
+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
+
+`script/generate jasmine`
+
+For Rails3 support, use
+
+`rails g jasmine:install`
+`rails g jasmine:examples`
+
+For any other project (Sinatra, Merb, or something we don't yet know about) use
+
+`jasmine init`
+
+## Usage
+
+Start the Jasmine server:
+
+`rake jasmine`
+
+Point your browser to `localhost:8888`. The suite will run every time this page is re-loaded.  
+
+Start Jasmine on a different port:
+
+`rake jasmine JASMINE_PORT=1337`
+
+Point your browser to `localhost:1337`. 
+
+For Continuous Integration environments, add this task to the project build steps:
+
+`rake jasmine:ci`
+
+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. The browser used by selenium can be changed by setting the JASMINE_BROWSER environment variable (this might require additional webdriver dependencies).
+
+## 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.
+
+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/RELEASE_NOTES.markdown

@@ -0,0 +1,6 @@
+#1.2.1
+
+* asset manifests following the Rails defaults are included as individual src files
+* Fix regression that required Jasmine restart to find new src/spec files
+* Fixes compatibility with rspec > 2.1.0
+* Internal refactorings/cleanup

data/Rakefile

@@ -0,0 +1,53 @@
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift File.expand_path("#{File.dirname(__FILE__)}/lib")
+require "bundler"
+Bundler::GemHelper.install_tasks
+
+require "jasmine"
+if Jasmine::Dependencies.rspec2?
+  require 'rspec'
+  require 'rspec/core/rake_task'
+else
+  require 'spec'
+  require 'spec/rake/spectask'
+end
+
+desc "Run all examples"
+if Jasmine::Dependencies.rspec2?
+  RSpec::Core::RakeTask.new(:spec) do |t|
+    t.pattern = 'spec/**/*_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']
+
+task :default => :spec
+
+namespace :jasmine do
+  require "jasmine-core"
+  require './spec/jasmine_self_test_config'
+  task :server do
+    port = ENV['JASMINE_PORT'] || 8888
+    JasmineSelfTestConfig.new.start_server(port)
+
+    puts "your tests are here:"
+    puts "  http://localhost:#{port}/"
+  end
+
+  desc "Copy examples from Jasmine JS to the gem"
+  task :copy_examples_to_gem do
+    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(File.join(Jasmine::Core.path, 'example'), 'generators/jasmine/templates/jasmine-example', :preserve => true)
+  end
+end
+
+desc "Run specs via server"
+task :jasmine => ['jasmine:server']
+

data/bin/jasmine

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'jasmine'
+
+Jasmine::CommandLineTool.new.process ARGV

data/generators/jasmine/jasmine_generator.rb

@@ -0,0 +1,24 @@
+class JasmineGenerator < Rails::Generator::Base
+  def manifest
+    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 "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/support"
+    m.file "spec/javascripts/support/jasmine-rails.yml", "spec/javascripts/support/jasmine.yml"
+    m.readme "INSTALL"
+
+    m.directory "lib/tasks"
+    m.file "lib/tasks/jasmine.rake", "lib/tasks/jasmine.rake"
+    m
+  end
+
+end

data/generators/jasmine/templates/INSTALL

@@ -0,0 +1,9 @@
+Jasmine has been installed with example specs.
+
+To run the server:
+
+rake jasmine
+
+To run the automated CI task with Selenium:
+
+rake jasmine:ci

data/generators/jasmine/templates/jasmine-example/SpecRunner.html

@@ -0,0 +1,54 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+  "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+  <title>Jasmine Spec Runner</title>
+
+  <link rel="shortcut icon" type="image/png" href="lib/jasmine-1.1.0.rc1/jasmine_favicon.png">
+
+  <link rel="stylesheet" type="text/css" href="lib/jasmine-1.1.0.rc1/jasmine.css">
+  <script type="text/javascript" src="lib/jasmine-1.1.0.rc1/jasmine.js"></script>
+  <script type="text/javascript" src="lib/jasmine-1.1.0.rc1/jasmine-html.js"></script>
+
+  <!-- include spec files here... -->
+  <script type="text/javascript" src="spec/SpecHelper.js"></script>
+  <script type="text/javascript" src="spec/PlayerSpec.js"></script>
+
+  <!-- include source files here... -->
+  <script type="text/javascript" src="src/Player.js"></script>
+  <script type="text/javascript" src="src/Song.js"></script>
+
+  <script type="text/javascript">
+    (function() {
+      var jasmineEnv = jasmine.getEnv();
+      jasmineEnv.updateInterval = 1000;
+
+      var trivialReporter = new jasmine.TrivialReporter();
+
+      jasmineEnv.addReporter(trivialReporter);
+
+      jasmineEnv.specFilter = function(spec) {
+        return trivialReporter.specFilter(spec);
+      };
+
+      var currentWindowOnload = window.onload;
+
+      window.onload = function() {
+        if (currentWindowOnload) {
+          currentWindowOnload();
+        }
+        execJasmine();
+      };
+
+      function execJasmine() {
+        jasmineEnv.execute();
+      }
+
+    })();
+  </script>
+
+</head>
+
+<body>
+</body>
+</html>

data/generators/jasmine/templates/jasmine-example/spec/PlayerSpec.js

@@ -0,0 +1,58 @@
+describe("Player", function() {
+  var player;
+  var song;
+
+  beforeEach(function() {
+    player = new Player();
+    song = new Song();
+  });
+
+  it("should be able to play a Song", function() {
+    player.play(song);
+    expect(player.currentlyPlayingSong).toEqual(song);
+
+    //demonstrates use of custom matcher
+    expect(player).toBePlaying(song);
+  });
+
+  describe("when song has been paused", function() {
+    beforeEach(function() {
+      player.play(song);
+      player.pause();
+    });
+
+    it("should indicate that the song is currently paused", function() {
+      expect(player.isPlaying).toBeFalsy();
+
+      // demonstrates use of 'not' with a custom matcher
+      expect(player).not.toBePlaying(song);
+    });
+
+    it("should be possible to resume", function() {
+      player.resume();
+      expect(player.isPlaying).toBeTruthy();
+      expect(player.currentlyPlayingSong).toEqual(song);
+    });
+  });
+
+  // demonstrates use of spies to intercept and test method calls
+  it("tells the current song if the user has made it a favorite", function() {
+    spyOn(song, 'persistFavoriteStatus');
+
+    player.play(song);
+    player.makeFavorite();
+
+    expect(song.persistFavoriteStatus).toHaveBeenCalledWith(true);
+  });
+
+  //demonstrates use of expected exceptions
+  describe("#resume", function() {
+    it("should throw an exception if song is already playing", function() {
+      player.play(song);
+
+      expect(function() {
+        player.resume();
+      }).toThrow("song is already playing");
+    });
+  });
+});

data/generators/jasmine/templates/jasmine-example/spec/SpecHelper.js

@@ -0,0 +1,9 @@
+beforeEach(function() {
+  this.addMatchers({
+    toBePlaying: function(expectedSong) {
+      var player = this.actual;
+      return player.currentlyPlayingSong === expectedSong && 
+             player.isPlaying;
+    }
+  });
+});

data/generators/jasmine/templates/jasmine-example/src/Player.js

@@ -0,0 +1,22 @@
+function Player() {
+}
+Player.prototype.play = function(song) {
+  this.currentlyPlayingSong = song;
+  this.isPlaying = true;
+};
+
+Player.prototype.pause = function() {
+  this.isPlaying = false;
+};
+
+Player.prototype.resume = function() {
+  if (this.isPlaying) {
+    throw new Error("song is already playing");
+  }
+
+  this.isPlaying = true;
+};
+
+Player.prototype.makeFavorite = function() {
+  this.currentlyPlayingSong.persistFavoriteStatus(true);
+};

data/generators/jasmine/templates/jasmine-example/src/Song.js

@@ -0,0 +1,7 @@
+function Song() {
+}
+
+Song.prototype.persistFavoriteStatus = function(value) {
+  // something complicated
+  throw new Error("not yet implemented");
+};

data/generators/jasmine/templates/lib/tasks/jasmine.rake

@@ -0,0 +1,8 @@
+begin
+  require 'jasmine'
+  load 'jasmine/tasks/jasmine.rake'
+rescue LoadError
+  task :jasmine do
+    abort "Jasmine is not available. In order to run jasmine, you must: (sudo) gem install jasmine"
+  end
+end

data/generators/jasmine/templates/spec/javascripts/support/jasmine-rails.yml

@@ -0,0 +1,81 @@
+# src_files
+#
+# Return an array of filepaths relative to src_dir to include before jasmine specs.
+# Default: []
+#
+# EXAMPLE:
+#
+# src_files:
+#   - lib/source1.js
+#   - lib/source2.js
+#   - dist/**/*.js
+#
+src_files:
+  - public/javascripts/prototype.js
+  - public/javascripts/effects.js
+  - public/javascripts/controls.js
+  - public/javascripts/dragdrop.js
+  - public/javascripts/application.js
+  - public/javascripts/**/*.js
+
+# stylesheets
+#
+# Return an array of stylesheet filepaths relative to src_dir to include before jasmine specs.
+# Default: []
+#
+# EXAMPLE:
+#
+# stylesheets:
+#   - css/style.css
+#   - stylesheets/*.css
+#
+stylesheets:
+  - stylesheets/**/*.css
+
+# helpers
+#
+# Return an array of filepaths relative to spec_dir to include before jasmine specs.
+# Default: ["helpers/**/*.js"]
+#
+# EXAMPLE:
+#
+# helpers:
+#   - helpers/**/*.js
+#
+helpers:
+  - helpers/**/*.js
+
+# spec_files
+#
+# Return an array of filepaths relative to spec_dir to include.
+# Default: ["**/*[sS]pec.js"]
+#
+# EXAMPLE:
+#
+# spec_files:
+#   - **/*[sS]pec.js
+#
+spec_files:
+  - '**/*[sS]pec.js'
+
+# src_dir
+#
+# Source directory path. Your src_files must be returned relative to this path. Will use root if left blank.
+# Default: project root
+#
+# EXAMPLE:
+#
+# src_dir: public
+#
+src_dir:
+
+# spec_dir
+#
+# Spec directory path. Your spec_files must be returned relative to this path.
+# Default: spec/javascripts
+#
+# EXAMPLE:
+#
+# spec_dir: spec/javascripts
+#
+spec_dir: spec/javascripts

data/generators/jasmine/templates/spec/javascripts/support/jasmine.yml

@@ -0,0 +1,73 @@
+# src_files
+#
+# Return an array of filepaths relative to src_dir to include before jasmine specs.
+# Default: []
+#
+# EXAMPLE:
+#
+# src_files:
+#   - lib/source1.js
+#   - lib/source2.js
+#   - dist/**/*.js
+#
+src_files:
+    - public/javascripts/**/*.js
+
+# stylesheets
+#
+# Return an array of stylesheet filepaths relative to src_dir to include before jasmine specs.
+# Default: []
+#
+# EXAMPLE:
+#
+# stylesheets:
+#   - css/style.css
+#   - stylesheets/*.css
+#
+stylesheets:
+
+# helpers
+#
+# Return an array of filepaths relative to spec_dir to include before jasmine specs.
+# Default: ["helpers/**/*.js"]
+#
+# EXAMPLE:
+#
+# helpers:
+#   - helpers/**/*.js
+#
+helpers:
+
+# spec_files
+#
+#  Return an array of filepaths relative to spec_dir to include.
+# Default: ["**/*[sS]pec.js"]
+#
+# EXAMPLE:
+#
+# spec_files:
+#   - **/*[sS]pec.js
+#
+spec_files:
+
+# src_dir
+#
+# Source directory path. Your src_files must be returned relative to this path. Will use root if left blank.
+# Default: project root
+#
+# EXAMPLE:
+#
+# src_dir: public
+#
+src_dir:
+
+# spec_dir
+#
+# Spec directory path. Your spec_files must be returned relative to this path.
+# Default: spec/javascripts
+#
+# EXAMPLE:
+#
+# spec_dir: spec/javascripts
+#
+spec_dir:

data/lib/generators/jasmine/examples/USAGE

@@ -0,0 +1,11 @@
+Description:
+    Install jasmine examples
+
+Example:
+    rails generate jasmine:examples
+
+    This will create:
+        public/javascripts/jasmine_examples/PlayerSpec.js
+        public/javascripts/jasmine_examples/SpecHelper.js
+        spec/javascripts/jasmine_examples/PlayerSpec.js
+        spec/javascripts/jasmine_examples/SpecHelper.js

data/lib/generators/jasmine/examples/examples_generator.rb

@@ -0,0 +1,19 @@
+module Jasmine
+  module Generators
+    class ExamplesGenerator < Rails::Generators::Base
+
+      def self.source_root
+        @source_root ||= File.expand_path(File.join(File.dirname(__FILE__), 'templates'))
+      end
+
+      def copy_example_files
+        directory 'app'
+        directory 'spec'
+      end
+
+      def app_name
+        Rails.application.class.name
+      end
+    end
+  end
+end