solargraph 0.30.2 → 0.31.0

data/lib/solargraph/yard_map/core_gen.rb

@@ -0,0 +1,47 @@
+require 'fileutils'
+require 'tmpdir'
+require 'pathname'
+
+module Solargraph
+  class YardMap
+    # Tools for generating core documentation.
+    #
+    module CoreGen
+      class << self
+        # Generate documentation from the specified Ruby source directory.
+        #
+        # @param ruby_dir [String] The Ruby source directory
+        # @param dest_dir [String] The destination directory for the yardocs
+        # @return [void]
+        def generate_docs ruby_dir, dest_dir
+          path_name = Pathname.new(Dir.pwd).join(dest_dir).to_s
+          FileUtils.mkdir_p path_name
+          Dir.chdir(ruby_dir) do
+            `yardoc --plugin coregen -b #{File.join(path_name, 'yardoc')} -n *.c`
+            raise 'An error occurred generating the core yardoc.' unless $?.success?
+            `yardoc -b #{File.join(path_name, 'yardoc-stdlib')} -n lib ext`
+            raise 'An error occurred generating the stdlib yardoc.' unless $?.success?
+          end
+        end
+
+        # Generate a gzip of documentation from the specified Ruby source directory.
+        #
+        # @param ruby_dir [String] The Ruby source directory
+        # @param gzip_name [String] The gzip file name
+        # @return [void]
+        def generate_gzip ruby_dir, gzip_name
+          Dir.mktmpdir do |tmp|
+            gzip_name += '.tar.gz' unless gzip_name.end_with?('.tar.gz')
+            base_name = gzip_name[0..-8]
+            path_name = Pathname.new(Dir.pwd).join(base_name).to_s
+            generate_docs ruby_dir, tmp
+            `cd #{tmp} && tar -cf #{path_name}.tar *`
+            raise 'An error occurred generating the documentation tar.' unless $?.success?
+            `gzip #{path_name}.tar`
+            raise 'An error occurred generating the documentation gzip.' unless $?.success?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yard-coregen.rb

@@ -0,0 +1,16 @@
+require 'yard'
+
+class CoreMethodHandler < YARD::Handlers::C::Base
+  MATCH = /define_filetest_function\s*\(
+			\s*"([^"]+)",
+			\s*(?:RUBY_METHOD_FUNC\(|VALUEFUNC\(|\(\w+\))?(\w+)\)?,
+			\s*(-?\w+)\s*\)/xm
+  handles MATCH
+  statement_class BodyStatement
+
+  process do
+    statement.source.scan(MATCH) do |name, func_name, _param_count|
+      handle_method("singleton_method", "rb_cFile", name, func_name)
+    end
+  end
+end

data/lib/yard-solargraph.rb

@@ -1,7 +1,16 @@
 require 'yard'
 
+module Solargraph
+  # A placeholder for the @!domain directive. It doesn't need to do anything
+  # for yardocs. It's only used for Solargraph API maps.
+  class DomainDirective < YARD::Tags::Directive
+    def call; end
+  end
+end
+
 # Define a @type tag for documenting variables
 YARD::Tags::Library.define_tag("Type", :type, :with_types_and_name)
 # Define a @yieldself tag for documenting block contexts
 YARD::Tags::Library.define_tag("Yieldself", :yieldself, :with_types)
-YARD::Tags::Library.define_directive("domain", YARD::Tags::MacroDirective)
+# Define a @!domain directive for documenting DSLs
+YARD::Tags::Library.define_directive("domain", :with_types, Solargraph::DomainDirective)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solargraph
 version: !ruby/object:Gem::Version
-  version: 0.30.2
+  version: 0.31.0
 platform: ruby
 authors:
 - Fred Snyder
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-12-31 00:00:00.000000000 Z
+date: 2019-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backport
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: htmlentities
   requirement: !ruby/object:Gem::Requirement
@@ -154,6 +154,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: jaro_winkler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -237,6 +251,7 @@ files:
 - lib/solargraph/language_server/host.rb
 - lib/solargraph/language_server/host/cataloger.rb
 - lib/solargraph/language_server/host/diagnoser.rb
+- lib/solargraph/language_server/host/dispatch.rb
 - lib/solargraph/language_server/host/sources.rb
 - lib/solargraph/language_server/message.rb
 - lib/solargraph/language_server/message/base.rb
@@ -390,6 +405,8 @@ files:
 - lib/solargraph/yard_map.rb
 - lib/solargraph/yard_map/cache.rb
 - lib/solargraph/yard_map/core_docs.rb
+- lib/solargraph/yard_map/core_gen.rb
+- lib/yard-coregen.rb
 - lib/yard-solargraph.rb
 - yardoc/2.2.2.tar.gz
 homepage: http://solargraph.org