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

solargraph 0.32.1 → 0.32.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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