jasmine-rails-light 0.0.2

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 Justin Searls & Mark Van Holstyn
+
+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.md

@@ -0,0 +1,134 @@
+# jasmine-rails gem
+
+This project is intended to make it a little easier to integrate [Jasmine](https://github.com/pivotal/jasmine/wiki) into your workflow, particularly if you're working in Rails 3.1 or later. (If you're on earlier versions of Rails, I'd suggest directly using the combination of Pivotal's [jasmine gem](https://github.com/pivotal/jasmine-gem) and [jasmine-headless-webkit](http://johnbintz.github.com/jasmine-headless-webkit/).)
+
+By bundling this gem and configuring your project, you can expect to:
+
+* Be able to run Jasmine specs from the command line (*and fast*) with John Bintz's excellent [jasmine-headless-webkit](http://johnbintz.github.com/jasmine-headless-webkit/)
+* Be able to run Jasmine specs in a browser (wherever you choose to mount the jasmine-rails engine)
+* Write specs or source in [CoffeeScript](http://jashkenas.github.com/coffee-script/), leveraging the [asset pipeline](http://railscasts.com/episodes/279-understanding-the-asset-pipeline) to pre-process it
+
+## Prerequisites
+
+Install qt for its headless webkit widget. The easiest way (on a Mac) that I've found is to use [homebrew](https://github.com/mxcl/homebrew):
+
+    brew install qt
+    
+For help installing the qt libs on other platforms, the I'd recommend [perusing capybara-webkit driver's documentation](https://github.com/thoughtbot/capybara-webkit), becuse it has the same dependency.
+
+## Adding the gem
+
+Add jasmine-rails to your Gemfile, like so
+
+    group :test, :development do
+      gem 'jasmine-rails'
+    end
+
+Next, run `bundle install`.
+
+Now, we'll use the jasmine gem to initialize a jasmine.yml configuration file:
+
+    bundle exec jasmine init
+
+And remove some files the jasmine gem creates that you won't need:
+
+    rm public/javascripts/Player.js public/javascripts/Song.js spec/javascripts/PlayerSpec.js spec/javascripts/helpers/SpecHelper.js lib/tasks/jasmine.rake 
+    
+Next, edit the generated `spec/javascripts/support/jasmine.yml` file to ensure that it will find all your JavaScript sources and specs. The default file is written for Rails <3.1 so it doesn't know about the asset directories. As an example, mine looks like this:
+
+    src_files:
+      - "vendor/**/*.{js,coffee}"
+      - "lib/**/*.{js,coffee}"
+      - "app/**/*.{js,coffee}"
+
+    stylesheets:
+      - "vendor/**/*.css"
+      - "lib/**/*.css"
+      - "app/**/*.css"
+
+    helpers:
+      - "helpers/**/*.{js,coffee}"
+
+    spec_files:
+      - "**/*[Ss]pec.{js,coffee}"
+
+    src_dir:
+
+    spec_dir: spec/javascripts
+
+## Running from the command line
+
+If you were to run:
+
+    bundle exec jasmine-headless-webkit --color
+    
+You'd hopefully see something like:
+
+    Running Jasmine specs...
+
+    PASS: 0 tests, 0 failures, 0.001 secs.
+
+I encourage you to explore John Bintz's excellent [jasmine-headless-webkit's documentation](http://johnbintz.github.com/jasmine-headless-webkit/) for more ideas, like creating a Rake task or running it on a display-less CI server.
+
+If you experience an error at this point, the most likely cause is JavaScript being loaded out of order, or otherwise conflicting with other existing JavaScript in your project. See "Debugging" below.
+
+## Running from your browser
+
+Just mount jasmine-rails by adding something like this to your routes.rb:
+
+``` ruby
+mount JasmineRails::Engine => "/specs" unless Rails.env.production?
+```
+
+Now when you run `bundle exec rails s`, and navigate to [http://localhost:3000/specs](http://localhost:3000/specs), you should see a Jasmine spec runner in your browser.
+
+## Debugging
+
+### In your browser
+
+In my workflow, I like to work with specs in the command line until I hit a snag and could benefit from debugging in [Web Inspector](http://www.webkit.org/blog/1091/more-web-inspector-updates/) or [Firebug](http://getfirebug.com/) to figure out what's going on.
+
+When debugging, I append the query param "**debug_assets=true**" like so: [http://localhost:3000/specs?debug_assets=true](http://localhost:3000/specs?debug_assets=true). 
+
+This is telling the asset pipeline to include each of your scripts in *individual* `<script>` tags. Seeing each script loaded separately makes debugging much easier for me.
+  
+### From the command line
+
+Even though they both read from the same config file, it's certainly possible that your specs will pass in the browser and fail from the command line. In this case, you can try to debug or analyze what's going on by using the "--keep" flag from jasmine-headless-webkit. 
+
+By running:
+
+    bundle exec jasmine-headless-webkit --keep
+
+If the tests fail, jasmine-headless-webkit will leave its generated spec runner HTML file persisted in your rails root folder. It'll be named something like "specrunner.48160.html".
+
+## Guard
+
+[Guard](https://github.com/guard/guard) is a great tool for triggering spec runs when files change. To use it, you can bundle these gems:
+
+    group :test, :development do
+      ...      
+      gem 'guard-rails-assets'
+      gem 'guard-jasmine-headless-webkit'
+      ...
+    end
+
+In my Guardfile, this configuration is working well for me:
+
+    guard 'rails-assets' do
+      watch(%r{^.*/assets/.+$})
+      watch('config/application.rb')
+    end
+
+    spec_location = "spec/javascripts/%s_spec"
+
+    guard 'jasmine-headless-webkit' do
+      watch(%r{^app/views/.*\.jst$})
+      watch(%r{^public/javascripts/(.*)\.js$}) { |m| newest_js_file(spec_location % m[1]) }
+      watch(%r{^.*/assets/javascripts/(.*)\.(js|coffee)$}) { |m| newest_js_file(spec_location % m[1]) }
+      watch(%r{^spec/javascripts/(.*)_spec\..*}) { |m| newest_js_file(spec_location % m[1]) }
+    end
+
+Finally, to run guard, just:
+
+    bundle exec guard

data/Rakefile

@@ -0,0 +1,39 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'JasmineRails'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../test/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task :default => :test

data/app/assets/javascripts/jasmine_rails/application.js

@@ -0,0 +1,7 @@
+// This is a manifest file that'll be compiled into including all the files listed below.
+// Add new JavaScript/Coffee code in separate files in this directory and they'll automatically
+// be included in the compiled file accessible from http://example.com/assets/application.js
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+//= require_jasmine js

data/app/assets/stylesheets/jasmine_rails/application.css

@@ -0,0 +1,7 @@
+/*
+ * This is a manifest file that'll automatically include all the stylesheets available in this directory
+ * and any sub-directories. You're free to add application-wide styles to this file and they'll appear at
+ * the top of the compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_jasmine css
+*/

data/app/controllers/jasmine_rails/application_controller.rb

@@ -0,0 +1,4 @@
+module JasmineRails
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/jasmine_rails/spec_runner_controller.rb

@@ -0,0 +1,4 @@
+module JasmineRails
+  class SpecRunnerController < ApplicationController
+  end
+end

data/app/views/layouts/jasmine_rails/spec_runner.html.erb

@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta content="text/html;charset=UTF-8" http-equiv="Content-Type"/>
+    <title>Jasmine suite</title>
+
+    <%= stylesheet_link_tag "jasmine_rails/application" %>
+    <%= javascript_include_tag "jasmine_rails/application" %>
+
+    <!-- executing jasmine's runner -->
+    <script type="text/javascript">
+      var jsApiReporter;
+      (function() {
+        var jasmineEnv = jasmine.getEnv();
+
+        jsApiReporter = new jasmine.JsApiReporter();
+        var trivialReporter = new jasmine.TrivialReporter();
+
+        jasmineEnv.addReporter(jsApiReporter);
+        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>
+    <div id="jasmine_content"></div>
+    <%= yield %>
+  <body>
+</html>

data/config/initializers/sprockets.rb

@@ -0,0 +1,11 @@
+require 'processes_jasmine_directives'
+require 'jasmine'
+require 'jasmine-core'
+
+assets = Rails.application.assets
+
+assets.register_preprocessor 'application/javascript', ProcessesJasmineDirectives
+assets.register_preprocessor 'text/css', ProcessesJasmineDirectives
+
+assets.append_path Jasmine::Config.new.spec_dir
+assets.append_path Jasmine::Core.path

data/config/routes.rb

@@ -0,0 +1,6 @@
+require 'jasmine-core'
+require 'jasmine'
+
+JasmineRails::Engine.routes.draw do
+  root :to => "spec_runner#index"
+end

data/lib/jasmine-rails.rb

@@ -0,0 +1,4 @@
+require "jasmine_rails/engine"
+
+module JasmineRails
+end

data/lib/jasmine_rails/engine.rb

@@ -0,0 +1,5 @@
+module JasmineRails
+  class Engine < Rails::Engine
+    isolate_namespace JasmineRails
+  end
+end

data/lib/jasmine_rails/version.rb

@@ -0,0 +1,3 @@
+module JasmineRails
+  VERSION = "0.0.2"
+end

data/lib/processes_jasmine_directives.rb

@@ -0,0 +1,38 @@
+require 'jasmine-core'
+require 'sprockets/directive_processor'
+
+class ProcessesJasmineDirectives < Sprockets::DirectiveProcessor
+  ASSET_TYPES = ["css","js"]
+  
+  def process_require_jasmine_directive(asset_type)
+    return unless ASSET_TYPES.include?(asset_type)
+     
+    send("require_jasmine_#{asset_type}")
+    send("require_user_#{asset_type}")
+  end
+  
+  ASSET_TYPES.each do |asset_type|
+    define_method "require_jasmine_#{asset_type}" do
+      Jasmine::Core.send("#{asset_type}_files").each do |f|
+        context.require_asset "/#{Jasmine::Core.path}/#{f}"
+      end
+    end
+    
+    define_method "require_user_#{asset_type}" do
+      config = Jasmine::Config.new
+      config.send("#{asset_type}_files").each do |f|
+        context.require_asset full_path_for(f,config)
+      end
+    end
+  end
+  
+  private 
+  
+  def full_path_for(partial_path,config)
+    if partial_path.include?(config.spec_path)
+      partial_path.gsub(/#{config.spec_path}/,config.spec_dir)
+    else
+      "#{Rails.root}#{partial_path}"
+    end
+  end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification 
+name: jasmine-rails-light
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Justin Searls
+- Mark Van Holstyn
+- Cory Flanigan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-12-01 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 3
+        - 1
+        - 0
+        version: 3.1.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: jasmine
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: gimme
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: Provides a Jasmine Spec Runner that plays nicely with Rails 3.1 assets without jasmine-headless-webkit
+email: 
+- searls@gmail.com
+- mvanholstyn@gmail.com
+- seeflanigan@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- app/assets/javascripts/jasmine_rails/application.js
+- app/assets/stylesheets/jasmine_rails/application.css
+- app/controllers/jasmine_rails/application_controller.rb
+- app/controllers/jasmine_rails/spec_runner_controller.rb
+- app/views/jasmine_rails/spec_runner/index.html.erb
+- app/views/layouts/jasmine_rails/spec_runner.html.erb
+- config/initializers/sprockets.rb
+- config/routes.rb
+- lib/jasmine-rails.rb
+- lib/jasmine_rails/engine.rb
+- lib/jasmine_rails/version.rb
+- lib/processes_jasmine_directives.rb
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: https://github.com/ThoughtWorksStudios/jasmine-rails
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.9
+signing_key: 
+specification_version: 3
+summary: Makes Jasmine easier on Rails 3.1
+test_files: []
+