123456789_123456789_123456789_123456789_123456789_

Module: ActiveRecord::TestFixtures::ClassMethods

Relationships & Source Files
Defined in: activerecord/lib/active_record/test_fixtures.rb

Instance Attribute Summary

Instance Method Summary

Instance Attribute Details

#fixture_path (rw)

This method is for internal use only.
[ GitHub ] 

  


# File 'activerecord/lib/active_record/test_fixtures.rb', line 56



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)   (rw)
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'activerecord/lib/active_record/test_fixtures.rb', line 65



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


  







Instance Method Details



  

    #fixtures(*fixture_set_names)  
  

  [ GitHub ]


  

  


# File 'activerecord/lib/active_record/test_fixtures.rb', line 70



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 = {})  
  



  

    

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.


  



  [ GitHub ]


  

  


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



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)  
  

  [ GitHub ]


  

  


# File 'activerecord/lib/active_record/test_fixtures.rb', line 86



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)  
  



  

    

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


  



  [ GitHub ]


  

  


# File 'activerecord/lib/active_record/test_fixtures.rb', line 102



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


  








  

    #uses_transaction?(method)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'activerecord/lib/active_record/test_fixtures.rb', line 107



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