Module: ActiveRecord::TestFixtures
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
::ActiveSupport::Concern
|
|
Defined in: | activerecord/lib/active_record/test_fixtures.rb |
Class Method Summary
::ActiveSupport::Concern
- Extended
class_methods | Define class methods from given block. |
included | Evaluate given block in context of base class, so that you can write class macros here. |
prepended | Evaluate given block in context of base class, so that you can write class macros here. |
append_features, prepend_features |
Instance Attribute Summary
- #load_instances? ⇒ Boolean readonly private
- #run_in_transaction? ⇒ Boolean readonly private
Instance Method Summary
-
#fixture(fixture_set_name, *fixture_names)
Generic fixture accessor for fixture names that may conflict with other methods.
- #access_fixture(fs_name, *fixture_names) private
- #active_record_fixture(fixture_set_name, *fixture_names) private
- #instantiate_fixtures private
- #invalidate_already_loaded_fixtures private
- #load_fixtures(config) private
- #method_missing(method) private
- #respond_to_missing?(method, include_private = false) ⇒ Boolean private
- #setup_asynchronous_queries_session private
- #setup_fixtures(config = ActiveRecord::Base) private
-
#setup_shared_connection_pool
private
Shares the writing connection pool with connections on other handlers.
- #setup_transactional_fixtures private
- #teardown_asynchronous_queries_session private
- #teardown_fixtures private
- #teardown_shared_connection_pool private
- #teardown_transactional_fixtures private
- #transactional_tests_for_pool?(pool) ⇒ Boolean private
- #after_teardown Internal use only
- #before_setup Internal use only
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method) (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 301
def method_missing(method, ...) if fixture_sets.key?(method.name) active_record_fixture(method, ...) else super end end
DSL Calls
included
[ GitHub ]20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
# File 'activerecord/lib/active_record/test_fixtures.rb', line 20
included do ## # :singleton-method: fixture_paths # # Returns the ActiveRecord::FixtureSet collection ## # :singleton-method: fixture_paths= # # :call-seq: # fixture_paths=(fixture_paths) class_attribute :fixture_paths, instance_writer: false, default: [] class_attribute :fixture_table_names, default: [] class_attribute :fixture_class_names, default: {} class_attribute :use_transactional_tests, default: true class_attribute :use_instantiated_fixtures, default: false # true, false, or :no_instances class_attribute :pre_loaded_fixtures, default: false class_attribute :lock_threads, default: true class_attribute :fixture_sets, default: {} class_attribute :database_transactions_config, default: {} ActiveSupport.run_load_hooks(:active_record_fixtures, self) end
Instance Attribute Details
#load_instances? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'activerecord/lib/active_record/test_fixtures.rb', line 297
def load_instances? use_instantiated_fixtures != :no_instances end
#run_in_transaction? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'activerecord/lib/active_record/test_fixtures.rb', line 123
def run_in_transaction? has_explicit_config = database_transactions_config.any? { |_, enabled| enabled } (use_transactional_tests || has_explicit_config) && !self.class.uses_transaction?(name) end
Instance Method Details
#access_fixture(fs_name, *fixture_names) (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 325
def access_fixture(fs_name, *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
#active_record_fixture(fixture_set_name, *fixture_names) (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 317
def active_record_fixture(fixture_set_name, *fixture_names) if fs_name = fixture_sets[fixture_set_name.name] access_fixture(fs_name, *fixture_names) else raise StandardError, "No fixture set named '#{fixture_set_name.inspect}'" end end
#after_teardown
This method is for internal use only.
[ GitHub ]
# File 'activerecord/lib/active_record/test_fixtures.rb', line 14
def after_teardown # :nodoc: super ensure teardown_fixtures end
#before_setup
This method is for internal use only.
[ GitHub ]
# File 'activerecord/lib/active_record/test_fixtures.rb', line 9
def before_setup # :nodoc: setup_fixtures super end
#fixture(fixture_set_name, *fixture_names)
Generic fixture accessor for fixture names that may conflict with other methods.
assert_equal "Ruby on Rails", web_sites(:rubyonrails).name
assert_equal "Ruby on Rails", fixture(:web_sites, :rubyonrails).name
# File 'activerecord/lib/active_record/test_fixtures.rb', line 118
def fixture(fixture_set_name, *fixture_names) active_record_fixture(fixture_set_name, *fixture_names) end
#instantiate_fixtures (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 285
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
#invalidate_already_loaded_fixtures (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 184
def invalidate_already_loaded_fixtures @@already_loaded_fixtures.clear end
#load_fixtures(config) (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 281
def load_fixtures(config) ActiveRecord::FixtureSet.create_fixtures(fixture_paths, fixture_table_names, fixture_class_names, config).index_by(&:name) end
#respond_to_missing?(method, include_private = false) ⇒ Boolean
(private)
# File 'activerecord/lib/active_record/test_fixtures.rb', line 309
def respond_to_missing?(method, include_private = false) if include_private && fixture_sets.key?(method.name) true else super end end
#setup_asynchronous_queries_session (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 176
def setup_asynchronous_queries_session @_async_queries_session = ActiveRecord::Base.asynchronous_queries_tracker.start_session end
#setup_fixtures(config = ActiveRecord::Base) (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 129
def setup_fixtures(config = ActiveRecord::Base) if pre_loaded_fixtures && !use_transactional_tests raise RuntimeError, "pre_loaded_fixtures requires use_transactional_tests" end @fixture_cache = {} @fixture_cache_key = [self.class.fixture_table_names.dup, self.class.fixture_paths.dup, self.class.fixture_class_names.dup] @fixture_connection_pools = [] @@already_loaded_fixtures ||= {} @connection_subscriber = nil @saved_pool_configs = Hash.new { |hash, key| hash[key] = {} } if run_in_transaction? # Load fixtures once and begin transaction. @loaded_fixtures = @@already_loaded_fixtures[@fixture_cache_key] unless @loaded_fixtures @@already_loaded_fixtures.clear @loaded_fixtures = @@already_loaded_fixtures[@fixture_cache_key] = load_fixtures(config) end setup_transactional_fixtures else # Load fixtures for every test. ActiveRecord::FixtureSet.reset_cache invalidate_already_loaded_fixtures @loaded_fixtures = load_fixtures(config) end setup_asynchronous_queries_session # Instantiate fixtures for every test if requested. instantiate_fixtures if use_instantiated_fixtures end
#setup_transactional_fixtures (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 192
def setup_transactional_fixtures setup_shared_connection_pool # Begin transactions for connections already established @fixture_connection_pools = ActiveRecord::Base.connection_handler.connection_pool_list(:writing) # Filter to pools that want to use transactions @fixture_connection_pools.select! { |pool| transactional_tests_for_pool?(pool) } @fixture_connection_pools.each do |pool| pool.pin_connection!(lock_threads) pool.lease_connection end # When connections are established in the future, begin a transaction too @connection_subscriber = ActiveSupport::Notifications.subscribe("!connection.active_record") do |_, _, _, _, payload| connection_name = payload[:connection_name] if payload.key?(:connection_name) shard = payload[:shard] if payload.key?(:shard) if connection_name pool = ActiveRecord::Base.connection_handler.retrieve_connection_pool(connection_name, shard: shard) if pool setup_shared_connection_pool # Don't begin a transaction if we've already done so, or are not using them for this pool if !@fixture_connection_pools.include?(pool) && transactional_tests_for_pool?(pool) pool.pin_connection!(lock_threads) pool.lease_connection @fixture_connection_pools << pool end end end end end
#teardown_asynchronous_queries_session (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 180
def teardown_asynchronous_queries_session ActiveRecord::Base.asynchronous_queries_tracker.finalize_session(true) if @_async_queries_session end
#teardown_fixtures (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 162
def teardown_fixtures teardown_asynchronous_queries_session # Rollback changes if a transaction is active. if run_in_transaction? teardown_transactional_fixtures else ActiveRecord::FixtureSet.reset_cache invalidate_already_loaded_fixtures end ActiveRecord::Base.connection_handler.clear_active_connections!(:all) end
#teardown_transactional_fixtures (private)
[ GitHub ]# File 'activerecord/lib/active_record/test_fixtures.rb', line 227
def teardown_transactional_fixtures ActiveSupport::Notifications.unsubscribe(@connection_subscriber) if @connection_subscriber unless @fixture_connection_pools.map(&:unpin_connection!).all? # Something caused the transaction to be committed or rolled back # We can no longer trust the database is in a clean state. @@already_loaded_fixtures.clear end @fixture_connection_pools.clear teardown_shared_connection_pool end
#transactional_tests_for_pool?(pool) ⇒ Boolean
(private)
# File 'activerecord/lib/active_record/test_fixtures.rb', line 188
def transactional_tests_for_pool?(pool) database_transactions_config.fetch(pool.db_config.name.to_sym, use_transactional_tests) end