RubyGems - solargraph - Versions diffs - 0.32.1 → 0.32.2 - Mend

solargraph 0.32.1 → 0.32.2

Files changed (177) hide show

checksums.yaml +4 -4
data/.gitignore +9 -0
data/.rspec +2 -0
data/.rubocop.yml +6 -0
data/.travis.yml +25 -0
data/EXAMPLES.md +76 -0
data/Gemfile +3 -0
data/LANGUAGE_SERVER.md +51 -0
data/LICENSE +21 -0
data/OVERVIEW.md +37 -0
data/README.md +106 -0
data/Rakefile +14 -0
data/SERVER.md +95 -0
data/bin/solargraph +0 -0
data/bin/solargraph-runtime +5 -5
data/lib/solargraph.rb +54 -54
data/lib/solargraph/api_map.rb +659 -659
data/lib/solargraph/api_map/cache.rb +49 -49
data/lib/solargraph/api_map/source_to_yard.rb +67 -67
data/lib/solargraph/api_map/store.rb +201 -201
data/lib/solargraph/bundle.rb +24 -24
data/lib/solargraph/complex_type.rb +150 -150
data/lib/solargraph/complex_type/type_methods.rb +124 -124
data/lib/solargraph/complex_type/unique_type.rb +44 -44
data/lib/solargraph/core_fills.rb +37 -37
data/lib/solargraph/diagnostics.rb +52 -52
data/lib/solargraph/diagnostics/base.rb +20 -20
data/lib/solargraph/diagnostics/require_not_found.rb +28 -28
data/lib/solargraph/diagnostics/rubocop.rb +98 -98
data/lib/solargraph/diagnostics/rubocop_helpers.rb +46 -46
data/lib/solargraph/diagnostics/type_not_defined.rb +108 -108
data/lib/solargraph/diagnostics/update_errors.rb +38 -38
data/lib/solargraph/language_server/completion_item_kinds.rb +33 -33
data/lib/solargraph/language_server/error_codes.rb +18 -18
data/lib/solargraph/language_server/host.rb +684 -681
data/lib/solargraph/language_server/host/cataloger.rb +54 -79
data/lib/solargraph/language_server/host/diagnoser.rb +80 -80
data/lib/solargraph/language_server/host/dispatch.rb +112 -113
data/lib/solargraph/language_server/host/sources.rb +138 -138
data/lib/solargraph/language_server/message.rb +90 -90
data/lib/solargraph/language_server/message/base.rb +83 -83
data/lib/solargraph/language_server/message/completion_item/resolve.rb +40 -40
data/lib/solargraph/language_server/message/exit_notification.rb +11 -11
data/lib/solargraph/language_server/message/extended.rb +19 -19
data/lib/solargraph/language_server/message/extended/check_gem_version.rb +86 -86
data/lib/solargraph/language_server/message/extended/document.rb +18 -18
data/lib/solargraph/language_server/message/extended/document_gems.rb +30 -30
data/lib/solargraph/language_server/message/extended/environment.rb +20 -20
data/lib/solargraph/language_server/message/extended/search.rb +18 -18
data/lib/solargraph/language_server/message/initialize.rb +141 -141
data/lib/solargraph/language_server/message/initialized.rb +23 -23
data/lib/solargraph/language_server/message/shutdown.rb +11 -11
data/lib/solargraph/language_server/message/text_document.rb +25 -25
data/lib/solargraph/language_server/message/text_document/completion.rb +51 -51
data/lib/solargraph/language_server/message/text_document/definition.rb +18 -18
data/lib/solargraph/language_server/message/text_document/did_change.rb +13 -13
data/lib/solargraph/language_server/message/text_document/document_symbol.rb +21 -21
data/lib/solargraph/language_server/message/text_document/folding_range.rb +24 -24
data/lib/solargraph/language_server/message/text_document/formatting.rb +50 -50
data/lib/solargraph/language_server/message/text_document/hover.rb +31 -31
data/lib/solargraph/language_server/message/text_document/on_type_formatting.rb +32 -32
data/lib/solargraph/language_server/message/text_document/prepare_rename.rb +9 -9
data/lib/solargraph/language_server/message/text_document/references.rb +14 -14
data/lib/solargraph/language_server/message/text_document/rename.rb +17 -17
data/lib/solargraph/language_server/message/text_document/signature_help.rb +19 -19
data/lib/solargraph/language_server/message/workspace.rb +12 -12
data/lib/solargraph/language_server/message/workspace/did_change_configuration.rb +29 -29
data/lib/solargraph/language_server/message/workspace/did_change_watched_files.rb +29 -27
data/lib/solargraph/language_server/message/workspace/did_change_workspace_folders.rb +24 -24
data/lib/solargraph/language_server/message/workspace/workspace_symbol.rb +21 -21
data/lib/solargraph/language_server/request.rb +22 -22
data/lib/solargraph/language_server/symbol_kinds.rb +34 -34
data/lib/solargraph/language_server/transport.rb +11 -11
data/lib/solargraph/language_server/transport/adapter.rb +60 -60
data/lib/solargraph/language_server/transport/data_reader.rb +66 -66
data/lib/solargraph/language_server/uri_helpers.rb +25 -25
data/lib/solargraph/library.rb +421 -419
data/lib/solargraph/live_map.rb +126 -126
data/lib/solargraph/live_map/cache.rb +38 -38
data/lib/solargraph/location.rb +31 -31
data/lib/solargraph/logging.rb +25 -25
data/lib/solargraph/page.rb +68 -68
data/lib/solargraph/pin.rb +50 -50
data/lib/solargraph/pin/attribute.rb +41 -41
data/lib/solargraph/pin/base.rb +280 -280
data/lib/solargraph/pin/base_method.rb +76 -76
data/lib/solargraph/pin/base_variable.rb +72 -72
data/lib/solargraph/pin/block.rb +32 -32
data/lib/solargraph/pin/block_parameter.rb +103 -103
data/lib/solargraph/pin/class_variable.rb +9 -9
data/lib/solargraph/pin/constant.rb +30 -30
data/lib/solargraph/pin/conversions.rb +79 -79
data/lib/solargraph/pin/documenting.rb +41 -41
data/lib/solargraph/pin/duck_method.rb +14 -14
data/lib/solargraph/pin/global_variable.rb +9 -9
data/lib/solargraph/pin/instance_variable.rb +9 -9
data/lib/solargraph/pin/keyword.rb +17 -17
data/lib/solargraph/pin/local_variable.rb +23 -23
data/lib/solargraph/pin/localized.rb +22 -22
data/lib/solargraph/pin/method.rb +126 -126
data/lib/solargraph/pin/method_alias.rb +30 -30
data/lib/solargraph/pin/method_parameter.rb +40 -40
data/lib/solargraph/pin/namespace.rb +54 -54
data/lib/solargraph/pin/plugin/method.rb +25 -25
data/lib/solargraph/pin/proxy_type.rb +35 -35
data/lib/solargraph/pin/reference.rb +22 -22
data/lib/solargraph/pin/reference/extend.rb +11 -11
data/lib/solargraph/pin/reference/include.rb +11 -11
data/lib/solargraph/pin/reference/require.rb +15 -15
data/lib/solargraph/pin/reference/superclass.rb +11 -11
data/lib/solargraph/pin/symbol.rb +44 -44
data/lib/solargraph/pin/yard_pin.rb +10 -10
data/lib/solargraph/pin/yard_pin/constant.rb +14 -14
data/lib/solargraph/pin/yard_pin/method.rb +35 -35
data/lib/solargraph/pin/yard_pin/namespace.rb +19 -19
data/lib/solargraph/pin/yard_pin/yard_mixin.rb +14 -14
data/lib/solargraph/plugin.rb +8 -8
data/lib/solargraph/plugin/base.rb +41 -41
data/lib/solargraph/plugin/canceler.rb +11 -11
data/lib/solargraph/plugin/process.rb +172 -172
data/lib/solargraph/plugin/runtime.rb +134 -134
data/lib/solargraph/position.rb +110 -110
data/lib/solargraph/range.rb +83 -83
data/lib/solargraph/server_methods.rb +14 -14
data/lib/solargraph/shell.rb +102 -102
data/lib/solargraph/source.rb +521 -521
data/lib/solargraph/source/chain.rb +120 -120
data/lib/solargraph/source/chain/call.rb +107 -107
data/lib/solargraph/source/chain/class_variable.rb +11 -11
data/lib/solargraph/source/chain/constant.rb +30 -30
data/lib/solargraph/source/chain/global_variable.rb +11 -11
data/lib/solargraph/source/chain/head.rb +33 -33
data/lib/solargraph/source/chain/instance_variable.rb +11 -11
data/lib/solargraph/source/chain/link.rb +33 -33
data/lib/solargraph/source/chain/literal.rb +21 -21
data/lib/solargraph/source/chain/variable.rb +11 -11
data/lib/solargraph/source/change.rb +77 -77
data/lib/solargraph/source/cursor.rb +157 -157
data/lib/solargraph/source/node_chainer.rb +96 -96
data/lib/solargraph/source/node_methods.rb +225 -225
data/lib/solargraph/source/source_chainer.rb +183 -183
data/lib/solargraph/source_map.rb +169 -169
data/lib/solargraph/source_map/clip.rb +145 -145
data/lib/solargraph/source_map/completion.rb +21 -21
data/lib/solargraph/source_map/mapper.rb +149 -149
data/lib/solargraph/source_map/node_processor.rb +78 -78
data/lib/solargraph/source_map/node_processor/alias_node.rb +19 -19
data/lib/solargraph/source_map/node_processor/args_node.rb +28 -28
data/lib/solargraph/source_map/node_processor/base.rb +68 -68
data/lib/solargraph/source_map/node_processor/begin_node.rb +11 -11
data/lib/solargraph/source_map/node_processor/block_node.rb +14 -14
data/lib/solargraph/source_map/node_processor/casgn_node.rb +14 -14
data/lib/solargraph/source_map/node_processor/cvasgn_node.rb +14 -14
data/lib/solargraph/source_map/node_processor/def_node.rb +54 -54
data/lib/solargraph/source_map/node_processor/defs_node.rb +21 -21
data/lib/solargraph/source_map/node_processor/gvasgn_node.rb +12 -12
data/lib/solargraph/source_map/node_processor/ivasgn_node.rb +18 -18
data/lib/solargraph/source_map/node_processor/lvasgn_node.rb +16 -16
data/lib/solargraph/source_map/node_processor/namespace_node.rb +26 -26
data/lib/solargraph/source_map/node_processor/orasgn_node.rb +12 -12
data/lib/solargraph/source_map/node_processor/sclass_node.rb +11 -11
data/lib/solargraph/source_map/node_processor/send_node.rb +162 -162
data/lib/solargraph/source_map/node_processor/sym_node.rb +11 -11
data/lib/solargraph/source_map/region.rb +58 -58
data/lib/solargraph/version.rb +3 -3
data/lib/solargraph/views/environment.erb +53 -53
data/lib/solargraph/workspace.rb +183 -183
data/lib/solargraph/workspace/config.rb +170 -170
data/lib/solargraph/yard_map.rb +298 -298
data/lib/solargraph/yard_map/cache.rb +17 -17
data/lib/solargraph/yard_map/core_docs.rb +163 -163
data/lib/solargraph/yard_map/core_gen.rb +76 -76
data/lib/yard-coregen.rb +16 -16
data/lib/yard-solargraph.rb +18 -18
data/solargraph.gemspec +37 -0
data/travis-bundler.rb +10 -0
metadata +19 -6

data/lib/solargraph/source_map/node_processor/sym_node.rb CHANGED Viewed

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

data/lib/solargraph/source_map/region.rb CHANGED Viewed

@@ -1,58 +1,58 @@
-module Solargraph
-  class SourceMap
-    # Data used by the NodeProcessor library to track context at various
-    # locations in a source.
-    #
-    class Region
-      # @return [String]
-      attr_reader :namespace
-      # @return [Symbol]
-      attr_reader :scope
-      # @return [Symbol]
-      attr_reader :visibility
-      # @return [Solargraph::Source]
-      attr_reader :source
-      # @param source [Source]
-      # @param namespace [String]
-      # @param scope [Symbol]
-      # @param visibility [Symbol]
-      def initialize source: Solargraph::Source.load_string(''), namespace: '',
-                     scope: :instance, visibility: :public
-        @source = source
-        @namespace = namespace
-        @scope = scope
-        @visibility = visibility
-      end
-      # @return [String]
-      def filename
-        source.filename
-      end
-      # Generate a new Region with the provided attribute changes.
-      #
-      # @param namespace [String, nil]
-      # @param scope [Symbol, nil]
-      # @param visibility [Symbol, nil]
-      # @return [Region]
-      def update namespace: nil, scope: nil, visibility: nil
-        Region.new(
-          source: source,
-          namespace: namespace || self.namespace,
-          scope: scope || self.scope,
-          visibility: visibility || self.visibility
-        )
-      end
-      # @param node [Parser::AST::Node]
-      # @return [String]
-      def code_for node
-        source.code_for(node)
-      end
-    end
-  end
-end
+module Solargraph
+  class SourceMap
+    # Data used by the NodeProcessor library to track context at various
+    # locations in a source.
+    #
+    class Region
+      # @return [String]
+      attr_reader :namespace
+      # @return [Symbol]
+      attr_reader :scope
+      # @return [Symbol]
+      attr_reader :visibility
+      # @return [Solargraph::Source]
+      attr_reader :source
+      # @param source [Source]
+      # @param namespace [String]
+      # @param scope [Symbol]
+      # @param visibility [Symbol]
+      def initialize source: Solargraph::Source.load_string(''), namespace: '',
+                     scope: :instance, visibility: :public
+        @source = source
+        @namespace = namespace
+        @scope = scope
+        @visibility = visibility
+      end
+      # @return [String]
+      def filename
+        source.filename
+      end
+      # Generate a new Region with the provided attribute changes.
+      #
+      # @param namespace [String, nil]
+      # @param scope [Symbol, nil]
+      # @param visibility [Symbol, nil]
+      # @return [Region]
+      def update namespace: nil, scope: nil, visibility: nil
+        Region.new(
+          source: source,
+          namespace: namespace || self.namespace,
+          scope: scope || self.scope,
+          visibility: visibility || self.visibility
+        )
+      end
+      # @param node [Parser::AST::Node]
+      # @return [String]
+      def code_for node
+        source.code_for(node)
+      end
+    end
+  end
+end

data/lib/solargraph/version.rb CHANGED Viewed

@@ -1,3 +1,3 @@
-module Solargraph
-  VERSION = '0.32.1'
-end
+module Solargraph
+  VERSION = '0.32.2'
+end

data/lib/solargraph/views/environment.erb CHANGED Viewed

@@ -1,53 +1,53 @@
-<html>
-  <head>
-    <title>Solargraph Environment</title>
-  </head>
-  <h1>
-    Solargraph Environment Info
-  </h1>
-  <h2>
-    System
-  </h2>
-  <ul>
-    <li>
-      Platform: <%= RUBY_PLATFORM %>
-    </li>
-    <li>
-      Shell: <%= ENV['SHELL'] %>
-    </li>
-    <li>
-      Ruby Version: <%= RUBY_VERSION %>
-    </li>
-  </ul>
-  <h2>
-    Solargraph
-  </h2>
-  <ul>
-    <li>
-      Solargraph Version: <%= Solargraph::VERSION %>
-    </li>
-    <li>
-      Core Documentation Version: <%= Solargraph::YardMap::CoreDocs.best_match %>
-    </li>
-    <li>
-      Core Cache Directory: <%= Solargraph::YardMap::CoreDocs.cache_dir %>
-    </li>
-    <li>
-      Parser Target Version: <%= Solargraph::Source.parser.version %>
-    </li>
-    <li>
-      Using Bundler: <%= ENV.key?('BUNDLE_GEMFILE') %>
-    </li>
-  </ul>
-  <h2>
-    Project
-  </h2>
-  <ul>
-    <li>
-      Config: <%= config %>
-    </li>
-    <li>
-      Workspace folders: <%= folders %>
-    </li>
-  </ul>
-</html>
+<html>
+  <head>
+    <title>Solargraph Environment</title>
+  </head>
+  <h1>
+    Solargraph Environment Info
+  </h1>
+  <h2>
+    System
+  </h2>
+  <ul>
+    <li>
+      Platform: <%= RUBY_PLATFORM %>
+    </li>
+    <li>
+      Shell: <%= ENV['SHELL'] %>
+    </li>
+    <li>
+      Ruby Version: <%= RUBY_VERSION %>
+    </li>
+  </ul>
+  <h2>
+    Solargraph
+  </h2>
+  <ul>
+    <li>
+      Solargraph Version: <%= Solargraph::VERSION %>
+    </li>
+    <li>
+      Core Documentation Version: <%= Solargraph::YardMap::CoreDocs.best_match %>
+    </li>
+    <li>
+      Core Cache Directory: <%= Solargraph::YardMap::CoreDocs.cache_dir %>
+    </li>
+    <li>
+      Parser Target Version: <%= Solargraph::Source.parser.version %>
+    </li>
+    <li>
+      Using Bundler: <%= ENV.key?('BUNDLE_GEMFILE') %>
+    </li>
+  </ul>
+  <h2>
+    Project
+  </h2>
+  <ul>
+    <li>
+      Config: <%= config %>
+    </li>
+    <li>
+      Workspace folders: <%= folders %>
+    </li>
+  </ul>
+</html>

data/lib/solargraph/workspace.rb CHANGED Viewed

@@ -1,183 +1,183 @@
-module Solargraph
-  # A workspace consists of the files in a project's directory and the
-  # project's configuration. It provides a Source for each file to be used
-  # in an associated Library or ApiMap.
-  #
-  class Workspace
-    autoload :Config, 'solargraph/workspace/config'
-    # @return [String]
-    attr_reader :directory
-    # @param directory [String]
-    # @param config [Config, nil]
-    def initialize directory = '', config = nil
-      @directory = directory
-      @config = config
-      load_sources
-    end
-    # @return [Solargraph::Workspace::Config]
-    def config
-      @config ||= Solargraph::Workspace::Config.new(directory)
-    end
-    # Merge the source. A merge will update the existing source for the file
-    # or add it to the sources if the workspace is configured to include it.
-    # The source is ignored if the configuration excludes it.
-    #
-    # @param source [Solargraph::Source]
-    # @return [Boolean] True if the source was added to the workspace
-    def merge source
-      unless directory == '*' || source_hash.key?(source.filename)
-        # Reload the config to determine if a new source should be included
-        @config = Solargraph::Workspace::Config.new(directory)
-        return false unless config.calculated.include?(source.filename)
-      end
-      source_hash[source.filename] = source
-      true
-    end
-    # Determine whether a file would be merged into the workspace.
-    #
-    # @param filename [String]
-    # @return [Boolean]
-    def would_merge? filename
-      return true if directory == '*' || source_hash.include?(filename)
-      @config = Solargraph::Workspace::Config.new(directory)
-      config.calculated.include?(filename)
-    end
-    # Remove a source from the workspace. The source will not be removed if
-    # its file exists and the workspace is configured to include it.
-    #
-    # @param filename [String]
-    # @return [Boolean] True if the source was removed from the workspace
-    def remove filename
-      return false unless source_hash.key?(filename)
-      source_hash.delete filename
-      true
-    end
-    # @return [Array<String>]
-    def filenames
-      source_hash.keys
-    end
-    # @return [Array<Solargraph::Source>]
-    def sources
-      source_hash.values
-    end
-    # @param filename [String]
-    # @return [Boolean]
-    def has_file? filename
-      source_hash.key?(filename)
-    end
-    # Get a source by its filename.
-    #
-    # @param filename [String]
-    # @return [Solargraph::Source]
-    def source filename
-      source_hash[filename]
-    end
-    # The require paths associated with the workspace.
-    #
-    # @return [Array<String>]
-    def require_paths
-      @require_paths ||= generate_require_paths
-    end
-    # True if the path resolves to a file in the workspace's require paths.
-    #
-    # @param path [String]
-    # @return [Boolean]
-    def would_require? path
-      require_paths.each do |rp|
-        return true if File.exist?(File.join(rp, "#{path}.rb"))
-      end
-      false
-    end
-    # True if the workspace contains at least one gemspec file.
-    #
-    # @return [Boolean]
-    def gemspec?
-      !gemspecs.empty?
-    end
-    # Get an array of all gemspec files in the workspace.
-    #
-    # @return [Array<String>]
-    def gemspecs
-      return [] if directory.empty? || directory == '*'
-      @gemspecs ||= Dir[File.join(directory, '**/*.gemspec')]
-    end
-    # Synchronize the workspace from the provided updater.
-    #
-    # @param updater [Source::Updater]
-    # @return [void]
-    def synchronize! updater
-      source_hash[updater.filename] = source_hash[updater.filename].synchronize(updater)
-    end
-    private
-    # @return [Hash<String, Solargraph::Source>]
-    def source_hash
-      @source_hash ||= {}
-    end
-    # @return [void]
-    def load_sources
-      source_hash.clear
-      unless directory.empty? || directory == '*'
-        size = config.calculated.length
-        raise WorkspaceTooLargeError, "The workspace is too large to index (#{size} files, #{config.max_files} max)" if config.max_files > 0 and size > config.max_files
-        config.calculated.each do |filename|
-          source_hash[filename] = Solargraph::Source.load(filename)
-        end
-      end
-    end
-    # Generate require paths from gemspecs if they exist or assume the default
-    # lib directory.
-    #
-    # @return [Array<String>]
-    def generate_require_paths
-      return configured_require_paths unless gemspec?
-      result = []
-      gemspecs.each do |file|
-        base = File.dirname(file)
-        # @todo Evaluating gemspec files violates the goal of not running
-        #   workspace code, but this is how Gem::Specification.load does it
-        #   anyway.
-        begin
-          spec = eval(File.read(file), binding, file)
-          next unless Gem::Specification === spec
-          result.concat(spec.require_paths.map { |path| File.join(base, path) })
-        rescue Exception => e
-          # Don't die if we have an error during eval-ing a gem spec.
-          # Concat the default lib directory instead.
-          Solargraph.logger.warn "Error reading #{file}: [#{e.class}] #{e.message}"
-          result.push File.join(base, 'lib')
-        end
-      end
-      result.concat config.require_paths
-      result.push File.join(directory, 'lib') if result.empty?
-      result
-    end
-    # Get additional require paths defined in the configuration.
-    #
-    # @return [Array<String>]
-    def configured_require_paths
-      return ['lib'] if directory.empty?
-      return [File.join(directory, 'lib')] if config.require_paths.empty?
-      config.require_paths.map{|p| File.join(directory, p)}
-    end
-  end
-end
+module Solargraph
+  # A workspace consists of the files in a project's directory and the
+  # project's configuration. It provides a Source for each file to be used
+  # in an associated Library or ApiMap.
+  #
+  class Workspace
+    autoload :Config, 'solargraph/workspace/config'
+    # @return [String]
+    attr_reader :directory
+    # @param directory [String]
+    # @param config [Config, nil]
+    def initialize directory = '', config = nil
+      @directory = directory
+      @config = config
+      load_sources
+    end
+    # @return [Solargraph::Workspace::Config]
+    def config
+      @config ||= Solargraph::Workspace::Config.new(directory)
+    end
+    # Merge the source. A merge will update the existing source for the file
+    # or add it to the sources if the workspace is configured to include it.
+    # The source is ignored if the configuration excludes it.
+    #
+    # @param source [Solargraph::Source]
+    # @return [Boolean] True if the source was added to the workspace
+    def merge source
+      unless directory == '*' || source_hash.key?(source.filename)
+        # Reload the config to determine if a new source should be included
+        @config = Solargraph::Workspace::Config.new(directory)
+        return false unless config.calculated.include?(source.filename)
+      end
+      source_hash[source.filename] = source
+      true
+    end
+    # Determine whether a file would be merged into the workspace.
+    #
+    # @param filename [String]
+    # @return [Boolean]
+    def would_merge? filename
+      return true if directory == '*' || source_hash.include?(filename)
+      @config = Solargraph::Workspace::Config.new(directory)
+      config.calculated.include?(filename)
+    end
+    # Remove a source from the workspace. The source will not be removed if
+    # its file exists and the workspace is configured to include it.
+    #
+    # @param filename [String]
+    # @return [Boolean] True if the source was removed from the workspace
+    def remove filename
+      return false unless source_hash.key?(filename)
+      source_hash.delete filename
+      true
+    end
+    # @return [Array<String>]
+    def filenames
+      source_hash.keys
+    end
+    # @return [Array<Solargraph::Source>]
+    def sources
+      source_hash.values
+    end
+    # @param filename [String]
+    # @return [Boolean]
+    def has_file? filename
+      source_hash.key?(filename)
+    end
+    # Get a source by its filename.
+    #
+    # @param filename [String]
+    # @return [Solargraph::Source]
+    def source filename
+      source_hash[filename]
+    end
+    # The require paths associated with the workspace.
+    #
+    # @return [Array<String>]
+    def require_paths
+      @require_paths ||= generate_require_paths
+    end
+    # True if the path resolves to a file in the workspace's require paths.
+    #
+    # @param path [String]
+    # @return [Boolean]
+    def would_require? path
+      require_paths.each do |rp|
+        return true if File.exist?(File.join(rp, "#{path}.rb"))
+      end
+      false
+    end
+    # True if the workspace contains at least one gemspec file.
+    #
+    # @return [Boolean]
+    def gemspec?
+      !gemspecs.empty?
+    end
+    # Get an array of all gemspec files in the workspace.
+    #
+    # @return [Array<String>]
+    def gemspecs
+      return [] if directory.empty? || directory == '*'
+      @gemspecs ||= Dir[File.join(directory, '**/*.gemspec')]
+    end
+    # Synchronize the workspace from the provided updater.
+    #
+    # @param updater [Source::Updater]
+    # @return [void]
+    def synchronize! updater
+      source_hash[updater.filename] = source_hash[updater.filename].synchronize(updater)
+    end
+    private
+    # @return [Hash<String, Solargraph::Source>]
+    def source_hash
+      @source_hash ||= {}
+    end
+    # @return [void]
+    def load_sources
+      source_hash.clear
+      unless directory.empty? || directory == '*'
+        size = config.calculated.length
+        raise WorkspaceTooLargeError, "The workspace is too large to index (#{size} files, #{config.max_files} max)" if config.max_files > 0 and size > config.max_files
+        config.calculated.each do |filename|
+          source_hash[filename] = Solargraph::Source.load(filename)
+        end
+      end
+    end
+    # Generate require paths from gemspecs if they exist or assume the default
+    # lib directory.
+    #
+    # @return [Array<String>]
+    def generate_require_paths
+      return configured_require_paths unless gemspec?
+      result = []
+      gemspecs.each do |file|
+        base = File.dirname(file)
+        # @todo Evaluating gemspec files violates the goal of not running
+        #   workspace code, but this is how Gem::Specification.load does it
+        #   anyway.
+        begin
+          spec = eval(File.read(file), binding, file)
+          next unless Gem::Specification === spec
+          result.concat(spec.require_paths.map { |path| File.join(base, path) })
+        rescue Exception => e
+          # Don't die if we have an error during eval-ing a gem spec.
+          # Concat the default lib directory instead.
+          Solargraph.logger.warn "Error reading #{file}: [#{e.class}] #{e.message}"
+          result.push File.join(base, 'lib')
+        end
+      end
+      result.concat config.require_paths
+      result.push File.join(directory, 'lib') if result.empty?
+      result
+    end
+    # Get additional require paths defined in the configuration.
+    #
+    # @return [Array<String>]
+    def configured_require_paths
+      return ['lib'] if directory.empty?
+      return [File.join(directory, 'lib')] if config.require_paths.empty?
+      config.require_paths.map{|p| File.join(directory, p)}
+    end
+  end
+end