Skip to Content Skip to Search

module ActiveRecord::TestFixtures::ClassMethods

Public instance methods

fixtures(*fixture_set_names)

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 71
def fixtures(*fixture_set_names)
  if fixture_set_names.first == :all
    raise StandardError, "No fixture path found. Please set `#{self}.fixture_paths`." if fixture_paths.blank?
    fixture_set_names = fixture_paths.flat_map do |path|
      names = Dir[::File.join(path, "{**,*}/*.{yml}")].uniq
      names.reject! { |f| f.start_with?(file_fixture_path.to_s) } if defined?(file_fixture_path) && file_fixture_path
      names.map! { |f| f[path.to_s.size..-5].delete_prefix("/") }
    end.uniq
  else
    fixture_set_names = fixture_set_names.flatten.map(&:to_s)
  end

  self.fixture_table_names = (fixture_table_names | fixture_set_names).sort
  setup_fixture_accessors(fixture_set_names)
end

set_fixture_class(class_names = {})

Sets the model class for a fixture when the class name cannot be inferred from the fixture name.

Examples:

set_fixture_class some_fixture:        SomeModel,
                  'namespaced/fixture' => Another::Model

The keys must be the fixture names, that coincide with the short paths to the fixture files.

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 67
def set_fixture_class(class_names = {})
  self.fixture_class_names = fixture_class_names.merge(class_names.stringify_keys)
end

setup_fixture_accessors(fixture_set_names = nil)

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 87
def setup_fixture_accessors(fixture_set_names = nil)
  fixture_set_names = Array(fixture_set_names || fixture_table_names)
  unless fixture_set_names.empty?
    self.fixture_sets = fixture_sets.dup
    fixture_set_names.each do |fs_name|
      key = fs_name.to_s.include?("/") ? -fs_name.to_s.tr("/", "_") : fs_name
      key = -key.to_s if key.is_a?(Symbol)
      fs_name = -fs_name.to_s if fs_name.is_a?(Symbol)
      fixture_sets[key] = fs_name
    end
  end
end

skip_transactional_tests_for_database(database_name)

Do not use transactional tests for the given database. This overrides the default setting as defined by ‘use_transactional_tests`, which applies to all database connection pools not explicitly configured here.

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 48
def skip_transactional_tests_for_database(database_name)
  use_transactional_tests_for_database(database_name, false)
end

use_transactional_tests_for_database(database_name, enabled = true)

Enable or disable transactions per database. This overrides the default setting as defined by ‘use_transactional_tests`, which applies to all database connection pools not explicitly configured here.

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 55
def use_transactional_tests_for_database(database_name, enabled = true)
  self.database_transactions_config = database_transactions_config.merge(database_name => enabled)
end

uses_transaction(*methods)

Prevents automatically wrapping each specified test in a transaction, to allow application logic transactions to be tested in a top-level (non-nested) context.

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 103
def uses_transaction(*methods)
  @uses_transaction = [] unless defined?(@uses_transaction)
  @uses_transaction.concat methods.map(&:to_s)
end

uses_transaction?(method)

Source code GitHub 
# File activerecord/lib/active_record/test_fixtures.rb, line 108
def uses_transaction?(method)
  @uses_transaction = [] unless defined?(@uses_transaction)
  @uses_transaction.include?(method.to_s)
end

Definition files