Utilizing Jasmine and taking full advantage of the Rails 3.1 asset pipeline Jasminerice removes any excuse YOU have for not testing your out of control sprawl of CoffeeScript files.
This project rocks and uses the MIT-LICENSE.
Brad Phelan is no longer actively developing this project but is accepting reasonable pull requests, so continue on with contributing.
This project is looking for a home :)
Brad (bradphelan) posted a notice saying that he wasn't actively maintaining the project and that it was looking for a home.
I (jejacks0n) offered to contribute to the project, and Brad granted me collaboration privileges. I added some specs and integration tests that will make contributing a little easier.
We'll be managing pull requests and issues together, and if someone would like to take over and move it to a different home you should contact Brad directly.
See guard-jasmine for details.
This gem has been tested and run with Rails 3.1 and 3.2. It should also run on Rails 4.
Just include it in your
group :development, :test do gem "jasminerice", :git => 'https://github.com/bradphelan/jasminerice.git' 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 change which groups the gem is included in via the gemfile.
Optionally, you can run the installer.
rails g jasminerice:install
This will add the required
spec.js.coffee, an example spec, and fixture to help get you started. It will also add a intializer
config/initializers/jasminerice.rb which can be used for easy setup of Jasminerice's options.
Create a file
#= require_tree ./
You can also use the
#= require directive in your specs to pull in dependencies manually. Here's an example
#= 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)
For including stylesheets in your specs, Jasminerice uses
/*= require application */
Jasminerice makes files located in the
example_fixture.html.haml in that path it will be available at the
%h2 Test Fixture %p Using fixtures
Since Jasminerice automatically makes a patched version of jasmine-jquery available in your specs, you can load the example fixture in your spec with the following.
You can also load JSON fixtures, e.g.
You can declare Jasminerice::SpecHelper (perhaps put inside lib/) to make helpers available to jasminerice fixtures.
So in your lib directory, create the helper, e.g.
module Jasminerice module SpecHelper def print_a_test "foo" end end end
Then you can use it in your fixtures.
%h1 Here is my helper = print_a_test
Start your server...
Watch your specs run.
You can override your current environment's
config.assets.debug configuration per request by adding
?debug=true to the jasmine path, eg.
Compatibility with Require.js
If you use Require.js in your project and need to load your modules in your jasmine specs, there is an option to prevent jasminerice from automatically executing the test runner before the modules are defined. This enables you to start the execution manually whenever you want in your
#= require your/specs/and/other/stuff # at the end of this file add: jasmine.rice.autoExecute = false define 'jasmine.waitsfor.requirejs', -> require ['jasmine.waitsfor.requirejs'], jasmine.getEnv().execute
The shown example defines a dummy module in require.js that is required immediately on the next line. This is a simple hack to wait until require.js has initialized all modules and start the jasmine runner after that.
Of course you can use
jasmine.rice.autoExecute = false also for all other cases where you need to control when your specs should be executed!
- Brad Phelan (firstname.lastname@example.org)