module ActiveRecord::TestFixtures - activerecord-4.2.3 Documentation

# module ActiveRecord::TestFixtures

### Public Instance Methods

after_teardown() click to toggle source
Calls superclass method

    # File lib/active_record/fixtures.rb, line 830
    def after_teardown
      super
      teardown_fixtures
    end

before_setup() click to toggle source
Calls superclass method

    # File lib/active_record/fixtures.rb, line 825
    def before_setup
      setup_fixtures
      super
    end

enlist_fixture_connections() click to toggle source

    # File lib/active_record/fixtures.rb, line 973
    def enlist_fixture_connections
      ActiveRecord::Base.connection_handler.connection_pool_list.map(&:connection)
    end

run_in_transaction?() click to toggle source

    # File lib/active_record/fixtures.rb, line 922
    def run_in_transaction?
      use_transactional_fixtures &&
        !self.class.uses_transaction?(method_name)
    end

setup_fixtures(config = ActiveRecord::Base) click to toggle source

    # File lib/active_record/fixtures.rb, line 927
    def setup_fixtures(config = ActiveRecord::Base)
      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(config)
          @@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(config)
      end

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

teardown_fixtures() click to toggle source

    # File lib/active_record/fixtures.rb, line 959
    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

### Private Instance Methods

instantiate_fixtures() click to toggle source

    # File lib/active_record/fixtures.rb, line 983
    def instantiate_fixtures
      if pre_loaded_fixtures
        raise RuntimeError, 'Load fixtures before instantiating them.' if ActiveRecord::FixtureSet.all_loaded_fixtures.empty?
        ActiveRecord::FixtureSet.instantiate_all_loaded_fixtures(self, load_instances?)
      else
        raise RuntimeError, 'Load fixtures before instantiating them.' if @loaded_fixtures.nil?
        @loaded_fixtures.each_value do |fixture_set|
          ActiveRecord::FixtureSet.instantiate_fixtures(self, fixture_set, load_instances?)
        end
      end
    end

load_fixtures(config) click to toggle source

    # File lib/active_record/fixtures.rb, line 978
    def load_fixtures(config)
      fixtures = ActiveRecord::FixtureSet.create_fixtures(fixture_path, fixture_table_names, fixture_class_names, config)
      Hash[fixtures.map { |f| [f.name, f] }]
    end

load_instances?() click to toggle source

    # File lib/active_record/fixtures.rb, line 995
    def load_instances?
      use_instantiated_fixtures != :no_instances
    end