• Если вы начали писать тесты недавно.
• Если вы пишете тесты и считаете, что в них много копипасты, или можно значительно улучшить их.
• Если вы пишете тесты изредка или не пишете совсем, так как вам не нравится или считаете, что это долго.
• Если вы мастер в написании тестов. Возможно, вы узнаете некоторые тонкости или найдете несколько полезных мелочей.

На каждый день

RSpec DSL

let

let(:project) { Project.new(project_attrs) }
let(:project_attrs) { {name: 'new_name', description: 'new_description'} }

context 'when empty name is given' do
  let(:project_attrs) { super().merge!(name: '') }
  # В текущей версии ruby super в этом случае нужно вызывать, явно указывая аргументы.
  # Тут их нет, поэтому ().
end

subject

describe '#valid?' do
  subject { user.valid? }

  it { should eq true }
  # или
  it { is_expected.to eq true }

  # subject можно использовать и c привычными матчерами
  context 'when name is empty' do
    it 'adds error' do
      expect { subject }.to change(user.errors, :any?).to true
    end
  end
end

# Пример теста контроллера

RSpec.describe ProjectsController do
  describe '#index' do
    subject { get :index }

    it { should redirect_to new_user_session_path }

    context 'for signed in user' do
      sign_in { create(:user) } # хэлпер, чтобы залогинить пользователя
      it { should be_forbidden }

      context 'with permissions' do
        add_permissions(:manager) # хэлпер для добавления прав залогиненному пользователю
        it { should be_ok }
      end
    end
  end

  # Тут и ниже опустим авторизацию для экономии места
  describe '#create' do
    subject { post :create, project: resource_params }
    let(:resource_params) { {name: 'new_project'} }

    it 'creates resource and redirects to its page' do
      expect { subject }.to change(Project, :count).by(1)
      resource = Project.last
      expect(project.name).to eq 'new_name'
      expect(subject).to redirect_to project_path(resource)
    end

    context 'when params are invalid' do
      let(:resource_params) { super().merge!(name: '') }

      it { should render_template :new }
      it 'doesnt create resource' do
        expect { subject }.to_not change(Project, :count)
      end
    end
  end
end

subject do
  get '/projects'
  response
end

describe '#like!' do
  subject { -> { user.like! post } }

  it { should change(post, :likes_count).by(1) }
  it { should change(user, :favorite_posts).by(post) }

  context 'when post is already favorite' do
    before { subject.call }
    it { should raise_error /Already favorite/ }
  end
end

describe '.cleanup_str' do
  subject { ->(*args) { described_class.cleanup_str(*args) } }

  it 'removes non-word symbols' do
    expect(subject.call('xY12')).to eq 'xY12'
    expect(subject.call('x+Y-1_2')).to eq 'xY12'
    expect(subject.call('x.Y 1;2')).to eq 'xY12'
  end
end

its

RSpec.describe ProjectsController do
  let(:resource) { create(:project) }

  describe '#update' do
    subject { -> { patch :update, id: project, project: resource_params } }
    let(:resource_params) { {name: 'updated_name'} }

    it { should change { resource.reload.name }.to 'updated_name' }
    its(:call) { should redirect_to project_path(resource) }
  end
end

RSpec.describe UsersController do
  let(:resourse) { create(:user) }

  describe '#show' do
    subject { get :show, id: resource, format: :json }

    its('json_body.keys') { should contain_exactly(*w(name projects avatar)) }
    its('json_body.avatar.keys') { should contain_exactly(*w(url size)) }
    its('json_body.projects.first.keys') { should contain_exactly(*w(name created_at)) }
  end
end

described_class

Именование переменных

shared_examples

RSpec.describe ProjectsController do
  let(:resource) { create(:project) }

  shared_examples 'rendering resource' do
    it { should be_ok }
    its(:json_body) { should include 'id' => resource.id, 'name' => resource.name }
  end

  describe '#show' do
    subject { get :show, id: resource.id }
    include_examples 'rendering resource'
  end

  describe '#search' do
    subject { get :search, q: resource.name }
    include_examples 'rendering resource'
  end

RSpec.shared_examples 'hooks controller #create' do |**options|
  describe '#create' do
    subject { post :create, params }

    context 'on success' do
      let(:params) { valid_params }
      # Общие проверки
      it { should change { something } }
      # Опциональные проверки
      instance_eval(&options[:on_success]) if options[:on_success]
    end

    context 'on failure' do
      let(:params) { invalid_params }
      it { should_not change { something } }
      
      if options[:on_failure]
        instance_eval(&options[:on_failure])
      else
        its(:status) { should eq 422 } # дефолтное поведение
      end
    end
  end
end

RSpec.describe BrandedHooksController do
  include_examples 'hooks controller #create',
    on_success: -> { its(:json_body) { should eq 'status' => 'ok' } },
    on_failure: -> { its(:json_body) { should eq 'status' => 'rejected' } } do
      let(:valid_params) { {type: 'hook'} }
      let(:invalid_params) { {type: 'unsupported'} }
    end
end

Ускоряем тесты

Отключите долгие тесты

# spec_helper.rb

# Exclude some tags by default. Running 1 file won't use exclusions.
# Use `FULL=true bin/rspec` to disable filters.
if (!ENV.key?('FULL') || !ENV.key?('CI')) && config.files_to_run.size > 1
  config.filter_run_excluding :external, :elastics
end

# some_job_spec.rb
describe '.process_file', :external do
  it 'does somithing heavy'
end

• только один файл some_job_spec.rb
• `FULL=true bin/rspec`
• на CI сервере (если установлена envar CI)

Отключите процессинг изображений

module SpecHelpers
  # All image uploaders are descendants of ImageUploader. This module
  # toggles <code>enable_processing</code> of it and all its descendants.
  module ImageProcessing
    module_function

    # Overwrites cached values in ancestors.
    def enable_processing=(val)
      ImageUploader.enable_processing = val
      ImageUploader.descendants.each { |x| x.enable_processing = val }
    end

    def with_processing(val)
      old_value = ImageUploader.enable_processing
      self.enable_processing = val
      yield
    ensure
      self.enable_processing = old_value unless old_value == ImageUploader.enable_processing
    end
  end
end

# rails_helper.rb
around process_images: true do |ex|
  SpecHelpers::ImageProcessing.with_processing(true) { ex.run }
end

Полезные мелочи

• RSpec3 использует .rspec для задания дефолтных флагов. После установки в нём есть строка `--require spec_helper`. Если её заменить на `--require rails_helper`, то можно будет не писать `require 'rails_helper'` в каждом спеке.
• ^^
  

  # spec_helper.rb
  require 'bigdecimal'
  BigDecimal.class_eval do
    alias_method :inspect_orig, :inspect
    alias_method :inspect, :to_s
  end