Module: ActiveRecord::TestFixtures::ClassMethods

Defined in:
lib/active_record/test_fixtures.rb

Instance Method Summary collapse

Instance Method Details

#fixture_pathObject

:nodoc:



55
56
57
58
59
60
61
62
# File 'lib/active_record/test_fixtures.rb', line 55

def fixture_path # :nodoc:
  ActiveRecord.deprecator.warn(<<~WARNING)
    TestFixtures.fixture_path is deprecated and will be removed in Rails 7.2. Use .fixture_paths instead.
    If multiple fixture paths have been configured with .fixture_paths, then .fixture_path will just return
    the first path.
  WARNING
  fixture_paths.first
end

#fixture_path=(path) ⇒ Object

:nodoc:



64
65
66
67
# File 'lib/active_record/test_fixtures.rb', line 64

def fixture_path=(path) # :nodoc:
  ActiveRecord.deprecator.warn("TestFixtures.fixture_path= is deprecated and will be removed in Rails 7.2. Use .fixture_paths= instead.")
  self.fixture_paths = Array(path)
end

#fixtures(*fixture_set_names) ⇒ Object



69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# File 'lib/active_record/test_fixtures.rb', line 69

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_set_names
  setup_fixture_accessors(fixture_set_names)
end

#set_fixture_class(class_names = {}) ⇒ Object

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.



51
52
53
# File 'lib/active_record/test_fixtures.rb', line 51

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) ⇒ Object



85
86
87
88
89
90
91
92
93
94
95
96
# File 'lib/active_record/test_fixtures.rb', line 85

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

#uses_transaction(*methods) ⇒ Object

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



101
102
103
104
# File 'lib/active_record/test_fixtures.rb', line 101

def uses_transaction(*methods)
  @uses_transaction = [] unless defined?(@uses_transaction)
  @uses_transaction.concat methods.map(&:to_s)
end

#uses_transaction?(method) ⇒ Boolean

Returns:

  • (Boolean)


106
107
108
109
# File 'lib/active_record/test_fixtures.rb', line 106

def uses_transaction?(method)
  @uses_transaction = [] unless defined?(@uses_transaction)
  @uses_transaction.include?(method.to_s)
end