Configuring RSpec

The following assumes that you've generated a middleman project using the its CLI middleman init your_project_name

Update your Gemfile

Add the following gems to your Gemfile and run bundle install

group :development, :test do
  gem 'capybara'
  gem 'pry'
  gem 'pry-byebug'
  gem 'rspec'
end

Setup RSpec

From your terminal, navigate to your project directory and initialize RSpec config files for your project with the following command

rspec --init

Update the .rspec file to have the following code

--format documentation
--color
--require spec_helper

Then remove all content in spec/spec_helper.rb and replace with the following

require 'rspec'
require 'capybara/rspec'

require 'middleman-core'
require 'middleman-core/rack'
require 'middleman-autoprefixer'
require 'middleman-livereload'

middleman_app = ::Middleman::Application.new

Capybara.app = ::Middleman::Rack.new(middleman_app).to_app do
  set :root, File.expand_path(File.join(File.dirname(FILE), '..'))
  set :environment, :development
  set :show_exceptions, false
end

With this in place we should now be ready to write our first spec

Feature specs

Most of the specs you'll be writing for a middleman app will be feature specs that test for certain things to be visible on the page. Below is a sample feature spec that checks if projects are listed on the index page

describe 'Index Page', type: :feature do
  it 'displays project list' do
    expect(page).to have_css '.projects'

    within '.projects' do
      expect(page).to have_content 'My First Website'
      expect(page).to have_content 'FizzBuzz'
    end
  end
end