Adds documentation resolve to method completion (#55)

spec/fixtures/completion/tree.cr

@@ -6,6 +6,7 @@ class Node
   def initialize(@value : Char)
   end
 
+  # Adds a node to the tree
   def add(x)
     if x < @value
       if left = @left

spec/scry/completion_resolver_spec.cr

@@ -12,5 +12,16 @@ module Scry
       doc = results.documentation.as(MarkupContent)
       doc.value.should eq("```crystal\n# taken from https://raw.githubusercontent.com/crystal-lang/crystal/master/samples/tree.cr\nclass Node\n  @left : self?\n  @right : self?\n\n```")
     end
+
+    it "handles method completions" do
+      tree_path = File.expand_path("spec/fixtures/completion/tree.cr")
+      context = MethodCallContextData.new(tree_path, ":10:3")
+      completion_item = CompletionItem.new(label = "mock", kind = CompletionItemKind::Text, detail = "mock detail", data = context, documentation = nil)
+      completion_resolver = CompletionResolver.new(1, completion_item)
+
+      results = completion_resolver.run.as(CompletionItem)
+      doc = results.documentation.as(MarkupContent)
+      doc.value.should eq(" Adds a node to the tree")
+    end
   end
 end

src/scry/completion/method_call_context.cr

@@ -54,8 +54,10 @@ module Scry::Completion
 
     def to_completion_items(results : Array(MethodDBEntry))
       results.map do |res|
-        label = res.name
-        CompletionItem.new(label, CompletionItemKind::Method, label, nil)
+        CompletionItem.new(res.name,
+                           CompletionItemKind::Method,
+                           "#{res.name}#{res.signature}",
+                           MethodCallContextData.new(res.file_path, res.location))
       end
     end
   end

src/scry/completion/method_db.cr

@@ -36,8 +36,10 @@ module Scry::Completion
   struct MethodDBEntry
     property name : String
     property signature : String
+    property file_path : String
+    property location : String
 
-    def initialize(@name, @signature)
+    def initialize(@name, @signature, @file_path, @location)
     end
   end
 
@@ -60,7 +62,7 @@ module Scry::Completion
         method_receiver = node.receiver ? "#{@class_queue.last}.class" : @class_queue.last
       end
       signature = "(#{node.args.map(&.to_s).join(", ")}) : #{return_type || node.return_type.to_s}"
-      @classes[method_receiver] << MethodDBEntry.new(name, signature)
+      @classes[method_receiver] << MethodDBEntry.new(name, signature, @file, node.location.to_s)
       false
     end
 

src/scry/completion_resolver.cr

@@ -11,6 +11,12 @@ module Scry
         doc = file.each_line.first(5).join("\n")
         @completionItem.documentation = MarkupContent.new("markdown", "```crystal\n#{doc}\n```")
         @completionItem
+      when MethodCallContextData
+        file = File.new data.path
+        line = data.location.not_nil!.split(":")[1].to_i
+        lines = file.each_line.first(line-1).to_a.reverse.take_while(&.match /^\s*#/).map{|e| e.gsub(/^\s*#/, "") }.reverse.join("\n")
+        @completionItem.documentation =  MarkupContent.new("markdown",  lines)
+        @completionItem
       else
         @completionItem
       end

src/scry/protocol/completion_item.cr

@@ -52,8 +52,18 @@ module Scry
       @require_module_context = true
     end
   end
+  struct MethodCallContextData
+    JSON.mapping({
+      method_completion_context: Bool,
+      path: String,
+      location: String
+    })
+    def initialize(@path, @location)
+      @method_completion_context = true
+    end
+  end
 
-  alias CompletionItemData = RequireModuleContextData | Nil
+  alias CompletionItemData = RequireModuleContextData | MethodCallContextData
 
   struct CompletionItem
     JSON.mapping({