docrb-parser 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfa4a19237733b6e0ace1d9af8584eeeb1dc671ec3a08c000d2b5f99adfcfa90
-  data.tar.gz: 02e8182ff82e529c89c99655411a7980a56c89a511263923616468c1bbbc0f65
+  metadata.gz: b1563025b587735a14bb7360d5fbe7203c2c5eb2dfe9e1d880eb927e43062427
+  data.tar.gz: 19e9def3a41c111b3aca41485e47894737bb784e48fa64342317f2aa39bfb4b5
 SHA512:
-  metadata.gz: '048771cd5044806674962f019c76fa4fedbd5f2778ff461b3b7fd4eef77076bf93b4562283b5667318d0f68d99d7c816dd77b6a803c26fe8859f6f8358075ea7'
-  data.tar.gz: ba979ca0cb853ec2a3ef2542957f887f0b5b9e92355e380e1006bfd6883e06506b65ed49c3ed867116f7f11bfc9e32470b595a140e2917d669f5b407667e579c
+  metadata.gz: 7862efaf4bc9ef28584c9c6c0cd2ad8696f1db475d65c9d3b6998b1e82b36bdd6ae4d7ca96b0912dd00d969fab3233fb8680551246597c59c823e50828d2defc
+  data.tar.gz: a83c9f16a768bb4d910651fecd67f834be7c1f4bd310e4a1ed7142fd23b68c817f6598d6c71939dbcf77093066423a1c815d74d1d93b8f3be8bf837fc04cb7fe

data/lib/docrb/parser/class.rb

@@ -64,7 +64,10 @@ module Docrb
         return false if parent.nil? || !parent.fulfilled?
         return true if parent.resolved.id == obj.parent.id
 
-        is_inherited?(obj, parent.dereference!.inherits)
+        deref = parent.dereference!
+        return is_inherited?(obj, deref.inherits) if deref.is_a? Class
+
+        false
       end
 
       def source_of(obj)

data/lib/docrb/parser/comment_parser.rb

@@ -10,6 +10,11 @@ module Docrb
       SPACE = " "
       DASH = "-"
       COLON = ":"
+      IGNORED_ANNOTATIONS = [
+        ":nodoc:",
+        ":nocov:",
+        /^rubocop:\s?(enable|disable)/
+      ].freeze
 
       attr_accessor :objects, :current_object, :cursor, :visibility
 
@@ -17,8 +22,8 @@ module Docrb
         new(data)
           .tap(&:parse)
           .then do |parser|
-          { meta: { visibility: parser.visibility }.compact, value: parser.objects }
-        end
+            { meta: { visibility: parser.visibility }.compact, value: parser.objects }
+          end
       end
 
       def initialize(data)
@@ -28,6 +33,7 @@ module Docrb
           .split(NEWLINE)
           .map(&:rstrip)
           .map { _1.gsub(/^\s*#\s?/, "") }
+          .reject { reject_annotation? _1 }
           .join(NEWLINE)
           .each_grapheme_cluster
           .to_a
@@ -37,6 +43,16 @@ module Docrb
         @cursor = 0
       end
 
+      def reject_annotation?(value)
+        IGNORED_ANNOTATIONS.any? do |match|
+          case match
+          when Regexp then match.match? value
+          when String then value == match
+          else false
+          end
+        end
+      end
+
       def at_end? = (cursor >= @data_len)
 
       def will_end? = (cursor + 1 >= @data_len)
@@ -173,13 +189,13 @@ module Docrb
       end
 
       # rubocop:disable Layout/LineLength
-      COMMENT_METHOD_REF_REGEXP = /(?:([A-Z][a-zA-Z0-9_]*::)*([A-Z][a-zA-Z0-9_]*))?(::|\.|#)([A-Za-z_][a-zA-Z0-9_@]*[!?]?)(?:\([a-zA-Z0-9=_,\s*]+\))?/
+      COMMENT_METHOD_REF_REGEXP = /(?:((?:::)?(?:[a-z][a-z0-9_]*::)*)([a-z][a-z0-9_]*))?(::|\.|#)([a-z_][a-z0-9_@]*[!?]?)(?:\([a-z0-9:=_,\s*]+\))?/i
       # rubocop:enable Layout/LineLength
 
       def extract_method_reference(text)
         match = COMMENT_METHOD_REF_REGEXP.match(text) or return nil
         value, class_path, target, invocation, name = match.to_a
-        class_path&.gsub!(/::$/, "")
+        class_path&.gsub!(/(^::|::$)/, "")
 
         {
           start_idx: match.begin(0),

data/lib/docrb/parser/computations.rb

@@ -39,11 +39,16 @@ module Docrb
         last_found_node = resolve[:last_found_node] || parser
         if resolve[:missing_segments].empty?
           remove_from_parent!(node, parent: node.parent)
-          node.parent = resolve[:last_found_node]
-          if node.is_a? Class
-            last_found_node.classes << node
-          elsif node.is_a? Module
-            last_found_node.modules << node
+          if last_found_node.is_a? Parser
+            node.parent = nil
+            last_found_node.nodes.append(node)
+          else
+            node.parent = resolve[:last_found_node]
+            if node.is_a? Class
+              last_found_node.classes << node
+            elsif node.is_a? Module
+              last_found_node.modules << node
+            end
           end
 
           return
@@ -93,59 +98,74 @@ module Docrb
           obj[:value].transform_values! { resolve_documentation_reference(node, _1) }
           obj
         when :method_ref
-          resolve_documentation_pure_reference(node, obj)
+          resolve_method_reference(node, obj)
         when :span, :symbol
           obj
+        when :identifier
+          if obj[:value].to_sym == node.try(:name)&.to_sym
+            obj[:type] = :neutral_identifier
+          else
+            container = if node.is_a? Container
+              node
+            else
+              find_next_container(node)
+            end
+            resolved = resolve_path(container, [obj[:value].to_sym])
+            if resolved.respond_to?(:id)
+              obj[:type] = :reference
+              obj[:id] = resolved.id
+              obj[:path] = path_of(resolved)
+            else
+              obj[:type] = :unresolved_identifier
+            end
+          end
+          obj
+        when :class_path_ref
+          resolve_class_path_reference(node, obj)
         else
           puts "Unhandled documentation node #{obj[:type]}"
           obj
         end
+      end
+
+      def resolve_class_path_reference(node, ref)
+        path = (ref[:class_path].gsub(/(^::|::$)/, "").split("::") + [ref[:target]]).flatten.compact.map(&:to_sym)
+        node = find_next_container(node) unless node.is_a? Container
+        resolved = resolve_path_partial(path, node)
+
+        unless resolved[:missing_segments].empty?
+          ref[:type] = :unresolved_identifier
+          return ref
+        end
+
+        prefix = /^(::)/.match(ref[:value])&.to_a&.last
+        segments = resolved[:segment_list]
+        target = resolved[:last_found_node].all_objects.named(ref[:name].to_sym).first
+
+        if target.nil?
+          ref[:type] = :unresolved_identifier
+          return ref
+        end
 
-        # obj[:value].each do |v|
-        #   case v[:type]
-        #   when :identifier
-        #     if v[:value].to_sym == node.try(:name)&.to_sym
-        #       v[:type] = :neutral_identifier
-        #     else
-        #       resolved = resolve_path(node, [v[:value].to_sym])
-        #       if resolved.respond_to?(:id)
-        #         v[:type] = :reference
-        #         v[:id] = resolved.id
-        #         v[:path] = path_of(resolved)
-        #       else
-        #         v[:type] = :unresolved_identifier
-        #       end
-        #     end
-        #   when :reference
-        #     resolve_documentation_pure_reference(v, node)
-        #   when :block
-        #     v[:value]
-        #       .reject { [:span, :symbol].include? _1[:type] }
-        #       .each { resolve_documentation_reference(node, _1) }
-        #   when :fields
-        #     val = v[:value].values.flatten
-        #     resolve_documentation_reference(node, { value: val })
-        #   else
-        #     puts "Unhandled documentation node #{v[:type]}"
-        #   end
-        # end
+        {
+          type: :class_path_reference,
+          prefix:,
+          segments:,
+          target:
+        }
       end
 
-      def resolve_documentation_pure_reference(node, ref)
+      def resolve_method_reference(node, ref)
         return ref if ref.key? :object
 
         node = find_next_container(node) unless node.is_a? Container
         name = ref[:name].to_sym
         obj = if ref[:class_path]
-          resolve_path(ref[:class_path].split("::").map(&:to_sym), node)
+          resolve_path(node, ref[:class_path].split("::").map(&:to_sym))
         else
           node
         end
-        result = if ref[:type] == :method
-          obj.all_instance_methods.named(name).first || obj.all_class_methods.named(name).first
-        else
-          obj.all_objects.named(name).first
-        end
+        result = resolve_path(obj, [ref[:target], name].compact.map(&:to_sym))
 
         if result.nil?
           ref[:type] = :unresolved_identifier
@@ -347,6 +367,7 @@ module Docrb
         c_filter = -> { container_only ? _1.is_a?(Container) : true }
 
         found_segments = []
+        segment_list = []
         until path.empty?
           last_parent = parent
           if parent.is_a? Parser
@@ -357,6 +378,7 @@ module Docrb
             end
 
             found_segments << path.shift
+            segment_list << parent
             next
           end
 
@@ -365,14 +387,15 @@ module Docrb
             parent = last_parent
             break
           end
-
           found_segments << path.shift
+          segment_list << parent
         end
 
         {
           last_found_node: parent,
           found_segments:,
-          missing_segments: path
+          missing_segments: path,
+          segment_list:
         }
       end
 
@@ -455,8 +478,7 @@ module Docrb
           container&.all_class_methods&.named(name)&.first ||
           container&.all_class_attributes&.named(name)&.first ||
           (find_object(container.parent, name, container_only:) if container&.parent) ||
-          parser.nodes.lazy.filter { _1.is_a?(Container) && _1.name == name }.first ||
-          parser.nodes.lazy.filter { _1.is_a? Container }.first { find_object(_1, name) }
+          parser.nodes.lazy.filter { _1.is_a?(Container) && _1.name == name }.first
       end
 
       def find_next_container(obj)

data/lib/docrb/parser/container.rb

@@ -108,9 +108,9 @@ module Docrb
         case
         when parent == id
           :self
-        when @includes.filter(&:fulfilled?).any? { _1.resolved.id == id }
+        when @includes.filter(&:fulfilled?).any? { _1.resolved.id == parent }
           :included
-        when @extends.filter(&:fulfilled?).any? { _1.resolved.id == id }
+        when @extends.filter(&:fulfilled?).any? { _1.resolved.id == parent }
           :extended
         else
           :unknown

data/lib/docrb/parser/method_parameters.rb

@@ -75,6 +75,7 @@ module Docrb
           when Prism::StringNode then :string
           when Prism::IntegerNode, Prism::FloatNode then :number
           when Prism::ConstantReadNode, Prism::ConstantPathNode then :const
+          when Prism::HashNode then :hash
           else
             puts "Unhandled parameter value type #{value.class.name}"
           end

data/lib/docrb/parser/version.rb

@@ -2,6 +2,6 @@
 
 module Docrb
   class Parser
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docrb-parser
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Victor Gama