solargraph 0.46.0 → 0.54.5

data/lib/solargraph/yard_map/core_fills.rb

@@ -1,208 +0,0 @@
-module Solargraph
-  class YardMap
-    module CoreFills
-      Override = Pin::Reference::Override
-
-      KEYWORDS = [
-        '__ENCODING__', '__LINE__', '__FILE__', 'BEGIN', 'END', 'alias', 'and',
-        'begin', 'break', 'case', 'class', 'def', 'defined?', 'do', 'else',
-        'elsif', 'end', 'ensure', 'false', 'for', 'if', 'in', 'module', 'next',
-        'nil', 'not', 'or', 'redo', 'rescue', 'retry', 'return', 'self', 'super',
-        'then', 'true', 'undef', 'unless', 'until', 'when', 'while', 'yield'
-      ].map { |k| Pin::Keyword.new(k) }
-
-      methods_with_yieldparam_subtypes = %w[
-        Array#each Array#map Array#map! Array#any? Array#all? Array#index
-        Array#keep_if Array#delete_if
-        Enumerable#each_entry Enumerable#map Enumerable#any? Enumerable#all?
-        Enumerable#select Enumerable#reject
-        Set#each
-      ]
-
-      OVERRIDES = [
-        Override.method_return('Array#concat', 'Array'),
-        Override.method_return('Array#keep_if', 'self'),
-        Override.method_return('Array#delete_if', 'self'),
-        Override.from_comment('Array#map', %(
-@overload map(&block)
-  @return [Array]
-@overload map()
-  @return [Enumerator]
-        )),
-        Override.from_comment('Array#reject', %(
-@overload reject(&block)
-  @return [self]
-@overload reject()
-  @return [Enumerator]
-        )),
-        Override.method_return('Array#reverse', 'self', delete: ['overload']),
-        Override.from_comment('Array#select', %(
-@overload select(&block)
-  @return [self]
-@overload select()
-  @return [Enumerator]
-        )),
-        Override.from_comment('Array#[]', %(
-@overload [](range)
-  @param range [Range]
-  @return [self]
-@overload [](num1, num2)
-  @param num1 [Integer]
-  @param num2 [Integer]
-  @return [self]
-@overload [](num)
-  @param num [Integer]
-  @return_single_parameter
-@return_single_parameter
-        )),
-        Override.from_comment('Array#first', %(
-@overload first(num)
-  @param num [Integer]
-  @return [self]
-@return_single_parameter
-        )),
-        Override.from_comment('Array#last', %(
-@overload last(num)
-  @param num [Integer]
-  @return [self]
-@return_single_parameter
-        )),
-        Override.method_return('Array#map', 'Array'),
-        Override.method_return('Array#uniq', 'self'),
-        Override.method_return('Array#zip', 'Array, nil'),
-
-        Override.from_comment('BasicObject#==', %(
-@param other [BasicObject]
-@return [Boolean]
-        )),
-        Override.method_return('BasicObject#initialize', 'void'),
-
-        Override.method_return('Class#new', 'self'),
-        Override.method_return('Class.new', 'Class<Object>'),
-        Override.method_return('Class#allocate', 'self'),
-        Override.method_return('Class.allocate', 'Class<Object>'),
-
-        Override.from_comment('Enumerable#detect', %(
-@overload detect(&block)
-  @return_single_parameter
-@overload detect()
-  @return [Enumerator]
-        )),
-        Override.from_comment('Enumerable#find', %(
-@overload find(&block)
-  @return_single_parameter
-@overload find()
-  @return [Enumerator]
-        )),
-        Override.method_return('Enumerable#select', 'self'),
-
-        Override.method_return('File.absolute_path', 'String'),
-        Override.method_return('File.basename', 'String'),
-        Override.method_return('File.dirname', 'String'),
-        Override.method_return('File.extname', 'String'),
-        Override.method_return('File.join', 'String'),
-        Override.method_return('File.open', 'File'),
-
-        Override.from_comment('Float#+', %(
-@param y [Numeric]
-@return [Numeric]
-        )),
-
-        Override.from_comment('Hash#[]', %(
-@return_value_parameter
-        )),
-        # @todo This override isn't robust enough. It needs to allow for
-        #   parameterized Hash types, e.g., [Hash{Symbol => String}].
-        Override.from_comment('Hash#[]=', %(
-@param_tuple
-        )),
-        Override.method_return('Hash#merge', 'Hash'),
-        Override.from_comment('Hash#store', %{
-@overload store(key, value)
-        }),
-
-        Override.from_comment('Integer#+', %(
-@param y [Numeric]
-@return [Numeric]
-        )),
-        Override.from_comment('Integer#times', %(
-@overload times(&block)
-  @return [Integer]
-@overload times()
-  @return [Enumerator]
-        )),
-
-        Override.method_return('Kernel#puts', 'nil'),
-
-        Override.from_comment('Numeric#+', %(
-@param y [Numeric]
-@return [Numeric]
-        )),
-
-        Override.method_return('Object#!', 'Boolean'),
-        Override.method_return('Object#clone', 'self', delete: [:overload]),
-        Override.method_return('Object#dup', 'self', delete: [:overload]),
-        Override.method_return('Object#freeze', 'self', delete: [:overload]),
-        Override.method_return('Object#inspect', 'String'),
-        Override.method_return('Object#taint', 'self'),
-        Override.method_return('Object#to_s', 'String'),
-        Override.method_return('Object#untaint', 'self'),
-        Override.from_comment('Object#tap', %(
-@return [self]
-@yieldparam [self]
-        )),
-
-        Override.from_comment('STDERR', %(
-@type [IO]
-        )),
-
-        Override.from_comment('STDIN', %(
-@type [IO]
-        )),
-
-        Override.from_comment('STDOUT', %(
-@type [IO]
-        )),
-
-        Override.method_return('String#freeze', 'self'),
-        Override.method_return('String#split', 'Array<String>'),
-        Override.method_return('String#lines', 'Array<String>'),
-        Override.from_comment('String#each_line', %(
-@yieldparam [String]
-        )),
-        Override.from_comment('String.new', %(
-@overload new(*)
-  @return [self]
-      ))
-      ].concat(
-        methods_with_yieldparam_subtypes.map do |path|
-          Override.from_comment(path, %(
-@yieldparam_single_parameter
-            ))
-        end
-      )
-
-      PINS = [
-        # HACK: Extending Hash is not accurate to the implementation, but
-        # accurate enough to the behavior
-        Pin::Reference::Extend.new(closure: Pin::Namespace.new(name: 'ENV'), name: 'Hash'),
-        Pin::Reference::Superclass.new(closure: Pin::Namespace.new(name: 'File'), name: 'IO'),
-        Pin::Reference::Superclass.new(closure: Pin::Namespace.new(name: 'Integer'), name: 'Numeric'),
-        Pin::Reference::Superclass.new(closure: Pin::Namespace.new(name: 'Float'), name: 'Numeric')
-      ].concat(
-        # HACK: Add Errno exception classes
-        begin
-          errno = Solargraph::Pin::Namespace.new(name: 'Errno')
-          result = []
-          Errno.constants.each do |const|
-            result.push Solargraph::Pin::Namespace.new(type: :class, name: const.to_s, closure: errno)
-            result.push Solargraph::Pin::Reference::Superclass.new(closure: result.last, name: 'SystemCallError')
-          end
-          result
-        end
-      )
-
-      ALL = KEYWORDS + PINS + OVERRIDES
-    end
-  end
-end

data/lib/solargraph/yard_map/core_gen.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-require 'fileutils'
-require 'tmpdir'
-require 'pathname'
-require 'rubygems/package'
-require 'shellwords'
-
-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 -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.
-        #
-        # This method is designed to generate the directory architecture that
-        # YardMap core docs expect.
-        #
-        # @param ruby_dir [String] The Ruby source directory
-        # @param ver_name [String, nil] The version name
-        # @param dest_dir [String] The destination directory
-        # @return [void]
-        def generate_gzip ruby_dir, ver_name = nil, dest_dir = Dir.pwd
-          Dir.mktmpdir do |tmp|
-            base_name = ver_name || begin
-              match = ruby_dir.match(/\d+\.\d+\.\d+$/)
-              raise "Unable to determine version name from #{ruby_dir}" if match.nil?
-              match[0]
-            end
-            path_name = Pathname.new(tmp).join(base_name).to_s
-            generate_docs ruby_dir, path_name
-            gzip path_name, Pathname.new(dest_dir).join("#{base_name}.tar.gz").to_s
-          end
-        end
-
-        private
-
-        # @param dir [String] The directory to compress
-        # @param dst [String] The destination file
-        def gzip dir, dst
-          File.open(dst, 'wb') do |file|
-            Zlib::GzipWriter.wrap(file) do |gzip|
-              Gem::Package::TarWriter.new(gzip) do |tar|
-                Dir["#{dir}/**/*"].each do |filename|
-                  next if File.directory?(filename)
-                  relname = File.join(File.basename(dir), filename[dir.length+1..-1])
-                  tar.add_file_simple(relname, 0o644, File.size(filename)) do |io|
-                    io.write File.read_binary(filename)
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/yard_map/rdoc_to_yard.rb

@@ -1,140 +0,0 @@
-# frozen_string_literal: true
-
-require 'rdoc'
-require 'rdoc/rdoc'
-require 'tmpdir'
-require 'fileutils'
-
-module Solargraph
-  class YardMap
-    module RdocToYard
-      extend ApiMap::SourceToYard
-
-      # @param spec [Gem::Specification]
-      # @param cache_dir [String]
-      # @return [void]
-      def self.run spec, cache_dir: nil
-        Dir.mktmpdir do |tmpdir|
-          rdir = File.join(tmpdir, 'sg_tmp_rdoc')
-          FileUtils.cp_r Dir.glob(File.join(spec.full_gem_path, '*')), tmpdir
-          Dir.chdir tmpdir do
-            pins = []
-            pins.push Solargraph::Pin::ROOT_PIN
-            name_hash = {}
-
-            argv = ['-q', '-r', '-N', '-o', rdir]
-            spec.load_paths.each do |path|
-              argv.concat ['-i', path]
-            end
-            rdoc = RDoc::RDoc.new
-            rdoc.document argv
-            # @type [RDoc::Store]
-            store = rdoc.store
-            store.path = rdir
-            store.cache[:modules].each do |mod|
-              # @type [RDoc::NormalClass]
-              mod = store.find_class_or_module(mod)
-              closure = pins.select { |pin| pin.path == mod.full_name.split('::')[0..-2].join('::') }.first || pins.first
-              namepin = Solargraph::Pin::Namespace.new(
-                type: (mod.module? ? :module : :class),
-                name: mod.name,
-                comments: commentary(mod.comment),
-                closure: closure,
-                location: locate(mod)
-              )
-              mod.parse(mod.comment_location)
-              # @param inc [RDoc::Include]
-              mod.includes.each do |inc|
-                pins.push Solargraph::Pin::Reference::Include.new(
-                  location: locate(inc),
-                  name: inc.name,
-                  closure: namepin
-                )
-              end
-              # @param ext [RDoc::Extend]
-              mod.extends.each do |ext|
-                pins.push Solargraph::Pin::Reference::Extend.new(
-                  location: locate(ext),
-                  name: ext.name,
-                  closure: namepin
-                )
-              end
-              pins.push namepin
-              name_hash[mod.full_name] = namepin
-              # @param met [RDoc::AnyMethod]
-              mod.each_method do |met|
-                pin = Solargraph::SourceMap.load_string("def Object.tmp#{met.param_seq};end").first_pin('Object.tmp') || Solargraph::Pin::Method.new
-                pins.push Solargraph::Pin::Method.new(
-                  name: met.name,
-                  closure: namepin,
-                  comments: commentary(met.comment),
-                  scope: met.type.to_sym,
-                  parameters: pin.parameters,
-                  visibility: met.visibility,
-                  location: locate(met)
-                )
-              end
-              # @param const [RDoc::Constant]
-              mod.each_constant do |const|
-                pins.push Solargraph::Pin::Constant.new(
-                  name: const.name,
-                  closure: namepin,
-                  comments: commentary(const.comment),
-                  location: locate(const)
-                )
-              end
-            end
-            mapstore = Solargraph::ApiMap::Store.new(pins)
-            rake_yard(mapstore)
-            YARD::Registry.clear
-            code_object_map.values.each do |co|
-              YARD::Registry.register(co)
-            end
-            cache_dir ||= File.join(Solargraph::YardMap::CoreDocs.cache_dir, 'gems', "#{spec.name}-#{spec.version}", "yardoc")
-            FileUtils.remove_entry_secure cache_dir if File.exist?(cache_dir)
-            FileUtils.mkdir_p cache_dir
-            # @todo Should merge be true?
-            YARD::Registry.save true, cache_dir
-            # Clear the serialized cache if it exists
-            FileUtils.safe_unlink File.join(CoreDocs.cache_dir, 'gems', "#{spec.name}-#{spec.version}.ser")
-          end
-        end
-      end
-
-      def self.base_name mod
-        mod.full_name.split('::')[0..-2].join('::')
-      end
-
-      # @param cmnt [RDoc::Comment]
-      # @return [String]
-      def self.commentary cmnt
-        return cmnt if cmnt.is_a?(String)
-        return cmnt.text if cmnt.is_a?(RDoc::Comment)
-        result = []
-        cmnt.parts.each do |part|
-          result.push RDoc::Markup::ToHtml.new({}).to_html(part.text) if part.respond_to?(:text)
-        end
-        result.join("\n\n")
-      end
-
-      # @param obj [RDoc::Context]
-      def self.locate obj
-        # @todo line is always nil for some reason
-        file, line = find_file(obj)
-        return nil if file.nil?
-        Location.new(
-          file,
-          Range.from_to(line || 1, 0, line || 1, 0)
-        )
-      end
-
-      def self.find_file obj
-        if obj.respond_to?(:in_files) && !obj.in_files.empty?
-          [obj.in_files.first.to_s.sub(/^file /, ''), obj.line]
-        else
-          [obj.file, obj.line]
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/yard_map/stdlib_fills.rb

@@ -1,43 +0,0 @@
-module Solargraph
-  class YardMap
-    module StdlibFills
-      Override = Pin::Reference::Override
-
-      LIBS = {
-        'benchmark' => [
-          Override.method_return('Benchmark.measure', 'Benchmark::Tms')
-        ],
-
-        'pathname' => [
-          Override.method_return('Pathname#join', 'Pathname'),
-          Override.method_return('Pathname#basename', 'Pathname'),
-          Override.method_return('Pathname#dirname', 'Pathname'),
-          Override.method_return('Pathname#cleanpath', 'Pathname'),
-          Override.method_return('Pathname#children', 'Array<Pathname>'),
-          Override.method_return('Pathname#entries', 'Array<Pathname>')
-        ],
-
-        'set' => [
-          Override.method_return('Enumerable#to_set', 'Set'),
-          Override.method_return('Set#add', 'self'),
-          Override.method_return('Set#add?', 'self, nil'),
-          Override.method_return('Set#classify', 'Hash'),
-          Override.from_comment('Set#each', '@yieldparam_single_parameter'),
-        ],
-
-        'tempfile' => [
-          Override.from_comment('Tempfile.open', %(
-@yieldparam [Tempfile]
-@return [Tempfile]
-          ))
-        ]
-      }.freeze
-
-      # @param path [String]
-      # @return [Array<Pin::Reference::Override>]
-      def self.get path
-        LIBS[path] || []
-      end
-    end
-  end
-end

data/lib/yard-solargraph.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require 'yard'
-
-# Change YARD log IO to avoid sending unexpected messages to STDOUT
-YARD::Logger.instance.io = File.new(File::NULL, 'w')
-
-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)
-# Define a @yieldpublic tag for documenting block domains
-YARD::Tags::Library.define_tag("Yieldpublic", :yieldpublic, :with_types)
-# Define a @return_single_parameter tag for returning e.g. Array parameters
-YARD::Tags::Library.define_tag('ReturnSingleParameter', :return_single_parameter)
-# Define a @yieldparam_single_parameter tag for yielding e.g. Array parameters
-YARD::Tags::Library.define_tag('YieldparamSingleParameter', :yieldparam_single_parameter)
-# Define a @return_value_parameter tag for returning e.g. Hash values
-YARD::Tags::Library.define_tag('ReturnValueParameter', :return_value_parameter)
-# Define a @param_tuple tag for e.g. Hash#[]= parameters
-YARD::Tags::Library.define_tag('ParamTuple', :param_tuple)
-# Define a @!domain directive for documenting DSLs
-YARD::Tags::Library.define_directive("domain", :with_types, Solargraph::DomainDirective)
-# Define an @!override directive for overriding method tags
-YARD::Tags::Library.define_directive("override", :with_name, Solargraph::DomainDirective)