jasmine-stories 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+.bundle
+db/*.sqlite3
+log/*.log
+tmp/
+.*.sw*
+*.orig
+.swp
+public/system
+*.*.BACKUP.*.lock
+*.*.BASE.*.lock
+*.*.REMOTE.*.lock
+*.*.LOCAL.*.lock
+.DS_Store
+*.*.gz
+Session.vim
+err.txt
+.sass-cache
+public/stylesheets/*.css
+.rvmrc

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem 'rails', '3.1.0'
+
+# Bundle edge Rails instead:
+# gem 'rails',     :git => 'git://github.com/rails/rails.git'
+
+gemspec
+
+platforms :ruby_18 do
+  gem "ruby-debug", ">= 0.10.3"
+end

data/Gemfile.lock

@@ -0,0 +1,110 @@
+PATH
+  remote: .
+  specs:
+    jasminerice (0.0.8)
+      haml
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.1.0)
+      actionpack (= 3.1.0)
+      mail (~> 2.3.0)
+    actionpack (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6)
+      rack (~> 1.3.2)
+      rack-cache (~> 1.0.3)
+      rack-mount (~> 0.8.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.0.0)
+    activemodel (3.1.0)
+      activesupport (= 3.1.0)
+      bcrypt-ruby (~> 3.0.0)
+      builder (~> 3.0.0)
+      i18n (~> 0.6)
+    activerecord (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+      arel (~> 2.2.1)
+      tzinfo (~> 0.3.29)
+    activeresource (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+    activesupport (3.1.0)
+      multi_json (~> 1.0)
+    arel (2.2.1)
+    bcrypt-ruby (3.0.1)
+    bcrypt-ruby (3.0.1-java)
+    builder (3.0.0)
+    columnize (0.3.4)
+    erubis (2.7.0)
+    haml (3.1.3)
+    hike (1.2.1)
+    i18n (0.6.0)
+    json (1.6.1)
+    json (1.6.1-java)
+    linecache (0.46)
+      rbx-require-relative (> 0.0.4)
+    mail (2.3.0)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.17.2)
+    multi_json (1.0.3)
+    polyglot (0.3.2)
+    rack (1.3.5)
+    rack-cache (1.0.3)
+      rack (>= 0.4)
+    rack-mount (0.8.3)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.1.0)
+      actionmailer (= 3.1.0)
+      actionpack (= 3.1.0)
+      activerecord (= 3.1.0)
+      activeresource (= 3.1.0)
+      activesupport (= 3.1.0)
+      bundler (~> 1.0)
+      railties (= 3.1.0)
+    railties (3.1.0)
+      actionpack (= 3.1.0)
+      activesupport (= 3.1.0)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (0.9.2.2)
+    rbx-require-relative (0.0.5)
+    rdoc (3.11)
+      json (~> 1.4)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    sprockets (2.0.3)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.14.6)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.30)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  jasminerice!
+  rails (= 3.1.0)
+  ruby-debug (>= 0.10.3)

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 YOURNAME
+
+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,98 @@
+Jasminerice
+===========
+
+Utilizing [Jasmine](http://pivotal.github.com/jasmine/) and taking full advantage
+of the Rails 3.1 asset pipeline. jasmine-stories removes any excuse YOU have for
+not testing your out of control application.
+This project rocks and uses the MIT-LICENSE.
+
+Headless Testing
+----------------
+
+See [guard-jasmine](https://github.com/netzpirat/guard-jasmine) for details.
+
+Installation
+------------
+
+This is a gem specifically for Rails 3.1. Just include it in
+your `Gemfile`:
+
+```ruby
+group :development, :test do
+  gem "jasmine-stories"
+end
+```
+
+The engine is automatically mounted into your application in the development
+and test environments. If you'd like to change that behavior, you can
+override the array `JasmineStories.environments` in an initializer.
+
+Usage
+-----
+
+### CoffeeScripts
+
+Create a file `spec/javascripts/stories.js.coffee` with the following content:
+
+	#=require_tree ./stories
+
+This pulls in all your specs from the `javascripts/stories` directory into Jasmine:
+
+```bash
+spec/javascripts/stories/*_story.js.coffee
+spec/javascripts/stories/*_story.js
+spec/javascripts/stories/*_story.js.erb
+```
+
+The Rails 3.1 asset pipeline using [Sprockets](https://github.com/sstephenson/sprockets)
+and [Tilt](https://github.com/rtomayko/tilt) ensure conversion.
+
+As well you can use the `#require` dependency mechanisms in your specs to
+pull dependencies. Here's an example `spec/javascripts/foo.js.coffee`:
+
+```coffeescript
+#= require foo
+#= require bar
+
+describe "Foo", ->
+  it "it is not bar", ->
+    v = new Foo()
+    expect(v.bar()).toEqual(false)
+
+describe "Bar", ->
+  it "it is not foo", ->
+    v = new Bar()
+    expect(v.foo()).toEqual(false)
+```
+
+### Stylesheets
+
+For including stylesheets in your specs, Jasminerice uses `spec/javascripts/spec.css`.
+Use Sprockets directives to include the right css files:
+
+```css
+/*
+ *= require application
+ */
+```
+
+### Start server
+
+Now start your server
+
+```bash
+rails s
+```
+
+Goto 
+
+```bash
+http://localhost:3000/jasmine-stories
+```
+
+and there are your acceptance tests.
+
+Author
+------
+
+* Dominik Guzei (http://wizzart.at | http://nerdkitchen.org)

data/Rakefile

@@ -0,0 +1,25 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler'
+  Bundler::GemHelper.install_tasks
+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    = 'JasmineStories'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+

data/app/assets/javascripts/jasmine-stories.js.coffee

@@ -0,0 +1,37 @@
+#=require jquery
+#=require jquery_ujs
+
+#=require namespace
+#=require jasmine
+#=require jasmine-html
+#=require jasmine-jquery
+#=require jasmine-grammar
+#=require jasmine-reporting
+
+# load all jasmine-species features
+Namespace.use('jasmine.grammar.FeatureStory.*');
+Namespace.use('jasmine.grammar.GWT.*');
+Namespace.use('jasmine.grammar.Meta.*');
+  
+execJasmine = ->
+  jasmineEnv.execute()
+jasmineEnv = jasmine.getEnv()
+jasmineEnv.updateInterval = 1000
+
+window.jsApiReporter = new jasmine.JsApiReporter()
+storyReporter = new jasmine.reporting.StyledHtmlReporter()
+
+jasmineEnv.addReporter storyReporter
+jasmineEnv.addReporter jsApiReporter
+
+jasmineEnv.specFilter = (spec) ->
+  storyReporter.specFilter spec
+
+jasmine.stories = {}
+jasmine.stories.autoExecute = true
+
+currentWindowOnload = window.onload
+window.onload = ->
+  currentWindowOnload()  if currentWindowOnload
+  if jasmine.stories.autoExecute
+    execJasmine()

data/app/assets/stylesheets/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_self
+ *= require_tree . 
+*/

data/app/controllers/jasmine_stories/application_controller.rb

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

data/app/controllers/jasmine_stories/spec_controller.rb

@@ -0,0 +1,10 @@
+module JasmineStories
+  class SpecController <  JasmineStories::ApplicationController
+
+    layout false
+
+    def index
+    end
+
+  end
+end

data/app/views/jasmine_stories/spec/index.html.haml

@@ -0,0 +1,10 @@
+%html
+  %head
+    %title Jasmine Spec Runner
+    = stylesheet_link_tag "jasmine"
+    = stylesheet_link_tag "jasmine-be-calm"
+    = stylesheet_link_tag "spec"
+    = javascript_include_tag "jasmine-stories", :debug => Rails.env.development?
+    = javascript_include_tag "stories", :debug => Rails.env.development?
+    = csrf_meta_tags
+  %body

data/config/initializers/jasmine-stories.rb

@@ -0,0 +1 @@
+Rails.application.config.assets.paths << File.join(Rails.root, "spec", "javascripts")

data/config/routes.rb

@@ -0,0 +1,7 @@
+JasmineStories::Engine.routes.draw do
+  root :to => "spec#index"
+end
+
+Rails.application.routes.draw do
+  mount JasmineStories::Engine => "/jasmine-stories"
+end

data/jasmine-stories.gemspec

@@ -0,0 +1,12 @@
+# Provide a simple gemspec so you can easily use your
+# project in your rails apps through git.
+Gem::Specification.new do |s|
+  s.name        = "jasmine-stories"
+  s.summary     = "Pain free coffeescript acceptance testing for Rails 3.1 using jasmine-species"
+  s.description = "Full support for the Rails 3.1 asset pipeline when acceptance testing your coffeescript or javascript using jasmine"
+  s.files       = `git ls-files`.split "\n"
+  s.authors     = ["Dominik Guzei"]
+  s.version     = "0.0.1"
+  s.platform    = Gem::Platform::RUBY
+  s.add_dependency( 'haml' )
+end

data/lib/jasmine-stories.rb

@@ -0,0 +1,5 @@
+require "jasmine-stories/engine"
+require 'haml'
+
+module JasmineStories
+end

data/lib/jasmine-stories/engine.rb

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

data/vendor/assets/javascripts/jasmine-grammar.js

@@ -0,0 +1,247 @@
+/**
+ * Jasmine Grammar - Additional Jasmine grammar to enable alternate BDD approaches.
+ * 
+ * Copyright (C) 2010-2011, Rudy Lattae
+ * License: Simplified BSD
+ * 
+ * Jasmine-Grammar contains some additions to the jasmine api that  make it 
+ * more suitable to alternate BDD approaches. The end-goal is streamline the 
+ * grammatical aspect of specing out an application from different view-points.
+ * 
+ * The new grammar should make it easier to create other types of specifications 
+ * apart from "describe" and "it should". They are simply wrappers 
+ * for "describe" and "it" so they follow the same rules for nesting. 
+ */
+
+// Top level namespace for the package
+jasmine.grammar = (typeof jasmine.grammar === 'undefined') ? {} : jasmine.grammar;
+
+
+/**
+ * Feature / Story => Scenario => ... style grammar
+ */
+jasmine.grammar.FeatureStory = {
+    
+    /**
+     * Defines a suite tagged as a "feature"
+     */
+    feature: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe('Feature: ' + description, specDefinitions);
+        suite.tags = ['feature'];
+        return suite;
+    },
+    
+    /**
+     * Defines a suite tagged as a "story"
+     */
+    story: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe('Story: ' + description, specDefinitions);
+        suite.tags = ['story'];
+        return suite;
+    },
+    
+    /**
+     * Defines a suite tagged as a "component"
+     */
+    component: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe('Component: ' + description, specDefinitions);
+        suite.tags = ['component'];
+        return suite;
+    },
+    
+    /**
+     * Defines a spec marked as a "scenario"
+     */
+    scenario: function(desc, func) {
+        return jasmine.grammar.getEnv().it('Scenario: ' + desc, func);
+    }
+};
+
+
+/**
+ * Given => When => Then ... style grammar
+ */
+jasmine.grammar.GWT = {
+    
+    /**
+     * Defines a "given" step as a runs block that marks the beginning of a GWT chain
+     */
+    given: function(desc, func) {
+        return this._addStepToCurrentSpec('Given ' + desc, func);
+    },
+    
+    /**
+     * Defines a "when" step as a runs block that marks the interesting event in a GWT chain
+     */
+    when: function(desc, func) {
+        return this._addStepToCurrentSpec('When ' + desc, func);
+    },
+    
+    /**
+     * Defines a "then" step as a runs block that marks the conclusion of a Given, when, then construct
+     */
+    then: function(desc, func) {
+        return this._addStepToCurrentSpec('Then ' + desc, func);
+    },
+    
+    /**
+     * Defines an "and" step as a runs block that is a continuation from a "then" statement
+     */
+    and: function(desc, func) {
+        return this._addStepToCurrentSpec('And ' + desc, func);
+    },
+    
+    /**
+     * Defines a "but" step as a runs block that is a continuation from a "then" statement
+     */
+    but: function(desc, func) {
+        return this._addStepToCurrentSpec('But ' + desc, func);
+    },    
+        
+    /**
+     * Adds the given function as a step (runs block) in the current spec. Also adds the description to the details list of the spec
+     */
+    _addStepToCurrentSpec: function(desc, func) {
+        var spec = jasmine.grammar.getEnv().currentSpec;
+        spec.details = spec.details || [];
+        spec.details.push(desc);
+        spec.runs(func);
+        return spec;
+    }
+};
+
+
+/**
+ * Add proper case aliases to GWT for Coffeescript use
+ */
+
+(function(GWT) {
+  GWT.Given = GWT.given;
+  GWT.When  = GWT.when;
+  GWT.Then  = GWT.then;
+  GWT.And   = GWT.and;
+  GWT.But   = GWT.but;
+}) (jasmine.grammar.GWT);
+
+
+
+
+/**
+ * Concern => Context => Specification style grammar
+ */
+jasmine.grammar.ContextSpecification = {
+    
+    /**
+     * Defines a suite tagged as a "concern"
+     */
+    concern: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe(description, specDefinitions);
+        suite.tags = ['concern'];
+        return suite;
+    },
+    
+    /**
+     * Defines a suite tagged as a "context"
+     */
+    context: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe(description, specDefinitions);
+        suite.tags = ['context'];
+        return suite;
+    },
+    
+    /**
+     * Defines a simple spec -- similar to it
+     */
+    spec: function(desc, func) {
+        return jasmine.grammar.getEnv().it(desc, func);
+    }
+}
+
+/**
+ * Executable docs (Topic => Example) style grammar
+ */
+jasmine.grammar.XDoc = {
+    
+    /**
+     * Defines a suite tagged as a "topic"
+     */
+    topic: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe(description, specDefinitions);
+        suite.tags = ['topic'];
+        return suite;
+    },
+    
+    /**
+     * Defines a suite tagged as an "example".
+     *
+     * An axample suite actually stores the inner suites as a string in the "defs" attribute 
+     */
+    example: function(description, specDefinitions) {
+        var suite = jasmine.grammar.getEnv().describe(description, specDefinitions);
+        suite.tags = ['example'];
+        suite.expose = true;
+        suite.defs = specDefinitions.toString()
+            .replace(/^function.*\(.*\).*{/, '')
+            .replace(/}$/, '').trim(); // stored for later output 
+        return suite;
+    },
+    
+    /**
+     * Defines a simple spec without any associated function
+     */
+    pass: function(desc, func) {
+        return jasmine.grammar.getEnv().it(desc);
+    }
+};
+
+
+/**
+ * Some more useful constructs that attach metadata to suites and specs
+ */
+jasmine.grammar.Meta = {
+    
+    /**
+     * Adds summary content to the current suite.
+     *
+     * @param {String} content(s)     variable number of detail content
+     * @see jasmine.grammar.SuiteDetails
+     */
+    summary: function() {
+        var suite = jasmine.grammar.getEnv().currentSuite;
+        suite.summary = suite.summary || [];
+        
+        if (arguments.length > 0) {
+            for(i=0; i<arguments.length; i++) {
+                suite.summary.push(arguments[i]);
+            }
+        }
+    },
+    
+    /**
+     * Adds detail entries in the current spec.
+     *
+     * @param {String} content(s)     variable number of detail content
+     * @see jasmine.grammar.SuiteDetails
+     */
+    details: function() {
+        var spec = jasmine.grammar.getEnv().currentSpec;
+        spec.details = spec.details || [];
+        
+        if (arguments.length > 0) {
+            for(i=0; i<arguments.length; i++) {
+                spec.details.push(arguments[i]);
+            }
+        }
+    }
+};
+
+
+// Utilities
+// =========
+
+/**
+ * Getter for the Jasmine environment. Makes it possible to inject a different environment when necessary.
+ */
+jasmine.grammar.getEnv = function() {
+    return jasmine.grammar._currentEnv = jasmine.grammar._currentEnv || jasmine.getEnv();
+};