Contents

# frozen_string_literal: true

module ActiveSupport
  # This module provides an internal implementation to track descendants
  # which is faster than iterating through ObjectSpace.
  module DescendantsTracker
    @@direct_descendants = {}

    class << self
      def direct_descendants(klass)
        @@direct_descendants[klass] || []
      end

      def descendants(klass)
        arr = []
        accumulate_descendants(klass, arr)
        arr
      end

      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

      # This is the only method that is not thread safe, but is only ever called
      # during the eager loading phase.
      def store_inherited(klass, descendant)
        (@@direct_descendants[klass] ||= []) << descendant
      end

      private
      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
    end

    def inherited(base)
      DescendantsTracker.store_inherited(self, base)
      super
    end

    def direct_descendants
      DescendantsTracker.direct_descendants(self)
    end

    def descendants
      DescendantsTracker.descendants(self)
    end
  end
end

Version data entries

49 entries across 49 versions & 8 rubygems

Version	Path
activesupport-5.2.8.1	lib/active_support/descendants_tracker.rb
activesupport-5.2.8	lib/active_support/descendants_tracker.rb
activesupport-5.2.7.1	lib/active_support/descendants_tracker.rb
activesupport-5.2.7	lib/active_support/descendants_tracker.rb
activesupport-5.2.6.3	lib/active_support/descendants_tracker.rb
activesupport-5.2.6.2	lib/active_support/descendants_tracker.rb
activesupport-5.2.6.1	lib/active_support/descendants_tracker.rb
activesupport-5.2.6	lib/active_support/descendants_tracker.rb
activesupport-5.2.4.6	lib/active_support/descendants_tracker.rb
activesupport-5.2.5	lib/active_support/descendants_tracker.rb
activesupport-5.2.4.5	lib/active_support/descendants_tracker.rb
grape-extra_validators-2.0.0	vendor/bundle/ruby/2.6.0/gems/activesupport-5.2.4.1/lib/active_support/descendants_tracker.rb
activesupport-5.2.4.4	lib/active_support/descendants_tracker.rb
activesupport-5.2.4.3	lib/active_support/descendants_tracker.rb
activesupport-5.2.4.2	lib/active_support/descendants_tracker.rb
grape-extra_validators-1.0.0	vendor/bundle/ruby/2.4.0/gems/activesupport-5.2.4.1/lib/active_support/descendants_tracker.rb
activesupport-5.2.4.1	lib/active_support/descendants_tracker.rb
zuora_connect_ui-0.10.0	vendor/ruby/2.6.0/gems/activesupport-5.2.3/lib/active_support/descendants_tracker.rb
activesupport-5.2.4	lib/active_support/descendants_tracker.rb
activesupport-5.2.4.rc1	lib/active_support/descendants_tracker.rb