solargraph 0.52.0 → 0.53.0

data/lib/solargraph/yard_map.rb

@@ -2,8 +2,6 @@
 
 require 'yard'
 require 'solargraph/yard_tags'
-require 'rubygems/package'
-require 'set'
 
 module Solargraph
   # The YardMap provides access to YARD documentation for the Ruby core, the
@@ -14,297 +12,7 @@ module Solargraph
 
     autoload :Cache,       'solargraph/yard_map/cache'
     autoload :Mapper,      'solargraph/yard_map/mapper'
-    autoload :RdocToYard,  'solargraph/yard_map/rdoc_to_yard'
     autoload :Helpers,     'solargraph/yard_map/helpers'
     autoload :ToMethod,    'solargraph/yard_map/to_method'
-
-    include ApiMap::BundlerMethods
-
-    # @return [Boolean]
-    attr_writer :with_dependencies
-
-    # @param required [Array<String>, Set<String>]
-    # @param directory [String]
-    # @param source_gems [Array<String>, Set<String>]
-    # @param with_dependencies [Boolean]
-    def initialize(required: [], directory: '', source_gems: [], with_dependencies: true)
-      @with_dependencies = with_dependencies
-      change required.to_set, directory, source_gems.to_set
-    end
-
-    # @return [Array<Solargraph::Pin::Base>]
-    def pins
-      @pins ||= []
-    end
-
-    def with_dependencies?
-      @with_dependencies ||= true unless @with_dependencies == false
-      @with_dependencies
-    end
-
-    # @param new_requires [Set<String>] Required paths to use for loading gems
-    # @param new_directory [String] The workspace directory
-    # @param new_source_gems [Set<String>] Gems under local development (i.e., part of the workspace)
-    # @return [Boolean]
-    def change new_requires, new_directory, new_source_gems
-      return false if new_requires == base_required && new_directory == @directory && new_source_gems == @source_gems
-      @gem_paths = {}
-      base_required.replace new_requires
-      required.replace new_requires
-      # HACK: Hardcoded YAML handling
-      required.add 'psych' if new_requires.include?('yaml')
-      @source_gems = new_source_gems
-      @directory = new_directory
-      process_requires
-      @rebindable_method_names = nil
-      @pin_class_hash = nil
-      @pin_select_cache = {}
-      pins.each { |p| p.source = :yard }
-      true
-    end
-
-    # @return [Set<String>]
-    def rebindable_method_names
-      @rebindable_method_names ||= pins_by_class(Pin::Method)
-        .select { |pin| pin.comments && pin.comments.include?('@yieldreceiver') }
-        .map(&:name)
-        .concat(['instance_eval', 'instance_exec', 'class_eval', 'class_exec', 'module_eval', 'module_exec', 'define_method'])
-        .to_set
-    end
-
-    # @return [Array<String>]
-    def yardocs
-      @yardocs ||= []
-    end
-
-    # @return [Set<String>]
-    def required
-      @required ||= Set.new
-    end
-
-    # @return [Array<String>]
-    def unresolved_requires
-      @unresolved_requires ||= []
-    end
-
-    # @return [Array<String>]
-    def missing_docs
-      @missing_docs ||= []
-    end
-
-    # @param y [String]
-    # @return [YARD::Registry]
-    def load_yardoc y
-      if y.is_a?(Array)
-        YARD::Registry.load y, true
-      else
-        YARD::Registry.load! y
-      end
-    rescue StandardError => e
-      Solargraph::Logging.logger.warn "Error loading yardoc '#{y}' #{e.class} #{e.message}"
-      yardocs.delete y
-      nil
-    end
-
-    # @param path [String]
-    # @return [Pin::Base]
-    def path_pin path
-      pins.select { |p| p.path == path }.first
-    end
-
-    # Get the location of a file referenced by a require path.
-    #
-    # @param path [String]
-    # @return [Location]
-    def require_reference path
-      # @type [Gem::Specification]
-      spec = spec_for_require(path)
-      spec.full_require_paths.each do |rp|
-        file = File.join(rp, path)
-        file = [file, file + ".rb"].find { |file| File.file?(file) }
-        next unless file
-        return Solargraph::Location.new(file, Solargraph::Range.from_to(0, 0, 0, 0))
-      end
-      nil
-    rescue Gem::LoadError
-      nil
-    end
-
-    def base_required
-      @base_required ||= Set.new
-    end
-
-    def directory
-      @directory ||= ''
-    end
-
-    private
-
-    # @return [YardMap::Cache]
-    def cache
-      @cache ||= YardMap::Cache.new
-    end
-
-    # @return [Hash{Class<Pin::Base> => Array<Pin::Base>}]
-    def pin_class_hash
-      @pin_class_hash ||= pins.to_set.classify(&:class).transform_values(&:to_a)
-    end
-
-    # @return [Array<Pin::Base>]
-    def pins_by_class klass
-      @pin_select_cache[klass] ||= pin_class_hash.select { |key, _| key <= klass }.values.flatten
-    end
-
-    # @param ns [YARD::CodeObjects::NamespaceObject]
-    # @return [Array<YARD::CodeObjects::Base>]
-    def recurse_namespace_object ns
-      result = []
-      ns.children.each do |c|
-        result.push c
-        result.concat recurse_namespace_object(c) if c.respond_to?(:children)
-      end
-      result
-    end
-
-    # @return [void]
-    def process_requires
-      @gemset = process_gemsets
-      required.merge @gemset.keys if required.include?('bundler/require')
-      pins.clear
-      unresolved_requires.clear
-      missing_docs.clear
-      environ = Convention.for_global(self)
-      done = []
-      already_errored = []
-      (required + environ.requires).each do |r|
-        next if r.nil? || r.empty? || done.include?(r)
-        done.push r
-        cached = cache.get_path_pins(r)
-        unless cached.nil?
-          pins.concat cached
-          next
-        end
-        result = pins_for_require r, already_errored
-        result.delete_if(&:nil?)
-        unless result.empty?
-          cache.set_path_pins r, result
-          pins.concat result
-        end
-      end
-      if required.include?('yaml') && required.include?('psych')
-        # HACK: Hardcoded YAML handling
-        # @todo Why can't this be handled with an override or a virtual pin?
-        pin = path_pin('YAML')
-        pin.instance_variable_set(:@return_type, ComplexType.parse('Module<Psych>')) unless pin.nil?
-      end
-      pins.concat environ.pins
-    end
-
-    def process_error(req, result, already_errored, yd = 1)
-      base = req.split('/').first
-      return if already_errored.include?(base)
-      already_errored.push base
-      if yd.nil?
-        missing_docs.push req
-      else
-        unresolved_requires.push req
-      end
-    end
-
-    def process_gemsets
-      return {} if directory.empty? || !File.file?(File.join(directory, 'Gemfile'))
-      require_from_bundle(directory)
-    end
-
-    # @param r [String]
-    def pins_for_require r, already_errored
-      result = []
-      begin
-        name = r.split('/').first.to_s
-        return [] if name.empty?
-
-        spec = spec_for_require(r)
-        return [] if @source_gems.include?(spec.name) || @gem_paths.key?(spec.name)
-        @gem_paths[spec.name] = spec.full_gem_path
-
-        yd = yardoc_file_for_spec(spec)
-        # YARD detects gems for certain libraries that do not have a yardoc
-        # but exist in the stdlib. `fileutils` is an example. Treat those
-        # cases as errors and check the stdlib yardoc.
-        if yd.nil?
-          process_error(r, result, already_errored, nil)
-          return []
-        end
-        unless yardocs.include?(yd)
-          yardocs.unshift yd
-          result.concat process_yardoc yd, spec
-          if with_dependencies?
-            (spec.dependencies - spec.development_dependencies).each do |dep|
-              result.concat pins_for_require dep.name, already_errored
-            end
-          end
-        end
-      rescue Gem::LoadError, NoYardocError
-        process_error(r, result, already_errored)
-      end
-      return result
-    end
-
-    # @param y [String, nil]
-    # @param spec [Gem::Specification, nil]
-    # @return [Array<Pin::Base>]
-    def process_yardoc y, spec = nil
-      return [] if y.nil?
-      if spec
-        cache = Solargraph::Cache.load('gems', "#{spec.name}-#{spec.version}.ser")
-        return cache if cache
-      end
-      size = Dir.glob(File.join(y, '**', '*'))
-        .map{ |f| File.size(f) }
-        .inject(:+)
-      if !size.nil? && size > 20_000_000
-        Solargraph::Logging.logger.warn "Yardoc at #{y} is too large to process (#{size} bytes)"
-        return []
-      end
-      Solargraph.logger.info "Loading #{spec.name} #{spec.version} from #{y}"
-      load_yardoc y
-      result = Mapper.new(YARD::Registry.all, spec).map
-      raise NoYardocError, "Yardoc at #{y} is empty" if result.empty?
-      if spec
-        Solargraph::Cache.save 'gems', "#{spec.name}-#{spec.version}.ser", result
-      end
-      result
-    end
-
-    # @param spec [Gem::Specification]
-    # @return [String]
-    def yardoc_file_for_spec spec
-      YARD::Registry.yardoc_file_for_gem(spec.name, "= #{spec.version}")
-    end
-
-    # @param path [String]
-    # @return [Gem::Specification]
-    def spec_for_require path
-      relatives = path.split('/')
-      spec = nil
-      while spec.nil? && !relatives.empty?
-        name = relatives.join('-')
-        spec = Gem::Specification.find_by_name(name, @gemset[name])
-        relatives.pop
-      end
-      raise Gem::LoadError if spec.nil?
-
-      # Avoid loading the spec again if it's going to be skipped anyway
-      return spec if @source_gems.include?(spec.name)
-      # Avoid loading the spec again if it's already the correct version
-      if @gemset[spec.name] && spec.version != @gemset[spec.name]
-        begin
-          return Gem::Specification.find_by_name(spec.name, "= #{@gemset[spec.name]}")
-        rescue Gem::LoadError
-          Solargraph.logger.warn "Unable to load #{spec.name} #{@gemset[spec.name]} specified by workspace, using #{spec.version} instead"
-        end
-      end
-      spec
-    end
   end
 end

data/lib/solargraph/yardoc.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Solargraph
+  # Methods for caching and loading YARD documentation for gems.
+  #
+  module Yardoc
+    module_function
+
+    # Build and cache a gem's yardoc and return the path. If the cache already
+    # exists, do nothing and return the path.
+    #
+    # @param gemspec [Gem::Specification]
+    # @return [String] The path to the cached yardoc.
+    def cache(gemspec)
+      path = path_for(gemspec)
+      return path if cached?(gemspec)
+
+      Solargraph.logger.info "Caching yardoc for #{gemspec.name} #{gemspec.version}"
+      Dir.chdir gemspec.gem_dir do
+        `yardoc --db #{path} --no-output --plugin solargraph`
+      end
+      path
+    end
+
+    # True if the gem yardoc is cached.
+    #
+    # @param gemspec [Gem::Specification]
+    def cached?(gemspec)
+      yardoc = File.join(path_for(gemspec), 'complete')
+      File.exist?(yardoc)
+    end
+
+    # Get the absolute path for a cached gem yardoc.
+    #
+    # @param gemspec [Gem::Specification]
+    # @return [String]
+    def path_for(gemspec)
+      File.join(Solargraph::Cache.work_dir, 'gems', "#{gemspec.name}-#{gemspec.version}.yardoc")
+    end
+
+    # Load a gem's yardoc and return its code objects.
+    #
+    # @note This method modifies the global YARD registry.
+    #
+    # @param gemspec [Gem::Specification]
+    # @return [Array<YARD::CodeObjects::Base>]
+    def load!(gemspec)
+      YARD::Registry.load! path_for(gemspec)
+      YARD::Registry.all
+    end
+  end
+end

data/lib/solargraph.rb

@@ -2,6 +2,7 @@
 
 Encoding.default_external = 'UTF-8'
 
+require 'set'
 require 'yard-solargraph'
 require 'solargraph/yard_tags'
 require 'solargraph/version'
@@ -26,8 +27,10 @@ module Solargraph
   autoload :Source,           'solargraph/source'
   autoload :SourceMap,        'solargraph/source_map'
   autoload :ApiMap,           'solargraph/api_map'
+  autoload :Yardoc,           'solargraph/yardoc'
   autoload :YardMap,          'solargraph/yard_map'
   autoload :Pin,              'solargraph/pin'
+  autoload :DocMap,           'solargraph/doc_map'
   autoload :ServerMethods,    'solargraph/server_methods'
   autoload :LanguageServer,   'solargraph/language_server'
   autoload :Workspace,        'solargraph/workspace'
@@ -40,9 +43,9 @@ module Solargraph
   autoload :TypeChecker,      'solargraph/type_checker'
   autoload :Environ,          'solargraph/environ'
   autoload :Convention,       'solargraph/convention'
-  autoload :Documentor,       'solargraph/documentor'
   autoload :Parser,           'solargraph/parser'
   autoload :RbsMap,           'solargraph/rbs_map'
+  autoload :GemPins,          'solargraph/gem_pins'
   autoload :Cache,            'solargraph/cache'
 
   dir = File.dirname(__FILE__)

data/solargraph.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |s|
   s.metadata["changelog_uri"]   = "https://github.com/castwide/solargraph/blob/master/CHANGELOG.md"
   s.metadata["source_code_uri"] = "https://github.com/castwide/solargraph"
 
-  s.required_ruby_version = '>= 2.6'
+  s.required_ruby_version = '>= 3.0'
 
   s.add_runtime_dependency 'backport', '~> 1.2'
   s.add_runtime_dependency 'benchmark'
@@ -34,7 +34,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'observer', '~> 0.1'
   s.add_runtime_dependency 'ostruct', '~> 0.6'
   s.add_runtime_dependency 'parser', '~> 3.0'
-  s.add_runtime_dependency 'rbs', '~> 3.0'
+  s.add_runtime_dependency 'rbs', '~> 3.3'
   s.add_runtime_dependency 'reverse_markdown', '>= 2.0', '< 4'
   s.add_runtime_dependency 'rubocop', '~> 1.38'
   s.add_runtime_dependency 'thor', '~> 1.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solargraph
 version: !ruby/object:Gem::Version
-  version: 0.52.0
+  version: 0.53.0
 platform: ruby
 authors:
 - Fred Snyder
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-28 00:00:00.000000000 Z
+date: 2025-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backport
@@ -170,14 +170,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: reverse_markdown
   requirement: !ruby/object:Gem::Requirement
@@ -380,7 +380,9 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/FUNDING.yml"
+- ".github/workflows/plugins.yml"
 - ".github/workflows/rspec.yml"
+- ".github/workflows/typecheck.yml"
 - ".gitignore"
 - ".rspec"
 - ".yardopts"
@@ -394,7 +396,6 @@ files:
 - lib/.rubocop.yml
 - lib/solargraph.rb
 - lib/solargraph/api_map.rb
-- lib/solargraph/api_map/bundler_methods.rb
 - lib/solargraph/api_map/cache.rb
 - lib/solargraph/api_map/source_to_yard.rb
 - lib/solargraph/api_map/store.rb
@@ -420,8 +421,9 @@ files:
 - lib/solargraph/diagnostics/severities.rb
 - lib/solargraph/diagnostics/type_check.rb
 - lib/solargraph/diagnostics/update_errors.rb
-- lib/solargraph/documentor.rb
+- lib/solargraph/doc_map.rb
 - lib/solargraph/environ.rb
+- lib/solargraph/gem_pins.rb
 - lib/solargraph/language_server.rb
 - lib/solargraph/language_server/completion_item_kinds.rb
 - lib/solargraph/language_server/error_codes.rb
@@ -489,60 +491,33 @@ files:
 - lib/solargraph/page.rb
 - lib/solargraph/parser.rb
 - lib/solargraph/parser/comment_ripper.rb
-- lib/solargraph/parser/legacy.rb
-- lib/solargraph/parser/legacy/class_methods.rb
-- lib/solargraph/parser/legacy/flawed_builder.rb
-- lib/solargraph/parser/legacy/node_chainer.rb
-- lib/solargraph/parser/legacy/node_methods.rb
-- lib/solargraph/parser/legacy/node_processors.rb
-- lib/solargraph/parser/legacy/node_processors/alias_node.rb
-- lib/solargraph/parser/legacy/node_processors/args_node.rb
-- lib/solargraph/parser/legacy/node_processors/begin_node.rb
-- lib/solargraph/parser/legacy/node_processors/block_node.rb
-- lib/solargraph/parser/legacy/node_processors/casgn_node.rb
-- lib/solargraph/parser/legacy/node_processors/cvasgn_node.rb
-- lib/solargraph/parser/legacy/node_processors/def_node.rb
-- lib/solargraph/parser/legacy/node_processors/defs_node.rb
-- lib/solargraph/parser/legacy/node_processors/gvasgn_node.rb
-- lib/solargraph/parser/legacy/node_processors/ivasgn_node.rb
-- lib/solargraph/parser/legacy/node_processors/lvasgn_node.rb
-- lib/solargraph/parser/legacy/node_processors/namespace_node.rb
-- lib/solargraph/parser/legacy/node_processors/orasgn_node.rb
-- lib/solargraph/parser/legacy/node_processors/resbody_node.rb
-- lib/solargraph/parser/legacy/node_processors/sclass_node.rb
-- lib/solargraph/parser/legacy/node_processors/send_node.rb
-- lib/solargraph/parser/legacy/node_processors/sym_node.rb
 - lib/solargraph/parser/node_methods.rb
 - lib/solargraph/parser/node_processor.rb
 - lib/solargraph/parser/node_processor/base.rb
+- lib/solargraph/parser/parser_gem.rb
+- lib/solargraph/parser/parser_gem/class_methods.rb
+- lib/solargraph/parser/parser_gem/flawed_builder.rb
+- lib/solargraph/parser/parser_gem/node_chainer.rb
+- lib/solargraph/parser/parser_gem/node_methods.rb
+- lib/solargraph/parser/parser_gem/node_processors.rb
+- lib/solargraph/parser/parser_gem/node_processors/alias_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/args_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/begin_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/block_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/casgn_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/cvasgn_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/def_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/defs_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/gvasgn_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/ivasgn_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/lvasgn_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/namespace_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/orasgn_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/resbody_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/sclass_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/send_node.rb
+- lib/solargraph/parser/parser_gem/node_processors/sym_node.rb
 - lib/solargraph/parser/region.rb
-- lib/solargraph/parser/rubyvm.rb
-- lib/solargraph/parser/rubyvm/class_methods.rb
-- lib/solargraph/parser/rubyvm/node_chainer.rb
-- lib/solargraph/parser/rubyvm/node_methods.rb
-- lib/solargraph/parser/rubyvm/node_processors.rb
-- lib/solargraph/parser/rubyvm/node_processors/alias_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/args_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/begin_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/block_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/casgn_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/cvasgn_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/def_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/defs_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/gvasgn_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/ivasgn_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/kw_arg_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/lit_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/lvasgn_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/namespace_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/opt_arg_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/orasgn_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/resbody_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/sclass_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/scope_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/send_node.rb
-- lib/solargraph/parser/rubyvm/node_processors/sym_node.rb
-- lib/solargraph/parser/rubyvm/node_wrapper.rb
 - lib/solargraph/parser/snippet.rb
 - lib/solargraph/pin.rb
 - lib/solargraph/pin/base.rb
@@ -590,6 +565,7 @@ files:
 - lib/solargraph/source.rb
 - lib/solargraph/source/chain.rb
 - lib/solargraph/source/chain/array.rb
+- lib/solargraph/source/chain/block_symbol.rb
 - lib/solargraph/source/chain/block_variable.rb
 - lib/solargraph/source/chain/call.rb
 - lib/solargraph/source/chain/class_variable.rb
@@ -597,6 +573,7 @@ files:
 - lib/solargraph/source/chain/global_variable.rb
 - lib/solargraph/source/chain/hash.rb
 - lib/solargraph/source/chain/head.rb
+- lib/solargraph/source/chain/if.rb
 - lib/solargraph/source/chain/instance_variable.rb
 - lib/solargraph/source/chain/link.rb
 - lib/solargraph/source/chain/literal.rb
@@ -637,6 +614,7 @@ files:
 - lib/solargraph/yard_map/mapper/to_namespace.rb
 - lib/solargraph/yard_map/to_method.rb
 - lib/solargraph/yard_tags.rb
+- lib/solargraph/yardoc.rb
 - solargraph.gemspec
 homepage: https://solargraph.org
 licenses:
@@ -654,7 +632,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.6'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

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