Utensils

Rspec stuff we use over and over again

Installation

Add this line to your application's Gemfile:

gem 'utensils', :group => :test

Usage

Create spec/support/utensils.rb
Add whichever bits you need:

require 'utensils/capybara_extensions'
require 'utensils/capybara_javascript'
require 'utensils/custom_matchers'
require 'utensils/database_cleaner'
require 'utensils/factory_girl'
require 'utensils/omniauth'
require 'utensils/spring'
require 'utensils/timecop'
require 'utensils/upload_macros'
require 'utensils/vcr'

capybara_extensions

Allows you to use active record objects with capybara finders

page.within(post) { click_link('Edit') }
page.find(book_2).drag_to(page.find(book_1))

capybara_javascript

Switches javascript driver to capybara-webkit and ignores hidden elements.

custom_matchers

A set of convenient matchers for rspec

page.should have_model(post) #looks for dom_id(post)
page.find(post).should have_class('current') #presence of html class
page.should have_image('banner.jpg') #presence of img
page.should have_image(recipe.photo) #presence of dragonfly photo
page.should have_order(recipe_3, recipe_1, recipe_2, within: '#recipes') #checks that objects are in a specific order

database_cleaner

Sets up rspec to use database_cleaner instead of transactional fixtures

factory_girl

Use shorthand for FactoryGirl, ie:

# instead of:
FactoryGirl.create(:post)

# use:
create(:post)

omniauth

Puts ominauth in test mode and provides the following macros:

stub_oauth(:facebook, info: { name: 'Bob' })
stub_oauth_error(:facebook)
login(user)

spring

Reloads factories because spring doesn't

timecop

Resets timecop after each spec

upload_macros

Provides fixture_file and fixture_file_path helper pointing to spec/fixtures directory

fixture_file_path('dummy.jpg') # 'spec/fixtures/dummy.jpg'
Photo.create(:file => fixture_file('dummy.jpg')) # attaches File spec/fixtures/dummy.jpg

vcr

Disables all outgoing http requests except for examples marked with :allow_http, which will be cached with VCR

describe 'examples' do
  it 'uses http cached with VCR', :allow_http do
    ...
  end
  it 'disables all outgoing http' do
    ...
  end
end

kinopyo/utensils