module ActiveSupport::DescendantsTracker

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

Public Class Methods

descendants(klass) click to toggle source
# File lib/active_support/descendants_tracker.rb, line 62
def descendants(klass)
  klass.descendants
end
direct_descendants(klass) click to toggle source
# File lib/active_support/descendants_tracker.rb, line 11
      def direct_descendants(klass)
        ActiveSupport::Deprecation.warn(<<~MSG)
          ActiveSupport::DescendantsTracker.direct_descendants is deprecated and will be removed in Rails 7.1.
          Use ActiveSupport::DescendantsTracker.subclasses instead.
        MSG
        subclasses(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 138
def store_inherited(klass, descendant)
  (@@direct_descendants[klass] ||= DescendantsArray.new) << descendant
end
subclasses(klass) click to toggle source
# File lib/active_support/descendants_tracker.rb, line 58
def subclasses(klass)
  klass.subclasses
end

Private Class Methods

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

Public Instance Methods

descendants() click to toggle source
# File lib/active_support/descendants_tracker.rb, line 88
def descendants
  subclasses.concat(subclasses.flat_map(&:descendants))
end
direct_descendants() click to toggle source
# File lib/active_support/descendants_tracker.rb, line 92
      def direct_descendants
        ActiveSupport::Deprecation.warn(<<~MSG)
          ActiveSupport::DescendantsTracker#direct_descendants is deprecated and will be removed in Rails 7.1.
          Use #subclasses instead.
        MSG
        subclasses
      end
inherited(base) click to toggle source
Calls superclass method
# File lib/active_support/descendants_tracker.rb, line 153
def inherited(base)
  DescendantsTracker.store_inherited(self, base)
  super
end
subclasses() click to toggle source
Calls superclass method
# File lib/active_support/descendants_tracker.rb, line 82
def subclasses
  subclasses = super
  subclasses.reject! { |d| @@excluded_descendants[d] }
  subclasses
end