Add test coverage to your Sufia based Hydra Head

After Installing Sufia..

Add rspec-rails and factory-girl to your Gemfile

  group :development, :test do
    gem "rspec-rails"
    gem "capybara"
    gem "factory_girl_rails"
  end

Run bundle install

Run the rspec generator rails g rspec:install

Run rake spec

… everything should pass -- 0 tests, 0 failures

Add FactoryGirl, Capybara and Devise support to your rspec environment

Note: This section is closely based on the spec_helper.rb in sufia. You can refer to that file to see how it all fits together.

In order to run this type of test, you need to tell rspec to use FactoryGirl and you need to add a convenient find_or_create method to the FactoryGirl module.

Add these lines to your spec/spec_helper.rb

require 'capybara/rspec'
require 'capybara/rails'

module FactoryGirl
  def self.find_or_create(handle, by=:email)
    tmpl = FactoryGirl.build(handle)
    tmpl.class.send("find_by_#{by}".to_sym, tmpl.send(by)) || FactoryGirl.create(handle)
  end
end

within the RSpec.configure do |config| section, add

  config.include Devise::TestHelpers, :type => :controller

Copy this file into spec/factories/
https://github.com/projecthydra/sufia/blob/master/spec/factories/users.rb

Add your first test and make it pass

This is a relatively sophisticated test that attempts to log into your DashboardController and send a couple requests to it.

Copy the DashboardController test file from Sufia

Put this test into spec/controllers/
https://github.com/projecthydra/sufia/blob/master/spec/controllers/dashboard_controller_spec.rb

Clean up the test

Delete the 2 tests that are marked pending in spec/controllers/dashboard_controller.rb (lines 10-41). You don't want them.

Make your test use the routes from Sufia

The route to dashboard_controller is defined by Sufia. By default, rspec tests will only know about the routes defined in your application. To make the tests in this file aware of the Sufia routes, add this before block after the line that reads describe DashboardController do:

  before do
    @routes = Sufia::Engine.routes
  end

Make sure jetty is configured and running

If you have never done it, you might need to push your solr_config into jetty

rake jetty:stop
rake jetty:config

Now start jetty (if it's not already running)

rake jetty:start

Run the test

Now run rake spec again.

If you get a Connection Refused error, it's because jetty is not running.