DatabaseFlusher

database_flusher is a tiny and fast database cleaner inspired by database_cleaner and database_rewinder.

Features

• No monkey patching - uses ActiveSupport::Notifications and Mongo::Monitoring::Global to catch INSERT statements
• Fast :deletion strategy that cleans only tables/collections where INSERT statements were performed
• Faster disable_referential_integrity for PostgreSQL
• Executes multiple DELETE statements as one query with ActiveRecord

Supported ORMs and strategies

ORM	Deletion	Transaction
ActiveRecord	Yes	Yes
Mongoid	Yes	No

Installation

Add this line to your application's Gemfile:

gem 'database_flusher'

And then execute:

$ bundle

Usage

RSpec:

RSpec.configure do |config|
  config.use_transactional_fixtures = false

  config.before :suite do
    DatabaseFlusher[:active_record].strategy = :transaction
    DatabaseFlusher[:mongoid].strategy = :deletion
  end

  config.before :each do
    DatabaseFlusher[:active_record].strategy = :transaction
  end

  config.before :each, type: :feature do
    if Capybara.current_driver != :rack_test
      DatabaseFlusher[:active_record].strategy = :deletion
    end
  end

  config.before :each do
    DatabaseFlusher.start
  end

  config.append_after :each do
    DatabaseFlusher.clean
  end
end

Cucumber:

DatabaseFlusher[:active_record].strategy = :transaction
DatabaseFlusher[:mongoid].strategy = :deletion

Before('~@javascript') do
  DatabaseFlusher[:active_record].strategy = :transaction
  DatabaseFlusher.start
end

Before('@javascript') do
  DatabaseFlusher[:active_record].strategy = :deletion
  DatabaseFlusher.start
end

After do
  DatabaseFlusher.clean
end

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ebeigarts/database_flusher. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.