Skip to Content Skip to Search
Methods
F
S
U

Instance Public methods

fixtures(*fixture_set_names)

# File activerecord/lib/active_record/test_fixtures.rb, line 42
def fixtures(*fixture_set_names)
  if fixture_set_names.first == :all
    raise StandardError, "No fixture path found. Please set `#{self}.fixture_path`." if fixture_path.blank?
    fixture_set_names = Dir[::File.join(fixture_path, "{**,*}/*.{yml}")].uniq
    fixture_set_names.reject! { |f| f.start_with?(file_fixture_path.to_s) } if defined?(file_fixture_path) && file_fixture_path
    fixture_set_names.map! { |f| f[fixture_path.to_s.size..-5].delete_prefix("/") }
  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 = {})

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.

# File activerecord/lib/active_record/test_fixtures.rb, line 38
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)

# File activerecord/lib/active_record/test_fixtures.rb, line 56
def setup_fixture_accessors(fixture_set_names = nil)
  fixture_set_names = Array(fixture_set_names || fixture_table_names)
  methods = Module.new do
    fixture_set_names.each do |fs_name|
      fs_name = fs_name.to_s
      accessor_name = fs_name.tr("/", "_").to_sym

      define_method(accessor_name) do |*fixture_names|
        force_reload = fixture_names.pop if fixture_names.last == true || fixture_names.last == :reload
        return_single_record = fixture_names.size == 1
        fixture_names = @loaded_fixtures[fs_name].fixtures.keys if fixture_names.empty?

        @fixture_cache[fs_name] ||= {}

        instances = fixture_names.map do |f_name|
          f_name = f_name.to_s if f_name.is_a?(Symbol)
          @fixture_cache[fs_name].delete(f_name) if force_reload

          if @loaded_fixtures[fs_name][f_name]
            @fixture_cache[fs_name][f_name] ||= @loaded_fixtures[fs_name][f_name].find
          else
            raise StandardError, "No fixture named '#{f_name}' found for fixture set '#{fs_name}'"
          end
        end

        return_single_record ? instances.first : instances
      end
      private accessor_name
    end
  end
  include methods
end

uses_transaction(*methods)

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

uses_transaction?(method)

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