Add #namespace and #fully_qualified_namespaces to RDoc::ClassModule

Author: unasuke

lib/rdoc/code_object/class_module.rb

@@ -295,6 +295,25 @@ def full_name
                    end
   end
 
+  ##
+  # Return array of full_name splitted by +::+.
+
+  def namespaces
+    @namespaces ||= full_name.split("::").reject(&:empty?)
+  end
+
+  ##
+  # Return array of fully qualified namespaces.
+  #
+  # For example, if full_name is +A::B::C+, this method returns <code>["A", "A::B", "A::B::C"]</code>
+
+  def fully_qualified_namespaces
+    return namespaces if namespaces.length < 2
+    @fqns ||= namespaces.map.with_index do |_, i|
+      namespaces[0..i].join("::")
+    end
+  end
+
   ##
   # TODO: filter included items by #display?
 

test/rdoc/test_rdoc_class_module.rb

@@ -1526,6 +1526,28 @@ def test_update_extends_with_colons
     assert_equal [a, c], @c1.extends
   end
 
+  def test_namespaces
+    cm1 = RDoc::ClassModule.new "A"
+    assert_equal ["A"], cm1.namespaces
+
+    cm2 = RDoc::ClassModule.new "A::B"
+    assert_equal ["A", "B"], cm2.namespaces
+
+    cm3 = RDoc::ClassModule.new "::A::B::C"
+    assert_equal ["A", "B", "C"], cm3.namespaces
+  end
+
+  def test_fully_qualified_namespaces
+    cm1 = RDoc::ClassModule.new "A"
+    assert_equal ["A"], cm1.fully_qualified_namespaces
+
+    cm2 = RDoc::ClassModule.new "A::B"
+    assert_equal ["A", "A::B"], cm2.fully_qualified_namespaces
+
+    cm3 = RDoc::ClassModule.new "::A::B::C"
+    assert_equal ["A", "A::B", "A::B::C"], cm3.fully_qualified_namespaces
+  end
+
   class TestRDocClassModuleMixins < XrefTestCase
     def setup
       super