Module: ActiveRecord::TestFixtures

Extended by:

ActiveSupport::Concern

Included in:

ActiveSupport::TestCase

Defined in:

activerecord/lib/active_record/fixtures.rb

Defined Under Namespace

Modules: ClassMethods

Instance Method Summary

• #after_teardown ⇒ Object
• #before_setup ⇒ Object
• #enlist_fixture_connections ⇒ Object
• #run_in_transaction? ⇒ Boolean
• #setup_fixtures ⇒ Object
• #teardown_fixtures ⇒ Object

Methods included from ActiveSupport::Concern

append_features, extended, included

Instance Method Details

#after_teardown ⇒ Object

# File 'activerecord/lib/active_record/fixtures.rb', line 710

def after_teardown
  super
  teardown_fixtures
end

#before_setup ⇒ Object

# File 'activerecord/lib/active_record/fixtures.rb', line 705

def before_setup
  setup_fixtures
  super
end

#enlist_fixture_connections ⇒ Object

# File 'activerecord/lib/active_record/fixtures.rb', line 883

def enlist_fixture_connections
  ActiveRecord::Base.connection_handler.connection_pool_list.map(&:connection)
end

#run_in_transaction? ⇒ Boolean

Returns:

• (Boolean)

# File 'activerecord/lib/active_record/fixtures.rb', line 832

def run_in_transaction?
  use_transactional_fixtures &&
    !self.class.uses_transaction?(method_name)
end

#setup_fixtures ⇒ Object

# File 'activerecord/lib/active_record/fixtures.rb', line 837

def setup_fixtures
  if pre_loaded_fixtures && !use_transactional_fixtures
    raise RuntimeError, 'pre_loaded_fixtures requires use_transactional_fixtures'
  end

  @fixture_cache = {}
  @fixture_connections = []
  @@already_loaded_fixtures ||= {}

  # Load fixtures once and begin transaction.
  if run_in_transaction?
    if @@already_loaded_fixtures[self.class]
      @loaded_fixtures = @@already_loaded_fixtures[self.class]
    else
      @loaded_fixtures = load_fixtures
      @@already_loaded_fixtures[self.class] = @loaded_fixtures
    end
    @fixture_connections = enlist_fixture_connections
    @fixture_connections.each do |connection|
      connection.begin_transaction joinable: false
    end
  # Load fixtures for every test.
  else
    ActiveRecord::FixtureSet.reset_cache
    @@already_loaded_fixtures[self.class] = nil
    @loaded_fixtures = load_fixtures
  end

  # Instantiate fixtures for every test if requested.
  instantiate_fixtures if use_instantiated_fixtures
end

#teardown_fixtures ⇒ Object

# File 'activerecord/lib/active_record/fixtures.rb', line 869

def teardown_fixtures
  # Rollback changes if a transaction is active.
  if run_in_transaction?
    @fixture_connections.each do |connection|
      connection.rollback_transaction if connection.transaction_open?
    end
    @fixture_connections.clear
  else
    ActiveRecord::FixtureSet.reset_cache
  end

  ActiveRecord::Base.clear_active_connections!
end