guard-jasmine 1.1.0 → 1.1.1

data/README.md

@@ -1,6 +1,6 @@
 # Guard::Jasmine [![Build Status](https://secure.travis-ci.org/netzpirat/guard-jasmine.png)](http://travis-ci.org/netzpirat/guard-jasmine)
 
-Guard::Jasmine automatically tests your Jasmine specs on Rails when files are modified.
+Guard::Jasmine automatically tests your Jasmine specs when files are modified.
 
 Tested on MRI Ruby 1.8.7, 1.9.2, 1.9.3, REE and the latest versions of JRuby and Rubinius.
 
@@ -13,12 +13,13 @@ If you have any questions please join us on our [Google group](http://groups.goo
 * [Installation](#installation)
   * [Guard and Guard::Jasmine](#guard-guard-jasmine)
   * [PhantomJS](#phantomjs)
-* [Rails 3.1 setup](#rails31)
-  * [How it works](#rails31-works)
-  * [Jasminerice](#rails31-jasminerice)
-* [Rails 2 & Rails 3 setup](#rails23)
-  * [How it works](#rails23-works)
-  * [Jasmine Gem](#rails23-jasmine-gem)
+* [Rails with the asset pipeline](#asset-pipeline)
+  * [How it works](#asset-pipeline-works)
+  * [Jasminerice](#asset-pipeline-jasminerice)
+  * [Jasmine Stories](#asset-pipeline-jasmine-stories)
+* [Rails without the asset pipeline and plain Ruby projects](#without-asset-pipeline)
+  * [How it works](#without-asset-pipeline-works)
+  * [Jasmine Gem](#without-asset-pipeline-jasmine-gem)
 * [Usage](#usage)
   * [Guardfile](#guardfile)
 * [Options](#options)
@@ -46,7 +47,10 @@ Ruby.
 various web standards: DOM handling, CSS selector, JSON, Canvas, and SVG.
 
 * Runs the standard Jasmine test runner, so you can use [Jasminerice][] for integrating [Jasmine][] into the
-[Rails 3.1 asset pipeline][] and write your specs in [CoffeeScript][].
+[Rails asset pipeline][] and write your specs in [CoffeeScript][].
+
+* Can be used to run [Jasmine-species](http://rudylattae.github.com/jasmine-species/) acceptance tests provided by
+[Jasmine Stories](https://github.com/DominikGuzei/jasmine-stories).
 
 * Thor and Rake command line helper for CI server integration.
 
@@ -101,19 +105,19 @@ $ sudo apt-get install phantomjs
 You can also build it from source for several other operating systems, please consult the
 [PhantomJS build instructions][].
 
-<a name="rails31" />
-## Rails 3.1 setup
+<a name="asset-pipeline" />
+## Rails with the asset pipeline setup
 
-With Rails 3.1 you can write your Jasmine specs in addition to JavaScript with CoffeeScript, fully integrated into the
-Rails 3.1 asset pipeline with [Jasminerice][]. You have full access to your running Rails app, but it's a good practice
-to fake the server response. Check out the excellent [Sinon.JS][] documentation to learn more about this topic.
+With Rails 3.1 and later you can write your Jasmine specs in addition to JavaScript with CoffeeScript, fully integrated
+into the Rails asset pipeline with [Jasminerice][]. You have full access to your running Rails app, but it's a good
+practice to fake the server response. Check out the excellent [Sinon.JS][] documentation to learn more about this topic.
 
 Guard::Jasmine will start a Rails Rack server to run your specs.
 
-<a name="rails31-works" />
+<a name="asset-pipeline-works" />
 ### How it works
 
-![Guard Jasmine](https://github.com/netzpirat/guard-jasmine/raw/master/resources/guard-jasmine-rails31.jpg)
+![Guard Jasmine](https://github.com/netzpirat/guard-jasmine/raw/master/resources/guard-jasmine-with-asset-pipeline.jpg)
 
 1. Guard is triggered by a file modification.
 2. Guard::Jasmine executes the [PhantomJS script][].
@@ -126,7 +130,7 @@ Guard::Jasmine will start a Rails Rack server to run your specs.
 9. The PhantomJS script collects the Jasmine runner results and returns a JSON report.
 10. Guard::Jasmine reports the results to the console and system notifications.
 
-<a name="rails31-jasminerice" />
+<a name="asset-pipeline-jasminerice" />
 ### Jasminerice
 
 Please read the detailed installation and configuration instructions at [Jasminerice][].
@@ -144,10 +148,10 @@ And run following from the Terminal:
 ```bash
 mkdir -p spec/javascripts
 echo -e "#=require application\n#=require_tree ./" > spec/javascripts/spec.js.coffee
-echo -e "/*\n * add css using =require application\n */" > spec/javascripts/spec.css
+echo -e "/*\n *=require application\n */" > spec/javascripts/spec.css
 ```
 
-This creates the directory `spec/javascripts` where your CoffeeScript tests go into. You define the Rails 3.1
+This creates the directory `spec/javascripts` where your CoffeeScript tests goes into. You define the Rails
 asset pipeline manifest in `spec/javascripts/spec.js.coffee`:
 
 ```coffeescript
@@ -157,21 +161,54 @@ asset pipeline manifest in `spec/javascripts/spec.js.coffee`:
 
 It also creates an empty `spec/javascripts/spec.css` file as it is always requested when running specs.
 
-Now you can access `/jasmine` url when you start rails server normally.
+Now you can access `/jasmine` when you start your Rails server normally.
+
+<a name="asset-pipeline-jasmine-stories" />
+### Jasmine Stories acceptance tests
+
+[Jasmine Stories](https://github.com/DominikGuzei/jasmine-stories) is a Jasminerice clone and that serves
+[Jasmine-species](http://rudylattae.github.com/jasmine-species/) acceptance tests.
 
-<a name="rails23" />
-## Rails 2 & Rails 3 setup
+In short, you add it to your `Gemfile`:
+
+```ruby
+group :development, :test do
+  gem 'jasmine-stories'
+end
+```
+
+And run following from the Terminal:
+
+```bash
+mkdir -p spec/javascripts/stories
+echo -e "#=require_tree ./stories" > spec/javascripts/stories.js.coffee
+echo -e "/*\n *=require application\n */" > spec/javascripts/spec.css
+```
+
+This creates the directory `spec/javascripts/stories` where your CoffeeScript acceptance tests goes into.
+
+Now you can access `/jasmine-stories` when you start your Rails server normally. You have to change the Jasmine runner
+accordingly:
+
+```ruby
+guard :jasmine, :jasmine_url => 'http://127.0.0.1:8888/jasmine-stories' do
+  ...
+end
+```
 
-With Rails 2 or Rails 3 you can use [the Jasmine Gem][] to configure your Jasmine specs and server the Jasmine
-runner. You don't have full access to your running Rails app, but it's anyway a good practice to fake the server
-response. Check out the excellent [Sinon.JS][] documentation to learn more about this topic.
+<a name="without-asset-pipeline" />
+## Rails without the asset pipeline and plain Ruby projects
+
+With Rails without the asset pipeline or a plain Ruby project, you can use [the Jasmine Gem][] to configure your Jasmine
+specs and server the Jasmine runner. You don't have full access to your running Rails app, but it's anyway a good
+practice to fake the server response. Check out the excellent [Sinon.JS][] documentation to learn more about this topic.
 
 Guard::Jasmine will start a Jasmine Gem Rack server to run your specs.
 
-<a name="rails23-works" />
+<a name="without-asset-pipeline-works" />
 ### How it works
 
-![Guard Jasmine](https://github.com/netzpirat/guard-jasmine/raw/master/resources/guard-jasmine-rails23.jpg)
+![Guard Jasmine](https://github.com/netzpirat/guard-jasmine/raw/master/resources/guard-jasmine-without-asset-pipeline.jpg)
 
 1. Guard is triggered by a file modification.
 2. Guard::Jasmine executes the [PhantomJS script][].
@@ -182,12 +219,12 @@ Guard::Jasmine will start a Jasmine Gem Rack server to run your specs.
 7. The PhantomJS script collects the Jasmine runner results and returns a JSON report.
 8. Guard::Jasmine reports the results to the console and system notifications.
 
-<a name="rails23-jasmine-gem" />
+<a name="without-asset-pipeline-jasmine-gem" />
 ### Jasmine Gem
 
 Please read the detailed installation and configuration instructions at [the Jasmine Gem][].
 
-In short, you add it to your `Gemfile`:
+In short, you add the Jasmine gem to your `Gemfile`:
 
 ```ruby
 group :development, :test do
@@ -195,15 +232,25 @@ group :development, :test do
 end
 ```
 
-and generate the configuration files:
+and generate the configuration files and change the Jasmine url:
+
+```ruby
+guard :jasmine, :jasmine_url => 'http://localhost:8888/' do
+  ...
+end
+```
+
+#### Rails 3 without the asset pipeline
 
-#### for Rails 3
+Install the Jasmine gem in your Rails 3 app with:
 
 ```bash
 $ rails g jasmine:install
 ```
 
-#### for Rails 2
+#### Rails 2 and plain Ruby project
+
+Install the Jasmine gem in your Rails 2 app or a plain Ruby project with:
 
 ```bash
 $ script/generate jasmine
@@ -305,7 +352,7 @@ environment variable.
 The spec runner options configures the behavior driven development (or BDD) cycle:
 
 ```ruby
-:spec_dir => false                            # Directory with the Jasmine specs.
+:spec_dir => 'app/spec'                       # Directory with the Jasmine specs.
                                               # default: 'spec/javascripts'
 
 :clean => false                               # Clean the spec list by only keep Jasmine specs within the project.
@@ -497,6 +544,21 @@ end
 Guard::JasmineTask.new(:jasmine_no_server, '-s none')
 ```
 
+Now you'll set your tasks in the Rake task list:
+
+```bash
+$ rake -T guard
+rake guard:jasmine            # Run all Jasmine specs
+rake guard:jasmine_no_server  # Run all Jasmine specs
+```
+
+and you can execute the Guard::Jasmine specs on the console by running
+the task:
+
+```bash
+$ rake guard:jasmine
+```
+
 <a name="travis-ci" />
 ### Travis CI integration
 
@@ -504,9 +566,6 @@ With the given `guard-jasmine` script you're able to configure [Travis CI](http:
 Simply use the `script` setting in your `.travis.yml`:
 
 ```yaml
-before_script:
-  - "export DISPLAY=:99.0"
-  - "sh -e /etc/init.d/xvfb start"
 script: 'bundle exec guard-jasmine'
 ```
 

data/lib/guard/jasmine/cli.rb

@@ -31,13 +31,13 @@ module Guard
       method_option :port,
                     :type => :numeric,
                     :aliases => '-p',
-                    :default => 8888,
+                    :default => 3001,
                     :desc => 'Server port to use'
 
       method_option :url,
                     :type => :string,
                     :aliases => '-u',
-                    :default => 'http://localhost:8888/jasmine',
+                    :default => 'http://localhost:3001/jasmine',
                     :desc => 'The url of the Jasmine test runner'
 
       method_option :bin,

data/lib/guard/jasmine/task.rb

@@ -34,7 +34,7 @@ module Guard
         desc 'Run all Jasmine specs'
         task(name) do
           begin
-            ::Guard::Jasmine::CLI.start(options.split)
+            ::Guard::Jasmine::CLI.start(self.options.split)
 
           rescue SystemExit => e
             case e.status

data/lib/guard/jasmine/util.rb

@@ -48,12 +48,16 @@ module Guard
 
           if version
             # Remove all but version, e.g. from '1.5 (development)'
-            version = version.match(/(\d\.)*(\d)/)[0]
-
-            if Gem::Version.new(version) < Gem::Version.new('1.3.0')
-              ::Guard::Jasmine::Formatter.error "PhantomJS executable at #{ bin } must be at least version 1.3.0"
+            cleaned_version = version.match(/(\d\.)*(\d)/)
+
+            if cleaned_version
+              if Gem::Version.new(cleaned_version[0]) < Gem::Version.new('1.3.0')
+                ::Guard::Jasmine::Formatter.error "PhantomJS executable at #{ bin } must be at least version 1.3.0"
+              else
+                true
+              end
             else
-              true
+              ::Guard::Jasmine::Formatter.error "PhantomJS reports unknown version format: #{ version }"
             end
           else
             ::Guard::Jasmine::Formatter.error "PhantomJS executable doesn't exist at #{ bin }"

data/lib/guard/jasmine/version.rb

@@ -1,6 +1,6 @@
 module Guard
   module JasmineVersion
     # Guard::Jasmine version that is used for the Gem specification
-    VERSION = '1.1.0'
+    VERSION = '1.1.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: guard-jasmine
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-27 00:00:00.000000000 Z
+date: 2012-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667685600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,15 +21,10 @@ dependencies:
         version: 0.8.3
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.8.3
+  version_requirements: *70161667685600
 - !ruby/object:Gem::Dependency
   name: multi_json
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667685160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -37,15 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667685160
 - !ruby/object:Gem::Dependency
   name: childprocess
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667684460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -53,15 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667684460
 - !ruby/object:Gem::Dependency
   name: thor
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667683840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -69,15 +54,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667683840
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667683200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -85,15 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667683200
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667682560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -101,15 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667682560
 - !ruby/object:Gem::Dependency
   name: guard-coffeescript
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667681940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -117,15 +87,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667681940
 - !ruby/object:Gem::Dependency
   name: guard-shell
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667681240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -133,15 +98,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667681240
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667680820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -149,15 +109,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667680820
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667680400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -165,15 +120,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667680400
 - !ruby/object:Gem::Dependency
   name: redcarpet
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667679960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -181,15 +131,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667679960
 - !ruby/object:Gem::Dependency
   name: pry
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667679520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -197,15 +142,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667679520
 - !ruby/object:Gem::Dependency
   name: yajl-ruby
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70161667679100 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -213,12 +153,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70161667679100
 description: Guard::Jasmine automatically tests your Jasmine specs on PhantomJS
 email:
 - michi@netzpiraten.ch
@@ -272,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: guard-jasmine
-rubygems_version: 1.8.19
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
 summary: Guard gem for headless testing with Jasmine