Project: RSpec Rails 3.2

Publisher: RSpec

transactional examples

By default rspec executes each individual example in a transaction.

You can also explicitly enable/disable transactions the configuration
property 'use_transactional_examples'.

Scenarios

run in transactions (default)
run in transactions (explicit)
disable transactions (explicit)
run in transactions with fixture

run in transactions (default)

Given

a file named "spec/models/widget_spec.rb" with:

require "rails_helper"

RSpec.describe Widget, :type => :model do
  it "has none to begin with" do
    expect(Widget.count).to eq 0
  end

  it "has one after adding one" do
    Widget.create
    expect(Widget.count).to eq 1
  end

  it "has none after one was created in a previous example" do
    expect(Widget.count).to eq 0
  end
end

When

I run rspec spec/models/widget_spec.rb

Then

the examples should all pass

run in transactions (explicit)

Given

a file named "spec/models/widget_spec.rb" with:

require "rails_helper"

RSpec.configure do |c|
  c.use_transactional_examples = true
end

RSpec.describe Widget, :type => :model do
  it "has none to begin with" do
    expect(Widget.count).to eq 0
  end

  it "has one after adding one" do
    Widget.create
    expect(Widget.count).to eq 1
  end

  it "has none after one was created in a previous example" do
    expect(Widget.count).to eq 0
  end
end

When

I run rspec spec/models/widget_spec.rb

Then

the examples should all pass

disable transactions (explicit)

Given

a file named "spec/models/widget_spec.rb" with:

require "rails_helper"

RSpec.configure do |c|
  c.use_transactional_examples = false
  c.order = "defined"
end

RSpec.describe Widget, :type => :model do
  it "has none to begin with" do
    expect(Widget.count).to eq 0
  end

  it "has one after adding one" do
    Widget.create
    expect(Widget.count).to eq 1
  end

  it "has one after one was created in a previous example" do
    expect(Widget.count).to eq 1
  end

  after(:all) { Widget.destroy_all }
end

When

I run rspec spec/models/widget_spec.rb

Then

the examples should all pass

run in transactions with fixture

Given

a file named "spec/models/thing_spec.rb" with:

require "rails_helper"

RSpec.describe Thing, :type => :model do
  fixtures :things
  it "fixture method defined" do
    things(:one)
  end
end

Given

a file named "spec/fixtures/things.yml" with:

one:
  name: MyString

When

I run rspec spec/models/thing_spec.rb

Then

the examples should all pass

Last published over 6 years ago by myronmarston.

transactional examples

RSpec Rails settings