module ActiveSupport::DescendantsTracker

This module provides an internal implementation to track descendants which is faster than iterating through ObjectSpace.

Public Class Methods

clear() click to toggle source
# File lib/active_support/descendants_tracker.rb, line 18
def clear
  if defined? ActiveSupport::Dependencies
    @@direct_descendants.each do |klass, descendants|
      if ActiveSupport::Dependencies.autoloaded?(klass)
        @@direct_descendants.delete(klass)
      else
        descendants.reject! { |v| ActiveSupport::Dependencies.autoloaded?(v) }
      end
    end
  else
    @@direct_descendants.clear
  end
end
descendants(klass) click to toggle source
# File lib/active_support/descendants_tracker.rb, line 12
def descendants(klass)
  arr = []
  accumulate_descendants(klass, arr)
  arr
end
direct_descendants(klass) click to toggle source
# File lib/active_support/descendants_tracker.rb, line 8
def direct_descendants(klass)
  @@direct_descendants[klass] || []
end
store_inherited(klass, descendant) click to toggle source

This is the only method that is not thread safe, but is only ever called during the eager loading phase.

# File lib/active_support/descendants_tracker.rb, line 34
def store_inherited(klass, descendant)
  (@@direct_descendants[klass] ||= []) << descendant
end

Private Class Methods

accumulate_descendants(klass, acc) click to toggle source
# File lib/active_support/descendants_tracker.rb, line 39
def accumulate_descendants(klass, acc)
  if direct_descendants = @@direct_descendants[klass]
    acc.concat(direct_descendants)
    direct_descendants.each { |direct_descendant| accumulate_descendants(direct_descendant, acc) }
  end
end

Public Instance Methods

descendants() click to toggle source
# File lib/active_support/descendants_tracker.rb, line 56
def descendants
  DescendantsTracker.descendants(self)
end
direct_descendants() click to toggle source
# File lib/active_support/descendants_tracker.rb, line 52
def direct_descendants
  DescendantsTracker.direct_descendants(self)
end
inherited(base) click to toggle source
Calls superclass method
# File lib/active_support/descendants_tracker.rb, line 47
def inherited(base)
  DescendantsTracker.store_inherited(self, base)
  super
end