aboutsummaryrefslogtreecommitdiffstats
path: root/activesupport/lib/active_support/core_ext/module/introspection.rb
blob: 8beaff4b82c484d30ba3743b15b19814935aaafe (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
module ActiveSupport
  module CoreExtensions
    module Module
      # Returns the name of the module containing this one.
      #
      #   p M::N.parent_name # => "M"
      def parent_name
        unless defined? @parent_name
          @parent_name = name =~ /::[^:]+\Z/ ? $`.freeze : nil
        end
        @parent_name
      end

      # Returns the module which contains this one according to its name.
      #
      #   module M
      #     module N
      #     end
      #   end
      #   X = M::N
      #
      #   p M::N.parent # => M
      #   p X.parent    # => M
      #
      # The parent of top-level and anonymous modules is Object.
      #
      #   p M.parent          # => Object
      #   p Module.new.parent # => Object
      #
      def parent
        parent_name ? parent_name.constantize : Object
      end

      # Returns all the parents of this module according to its name, ordered from
      # nested outwards. The receiver is not contained within the result.
      #
      #   module M
      #     module N
      #     end
      #   end
      #   X = M::N
      #
      #   p M.parents    # => [Object]
      #   p M::N.parents # => [M, Object]
      #   p X.parents    # => [M, Object]
      #
      def parents
        parents = []
        if parent_name
          parts = parent_name.split('::')
          until parts.empty?
            parents << (parts * '::').constantize
            parts.pop
          end
        end
        parents << Object unless parents.include? Object
        parents
      end

      if RUBY_VERSION < '1.9'
        # Returns the constants that have been defined locally by this object and
        # not in an ancestor. This method is exact if running under Ruby 1.9. In
        # previous versions it may miss some constants if their definition in some
        # ancestor is identical to their definition in the receiver.
        def local_constants
          inherited = {}

          ancestors.each do |anc|
            next if anc == self
            anc.constants.each { |const| inherited[const] = anc.const_get(const) }
          end

          constants.select do |const|
            !inherited.key?(const) || inherited[const].object_id != const_get(const).object_id
          end
        end
      else
        def local_constants #:nodoc:
          constants(false)
        end
      end

      # Returns the names of the constants defined locally rather than the
      # constants themselves. See <tt>local_constants</tt>.
      def local_constant_names
        local_constants.map { |c| c.to_s }
      end
    end
  end
end