solargraph 0.52.0 → 0.53.4

data/lib/solargraph/api_map/bundler_methods.rb

@@ -1,22 +0,0 @@
-require 'bundler'
-require 'shellwords'
-
-module Solargraph
-  class ApiMap
-    module BundlerMethods
-      module_function
-
-      # @param directory [String]
-      # @return [Hash]
-      def require_from_bundle directory
-        begin
-          Solargraph.logger.info "Loading gems for bundler/require"
-          Documentor.specs_from_bundle(directory)
-        rescue BundleNotFoundError => e
-          Solargraph.logger.warn e.message
-          {}
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/documentor.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler'
-require 'json'
-require 'open3'
-require 'shellwords'
-require 'yard'
-require 'fileutils'
-
-module Solargraph
-  class Documentor
-    RDOC_GEMS = %w[
-      actioncable actionmailbox actionmailer actionpack actiontext actionview
-      activejob activemodel activerecord activestorage activesupport railties
-    ]
-
-    def initialize directory, rebuild: false, out: File.new(File::NULL, 'w')
-      @directory = directory
-      @rebuild = rebuild
-      @out = out
-    end
-
-    # @return [Boolean] True if all specs were found and documented.
-    def document
-      failures = 0
-      Documentor.specs_from_bundle(@directory).each_pair do |name, version|
-        yd = YARD::Registry.yardoc_file_for_gem(name, "= #{version}")
-        if !yd || @rebuild
-          FileUtils.safe_unlink File.join(YardMap::CoreDocs.cache_dir, 'gems', "#{name}-#{version}.ser")
-          @out.puts "Documenting #{name} #{version}"
-          `yard gems #{name} #{version} #{@rebuild ? '--rebuild' : ''}`
-          yd = YARD::Registry.yardoc_file_for_gem(name, "= #{version}")
-          # HACK: Ignore errors documenting bundler
-          if !yd && name != 'bundler'
-            @out.puts "#{name} #{version} YARD documentation failed"
-            failures += 1
-          end
-        end
-        if yd && RDOC_GEMS.include?(name)
-          cache = File.join(Solargraph::YardMap::CoreDocs.cache_dir, 'gems', "#{name}-#{version}", 'yardoc')
-          if !File.exist?(cache) || @rebuild
-            @out.puts "Caching custom documentation for #{name} #{version}"
-            spec = Gem::Specification.find_by_name(name, "= #{version}")
-            Solargraph::YardMap::RdocToYard.run(spec)
-          end
-        end
-      end
-      if failures > 0
-        @out.puts "#{failures} gem#{failures == 1 ? '' : 's'} could not be documented. You might need to run `bundle install`."
-      end
-      failures == 0
-    rescue Solargraph::BundleNotFoundError => e
-      @out.puts "[#{e.class}] #{e.message}"
-      @out.puts "No bundled gems are available in #{@directory}"
-      false
-    end
-
-    # @param directory [String]
-    # @return [Hash{String => BasicObject}]
-    def self.specs_from_bundle directory
-      Solargraph.with_clean_env do
-        cmd = [
-          'ruby', '-e',
-          "require 'bundler'; require 'json'; Dir.chdir('#{directory}') { puts Bundler.definition.specs_for([:default]).map { |spec| [spec.name, spec.version] }.to_h.to_json }"
-        ]
-        o, e, s = Open3.capture3(*cmd)
-        if s.success?
-          o && !o.empty? ? JSON.parse(o.split("\n").last) : {}
-        else
-          Solargraph.logger.warn e
-          raise BundleNotFoundError, "Failed to load gems from bundle at #{directory}"
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/parser/legacy/node_processors/alias_node.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Solargraph
-  module Parser
-    module Legacy
-      module NodeProcessors
-        class AliasNode < Parser::NodeProcessor::Base
-          def process
-            loc = get_node_location(node)
-            pins.push Solargraph::Pin::MethodAlias.new(
-              location: loc,
-              closure: region.closure,
-              name: node.children[0].children[0].to_s,
-              original: node.children[1].children[0].to_s,
-              scope: region.scope || :instance
-            )
-            process_children
-          end
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/parser/legacy/node_processors/begin_node.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Solargraph
-  module Parser
-    module Legacy
-      module NodeProcessors
-        class BeginNode < Parser::NodeProcessor::Base
-          def process
-            process_children
-          end
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/parser/legacy/node_processors/sym_node.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module Solargraph
-  module Parser
-    module Legacy
-      module NodeProcessors
-        class SymNode < Parser::NodeProcessor::Base
-          def process
-            pins.push Solargraph::Pin::Symbol.new(
-              get_node_location(node),
-              ":#{node.children[0]}"
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/parser/legacy/node_processors.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-require 'solargraph/parser/node_processor'
-
-module Solargraph
-  module Parser
-    module Legacy
-      module NodeProcessors
-        autoload :BeginNode,     'solargraph/parser/legacy/node_processors/begin_node'
-        autoload :DefNode,       'solargraph/parser/legacy/node_processors/def_node'
-        autoload :DefsNode,      'solargraph/parser/legacy/node_processors/defs_node'
-        autoload :SendNode,      'solargraph/parser/legacy/node_processors/send_node'
-        autoload :NamespaceNode, 'solargraph/parser/legacy/node_processors/namespace_node'
-        autoload :SclassNode,    'solargraph/parser/legacy/node_processors/sclass_node'
-        autoload :ModuleNode,    'solargraph/parser/legacy/node_processors/module_node'
-        autoload :IvasgnNode,    'solargraph/parser/legacy/node_processors/ivasgn_node'
-        autoload :CvasgnNode,    'solargraph/parser/legacy/node_processors/cvasgn_node'
-        autoload :LvasgnNode,    'solargraph/parser/legacy/node_processors/lvasgn_node'
-        autoload :GvasgnNode,    'solargraph/parser/legacy/node_processors/gvasgn_node'
-        autoload :CasgnNode,     'solargraph/parser/legacy/node_processors/casgn_node'
-        autoload :AliasNode,     'solargraph/parser/legacy/node_processors/alias_node'
-        autoload :ArgsNode,      'solargraph/parser/legacy/node_processors/args_node'
-        autoload :BlockNode,     'solargraph/parser/legacy/node_processors/block_node'
-        autoload :OrasgnNode,    'solargraph/parser/legacy/node_processors/orasgn_node'
-        autoload :SymNode,       'solargraph/parser/legacy/node_processors/sym_node'
-        autoload :ResbodyNode,   'solargraph/parser/legacy/node_processors/resbody_node'
-      end
-    end
-
-    module NodeProcessor
-      register :source,       Legacy::NodeProcessors::BeginNode
-      register :begin,        Legacy::NodeProcessors::BeginNode
-      register :kwbegin,      Legacy::NodeProcessors::BeginNode
-      register :rescue,       Legacy::NodeProcessors::BeginNode
-      register :resbody,      Legacy::NodeProcessors::ResbodyNode
-      register :def,          Legacy::NodeProcessors::DefNode
-      register :defs,         Legacy::NodeProcessors::DefsNode
-      register :send,         Legacy::NodeProcessors::SendNode
-      register :class,        Legacy::NodeProcessors::NamespaceNode
-      register :module,       Legacy::NodeProcessors::NamespaceNode
-      register :sclass,       Legacy::NodeProcessors::SclassNode
-      register :ivasgn,       Legacy::NodeProcessors::IvasgnNode
-      register :cvasgn,       Legacy::NodeProcessors::CvasgnNode
-      register :lvasgn,       Legacy::NodeProcessors::LvasgnNode
-      register :gvasgn,       Legacy::NodeProcessors::GvasgnNode
-      register :casgn,        Legacy::NodeProcessors::CasgnNode
-      register :alias,        Legacy::NodeProcessors::AliasNode
-      register :args,         Legacy::NodeProcessors::ArgsNode
-      register :forward_args, Legacy::NodeProcessors::ArgsNode
-      register :block,        Legacy::NodeProcessors::BlockNode
-      register :or_asgn,      Legacy::NodeProcessors::OrasgnNode
-      register :sym,          Legacy::NodeProcessors::SymNode
-    end
-  end
-end

data/lib/solargraph/parser/legacy.rb

@@ -1,12 +0,0 @@
-module Solargraph
-  module Parser
-    module Legacy
-      autoload :FlawedBuilder, 'solargraph/parser/legacy/flawed_builder'
-      autoload :ClassMethods, 'solargraph/parser/legacy/class_methods'
-      autoload :NodeMethods, 'solargraph/parser/legacy/node_methods'
-      autoload :NodeChainer, 'solargraph/parser/legacy/node_chainer'
-    end
-  end
-end
-
-require 'solargraph/parser/legacy/node_processors'

data/lib/solargraph/parser/rubyvm/class_methods.rb

@@ -1,151 +0,0 @@
-require 'solargraph/parser/rubyvm/node_processors'
-require 'solargraph/parser/rubyvm/node_wrapper'
-
-module Solargraph
-  module Parser
-    module Rubyvm
-      module ClassMethods
-        # @param code [String]
-        # @param filename [String, nil]
-        # @return [Array(Parser::AST::Node, Array<Parser::Source::Comment>)]
-        def parse_with_comments code, filename = nil
-          node = RubyVM::AbstractSyntaxTree.parse(code).children[2]
-          node &&= RubyVM::AbstractSyntaxTree::NodeWrapper.from(node, code.lines)
-          comments = CommentRipper.new(code).parse
-          [node, comments]
-        rescue ::SyntaxError => e
-          raise Parser::SyntaxError, e.message
-        end
-
-        # @param code [String]
-        # @param filename [String, nil]
-        # @param line [Integer]
-        # @return [Parser::AST::Node]
-        def parse code, filename = nil, line = 0
-          node = RubyVM::AbstractSyntaxTree.parse(code).children[2]
-          node and RubyVM::AbstractSyntaxTree::NodeWrapper.from(node, code.lines)
-        rescue ::SyntaxError => e
-          raise Parser::SyntaxError, e.message
-        end
-
-        def map source
-          NodeProcessor.process(source.node, Region.new(source: source))
-        end
-
-        def references source, name
-          if name.end_with?("=")
-            reg = /#{Regexp.escape name[0..-2]}\s*=/
-            extract_offset = ->(code, offset) { reg.match(code, offset).offset(0) }
-          else
-            extract_offset = ->(code, offset) { [soff = code.index(name, offset), soff + name.length] }
-          end
-          inner_node_references(name, source.node).map do |n|
-            rng = Range.from_node(n)
-            offset = Position.to_offset(source.code, rng.start)
-            soff, eoff = extract_offset[source.code, offset]
-            Location.new(
-              source.filename,
-              Range.new(
-                Position.from_offset(source.code, soff),
-                Position.from_offset(source.code, eoff)
-              )
-            )
-          end
-        end
-
-        # @param name [String]
-        # @param top [AST::Node]
-        # @return [Array<AST::Node>]
-        def inner_node_references name, top
-          result = []
-          if Parser.rubyvm?
-            if Parser.is_ast_node?(top)
-              result.push top if match_rubyvm_node_to_ref(top, name)
-              top.children.each { |c| result.concat inner_node_references(name, c) }
-            end
-          else
-            if Parser.is_ast_node?(top) && top.to_s.include?(":#{name}")
-              result.push top if top.children.any? { |c| c.to_s == name }
-              top.children.each { |c| result.concat inner_node_references(name, c) }
-            end
-          end
-          result
-        end
-
-        def match_rubyvm_node_to_ref(top, name)
-          top.children.select { |c| c.is_a?(Symbol) }.any? { |c| c.to_s == name } ||
-            top.children.select { |c| c.is_a?(Array) }.any? { |c| c.include?(name.to_sym) }
-        end
-
-        def chain *args
-          NodeChainer.chain *args
-        end
-
-        def chain_string *args
-          NodeChainer.load_string *args
-        end
-
-        def process_node *args
-          Solargraph::Parser::NodeProcessor.process *args
-        end
-
-        def infer_literal_node_type node
-          NodeMethods.infer_literal_node_type node
-        end
-
-        def version
-          Ruby::VERSION
-        end
-
-        def is_ast_node? node
-          if Parser.rubyvm?
-            node.is_a?(RubyVM::AbstractSyntaxTree::Node)
-          else
-            node.is_a?(::Parser::AST::Node)
-          end
-        end
-
-        def node_range node
-          if node.nil?
-            nil
-          else
-          st = Position.new(node.first_lineno - 1, node.first_column)
-          en = Position.new(node.last_lineno - 1, node.last_column)
-          Range.new(st, en)
-          end
-        end
-
-        def recipient_node tree
-          tree.each_with_index do |node, idx|
-            return tree[idx + 1] if [:ARRAY, :ZARRAY, :LIST].include?(node.type) && tree[idx + 1] && [:FCALL, :VCALL, :CALL].include?(tree[idx + 1].type)
-          end
-          nil
-        end
-
-        def string_ranges node
-          return [] unless is_ast_node?(node)
-          result = []
-          if node.type == :STR
-            result.push Range.from_node(node)
-          elsif node.type == :DSTR
-            here = Range.from_node(node)
-            there = Range.from_node(node.children[1])
-            result.push Range.new(here.start, there&.start || here.ending)
-          end
-          node.children.each do |child|
-            result.concat string_ranges(child)
-          end
-          if node.type == :DSTR && node.children.last.nil?
-            last = node.children[-2]
-            unless last.nil?
-              rng = Range.from_node(last)
-              pos = Position.new(rng.ending.line, rng.ending.column - 1)
-              result.push Range.new(pos, pos)
-            end
-          end
-          result
-        end
-      end
-    end
-  end
-end

data/lib/solargraph/parser/rubyvm/node_chainer.rb

@@ -1,163 +0,0 @@
-# frozen_string_literal: true
-
-module Solargraph
-  module Parser
-    module Rubyvm
-      # A factory for generating chains from nodes.
-      #
-      class NodeChainer
-        include Rubyvm::NodeMethods
-
-        Chain = Source::Chain
-
-        # @param node [Parser::AST::Node]
-        # @param filename [String, nil]
-        def initialize node, filename = nil, in_block = false
-          @node = node
-          @filename = filename
-          @in_block = in_block ? 1 : 0
-        end
-
-        # @return [Source::Chain]
-        def chain
-          links = generate_links(@node)
-          Chain.new(links, @node, (Parser.is_ast_node?(@node) && @node.type == :SPLAT))
-        end
-
-        class << self
-          # @param node [Parser::AST::Node]
-          # @param filename [String, nil]
-          # @return [Source::Chain]
-          def chain node, filename = nil, in_block = false
-            NodeChainer.new(node, filename, in_block).chain
-          end
-
-          # @param code [String]
-          # @return [Source::Chain]
-          def load_string(code)
-            node = Parser.parse(code.sub(/\.$/, ''))
-            chain = NodeChainer.new(node).chain
-            chain.links.push(Chain::Link.new) if code.end_with?('.')
-            chain
-          end
-        end
-
-        private
-
-        # @param n [Parser::AST::Node]
-        # @return [Array<Chain::Link>]
-        def generate_links n
-          return [] unless Parser.is_ast_node?(n)
-          return generate_links(n.children[2]) if n.type == :SCOPE
-          return generate_links(n.children[0]) if n.type == :SPLAT
-          result = []
-          if n.type == :ITER
-            @in_block += 1
-            result.concat generate_links(n.children[0])
-            @in_block -= 1
-          elsif n.type == :CALL || n.type == :OPCALL
-            n.children[0..-3].each do |c|
-              result.concat generate_links(c)
-            end
-            result.push Chain::Call.new(n.children[-2].to_s, node_to_argchains(n.children.last), @in_block > 0 || block_passed?(n))
-          elsif n.type == :QCALL
-            n.children[0..-3].each do |c|
-              result.concat generate_links(c)
-            end
-            result.push Chain::QCall.new(n.children[-2].to_s, node_to_argchains(n.children.last), @in_block > 0 || block_passed?(n))
-          elsif n.type == :ATTRASGN
-            result.concat generate_links(n.children[0])
-            result.push Chain::Call.new(n.children[1].to_s, node_to_argchains(n.children[2]), @in_block > 0 || block_passed?(n))
-          elsif n.type == :VCALL
-            result.push Chain::Call.new(n.children[0].to_s, [], @in_block > 0 || block_passed?(n))
-          elsif n.type == :FCALL
-            result.push Chain::Call.new(n.children[0].to_s, node_to_argchains(n.children[1]), @in_block > 0 || block_passed?(n))
-          elsif n.type == :SELF
-            result.push Chain::Head.new('self')
-          elsif n.type == :ZSUPER
-            result.push Chain::ZSuper.new('super', @in_block > 0 || block_passed?(n))
-          elsif n.type == :SUPER
-            result.push Chain::Call.new('super', node_to_argchains(n.children.last), @in_block > 0 || block_passed?(n))
-          elsif [:COLON2, :COLON3, :CONST].include?(n.type)
-            const = unpack_name(n)
-            result.push Chain::Constant.new(const)
-          elsif [:LVAR, :LASGN, :DVAR].include?(n.type)
-            result.push Chain::Call.new(n.children[0].to_s)
-          elsif [:IVAR, :IASGN].include?(n.type)
-            result.push Chain::InstanceVariable.new(n.children[0].to_s)
-          elsif [:CVAR, :CVASGN].include?(n.type)
-            result.push Chain::ClassVariable.new(n.children[0].to_s)
-          elsif [:GVAR, :GASGN].include?(n.type)
-            result.push Chain::GlobalVariable.new(n.children[0].to_s)
-          elsif n.type == :OP_ASGN_OR
-            result.concat generate_links n.children[2]
-          elsif [:class, :module, :def, :defs].include?(n.type)
-            # @todo Undefined or what?
-            result.push Chain::UNDEFINED_CALL
-          elsif n.type == :AND
-            result.concat generate_links(n.children.last)
-          elsif n.type == :OR
-            result.push Chain::Or.new([NodeChainer.chain(n.children[0], @filename), NodeChainer.chain(n.children[1], @filename)])
-          elsif n.type == :BEGIN
-            result.concat generate_links(n.children[0])
-          elsif n.type == :BLOCK_PASS
-            result.push Chain::BlockVariable.new("&#{n.children[1].children[0].to_s}")
-          elsif n.type == :HASH
-            result.push Chain::Hash.new('::Hash', hash_is_splatted?(n))
-          elsif n.type == :ARRAY
-            chained_children = n.children[0..-2].map { |c| NodeChainer.chain(c) }
-            result.push Source::Chain::Array.new(chained_children)
-          else
-            lit = infer_literal_node_type(n)
-            if lit
-              if lit == '::Hash'
-                result.push Chain::Hash.new(lit, hash_is_splatted?(n))
-              else
-                result.push Chain::Literal.new(lit)
-              end
-            else
-              result.push Chain::Link.new
-            end
-            # result.push (lit ? Chain::Literal.new(lit) : Chain::Link.new)
-          end
-          result
-        end
-
-        def hash_is_splatted? node
-          return false unless Parser.is_ast_node?(node.children[0]) && node.children[0].type == :LIST
-          list = node.children[0].children
-          eol = list.rindex(&:nil?)
-          eol && Parser.is_ast_node?(list[eol + 1])
-        end
-
-        def block_passed? node
-          node.children.last.is_a?(RubyVM::AbstractSyntaxTree::Node) && node.children.last.type == :BLOCK_PASS
-        end
-
-        def node_to_argchains node
-          return [] unless Parser.is_ast_node?(node)
-          if [:ZARRAY, :ARRAY, :LIST].include?(node.type)
-            node.children[0..-2].map { |c| NodeChainer.chain(c) }
-          elsif node.type == :SPLAT
-            [NodeChainer.chain(node)]
-          elsif node.type == :ARGSPUSH
-            result = node_to_argchains(node.children[0])
-            result.push NodeChainer.chain(node.children[1]) if Parser.is_ast_node?(node.children[1])
-          elsif node.type == :ARGSCAT
-            result = node.children[0].children[0..-2].map { |c| NodeChainer.chain(c) }
-            result.push NodeChainer.chain(node.children[1])
-            # @todo Smelly instance variable access
-            result.last.instance_variable_set(:@splat, true)
-            result
-          elsif node.type == :BLOCK_PASS
-            result = node_to_argchains(node.children[0])
-            result.push Chain.new([Chain::BlockVariable.new("&#{node.children[1].children[0].to_s}")])
-            result
-          else
-            []
-          end
-        end
-      end
-    end
-  end
-end