Class: Test::Unit::TestCase

Inherits:
Object
  • Object
show all
Includes:
ClassInheritableAttributes
Defined in:
lib/active_record/fixtures.rb

Overview

:nodoc:

Constant Summary collapse

@@already_loaded_fixtures =
{}

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.fixtures(*table_names) ⇒ Object



415
416
417
418
419
420
# File 'lib/active_record/fixtures.rb', line 415

def self.fixtures(*table_names)
  table_names = table_names.flatten
  self.fixture_table_names |= table_names
  require_fixture_classes(table_names)
  setup_fixture_accessors(table_names)
end

.method_added(method) ⇒ Object



498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
# File 'lib/active_record/fixtures.rb', line 498

def self.method_added(method)
  case method.to_s
  when 'setup'
    unless method_defined?(:setup_without_fixtures)
      alias_method :setup_without_fixtures, :setup
      define_method(:setup) do
        setup_with_fixtures
        setup_without_fixtures
      end
    end
  when 'teardown'
    unless method_defined?(:teardown_without_fixtures)
      alias_method :teardown_without_fixtures, :teardown
      define_method(:teardown) do
        teardown_without_fixtures
        teardown_with_fixtures
      end
    end
  end
end

.require_fixture_classes(table_names = nil) ⇒ Object



422
423
424
425
426
427
428
429
430
# File 'lib/active_record/fixtures.rb', line 422

def self.require_fixture_classes(table_names=nil)
  (table_names || fixture_table_names).each do |table_name| 
    begin
      require Inflector.singularize(table_name.to_s)
    rescue LoadError
      # Let's hope the developer has included it himself
    end
  end
end

.setup_fixture_accessors(table_names = nil) ⇒ Object



432
433
434
435
436
437
438
439
440
441
442
# File 'lib/active_record/fixtures.rb', line 432

def self.setup_fixture_accessors(table_names=nil)
  (table_names || fixture_table_names).each do |table_name|
    table_name = table_name.to_s.tr('.','_')
    define_method(table_name) do |fixture, *optionals|
      force_reload = optionals.shift
      @fixture_cache[table_name] ||= Hash.new
      @fixture_cache[table_name][fixture] = nil if force_reload
      @fixture_cache[table_name][fixture] ||= @loaded_fixtures[table_name][fixture.to_s].find
    end
  end
end

.uses_transaction(*methods) ⇒ Object



444
445
446
447
# File 'lib/active_record/fixtures.rb', line 444

def self.uses_transaction(*methods)
  @uses_transaction ||= []
  @uses_transaction.concat methods.map { |m| m.to_s }
end

.uses_transaction?(method) ⇒ Boolean

Returns:

  • (Boolean)


449
450
451
# File 'lib/active_record/fixtures.rb', line 449

def self.uses_transaction?(method)
  @uses_transaction && @uses_transaction.include?(method.to_s)
end

Instance Method Details

#setup_with_fixturesObject Also known as: setup



458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
# File 'lib/active_record/fixtures.rb', line 458

def setup_with_fixtures
  if pre_loaded_fixtures && !use_transactional_fixtures
    raise RuntimeError, 'pre_loaded_fixtures requires use_transactional_fixtures' 
  end

  @fixture_cache = Hash.new

  # Load fixtures once and begin transaction.
  if use_transactional_fixtures?
    if @@already_loaded_fixtures[self.class]
      @loaded_fixtures = @@already_loaded_fixtures[self.class]
    else
      load_fixtures
      @@already_loaded_fixtures[self.class] = @loaded_fixtures
    end
    ActiveRecord::Base.lock_mutex
    ActiveRecord::Base.connection.begin_db_transaction

  # Load fixtures for every test.
  else
    @@already_loaded_fixtures[self.class] = nil
    load_fixtures
  end

  # Instantiate fixtures for every test if requested.
  instantiate_fixtures if use_instantiated_fixtures
end

#teardown_with_fixturesObject Also known as: teardown



488
489
490
491
492
493
494
# File 'lib/active_record/fixtures.rb', line 488

def teardown_with_fixtures
  # Rollback changes.
  if use_transactional_fixtures?
    ActiveRecord::Base.connection.rollback_db_transaction
    ActiveRecord::Base.unlock_mutex
  end
end

#use_transactional_fixtures?Boolean

Returns:

  • (Boolean)


453
454
455
456
# File 'lib/active_record/fixtures.rb', line 453

def use_transactional_fixtures?
  use_transactional_fixtures &&
    !self.class.uses_transaction?(method_name)
end