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
... Then 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.

Make sure you have jetty running.