jimeh-solargraph 0.40.4.0

data/lib/solargraph/views/search.erb

@@ -0,0 +1,11 @@
+<h1>Search Results for <kbd><%= query %></kbd></h1>
+
+<% unless results.empty? %>
+    <ul class="doc-list">
+    <% results.each do |result| %>
+        <li>
+            <a href="solargraph:/document?query=<%= CGI.escape(result) %>"><%= result %></a>
+        </li>
+    <% end %>
+    </ul>
+<% end %>

data/lib/solargraph/workspace.rb

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+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
+
+    # The require paths associated with the workspace.
+    #
+    # @return [Array<String>]
+    attr_reader :require_paths
+
+    # @return [Array<String>]
+    attr_reader :gemnames
+
+    # @param directory [String]
+    # @param config [Config, nil]
+    def initialize directory = '', config = nil
+      @directory = directory
+      @config = config
+      load_sources
+      @gemnames = []
+      @require_paths = generate_require_paths
+      require_plugins
+    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
+
+    # 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')].select do |gs|
+        config.allow? gs
+      end
+    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|
+          begin
+            source_hash[filename] = Solargraph::Source.load(filename)
+          rescue Errno::ENOENT => e
+            Solargraph.logger.warn("Error loading #{filename}: [#{e.class}] #{e.message}")
+          end
+        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)
+        # HACK: Evaluating gemspec files violates the goal of not running
+        #   workspace code, but this is how Gem::Specification.load does it
+        #   anyway.
+        Dir.chdir base do
+          begin
+            # @type [Gem::Specification]
+            spec = eval(File.read(file), TOPLEVEL_BINDING, file)
+            next unless Gem::Specification === spec
+            @gemnames.push spec.name
+            result.concat(spec.require_paths.map { |path| File.join(base, path) })
+          rescue RuntimeError, ScriptError, Errno::ENOENT => 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
+      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
+
+    def require_plugins
+      config.plugins.each do |plugin|
+        begin
+          require plugin
+        rescue LoadError
+          Solargraph.logger.warn "Failed to load plugin '#{plugin}'"
+        end
+      end
+    end
+  end
+end

data/lib/solargraph/workspace/config.rb

@@ -0,0 +1,230 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Solargraph
+  class Workspace
+    # Configuration data for a workspace.
+    #
+    class Config
+      # The maximum number of files that can be added to a workspace.
+      # The workspace's .solargraph.yml can override this value.
+      MAX_FILES = 5000
+
+      # @return [String]
+      attr_reader :directory
+
+      # @return [Hash]
+      attr_reader :raw_data
+
+      # @param directory [String]
+      def initialize directory = ''
+        @directory = directory
+        @raw_data = config_data
+        included
+        excluded
+      end
+
+      # An array of files included in the workspace (before calculating excluded files).
+      #
+      # @return [Array<String>]
+      def included
+        return [] if directory.empty? || directory == '*'
+        @included ||= process_globs(@raw_data['include'])
+      end
+
+      # An array of files excluded from the workspace.
+      #
+      # @return [Array<String>]
+      def excluded
+        return [] if directory.empty? || directory == '*'
+        @excluded ||= process_exclusions(@raw_data['exclude'])
+      end
+
+      def allow? filename
+        filename.start_with?(directory) && 
+          !excluded.include?(filename) &&
+          excluded_directories.none? { |d| filename.start_with?(d) }
+      end
+
+      # The calculated array of (included - excluded) files in the workspace.
+      #
+      # @return [Array<String>]
+      def calculated
+        Solargraph.logger.info "Indexing workspace files in #{directory}" unless @calculated || directory.empty? || directory == '*'
+        @calculated ||= included - excluded
+      end
+
+      # An array of domains configured for the workspace.
+      # A domain is a namespace that the ApiMap should include in the global
+      # namespace. It's typically used to identify available DSLs.
+      #
+      # @return [Array<String>]
+      def domains
+        raw_data['domains']
+      end
+
+      # An array of required paths to add to the workspace.
+      #
+      # @return [Array<String>]
+      def required
+        raw_data['require']
+      end
+
+      # An array of load paths for required paths.
+      #
+      # @return [Array<String>]
+      def require_paths
+        raw_data['require_paths'] || []
+      end
+
+      # An array of reporters to use for diagnostics.
+      #
+      # @return [Array<String>]
+      def reporters
+        raw_data['reporters']
+      end
+
+      # A hash of options supported by the formatter
+      #
+      # @return [Hash]
+      def formatter
+        raw_data['formatter']
+      end
+
+      # An array of plugins to require.
+      #
+      # @return [Array<String>]
+      def plugins
+        raw_data['plugins']
+      end
+
+      # The maximum number of files to parse from the workspace.
+      #
+      # @return [Integer]
+      def max_files
+        raw_data['max_files']
+      end
+
+      private
+
+      # @return [String]
+      def global_config_path
+        ENV['SOLARGRAPH_GLOBAL_CONFIG'] || 
+          File.join(Dir.home, '.config', 'solargraph', 'config.yml')
+      end
+
+      # @return [String]
+      def workspace_config_path
+        return '' if @directory.empty?
+        File.join(@directory, '.solargraph.yml')
+      end
+
+      # @return [Hash]
+      def config_data
+        workspace_config = read_config(workspace_config_path)
+        global_config = read_config(global_config_path)
+
+        defaults = default_config
+        defaults.merge({'exclude' => []}) unless workspace_config.nil?
+
+        defaults
+          .merge(global_config || {})
+          .merge(workspace_config || {})
+      end
+
+      # Read a .solargraph yaml config
+      #
+      # @param directory [String]
+      # @return [Hash, nil]
+      def read_config config_path = ''
+        return nil if config_path.empty?
+        return nil unless File.file?(config_path)
+        YAML.safe_load(File.read(config_path))
+      end
+
+      # @return [Hash]
+      def default_config
+        {
+          'include' => ['**/*.rb'],
+          'exclude' => ['spec/**/*', 'test/**/*', 'vendor/**/*', '.bundle/**/*'],
+          'require' => [],
+          'domains' => [],
+          'reporters' => %w[rubocop require_not_found],
+          'formatter' => {
+            'rubocop' => {
+              'cops' => 'safe',
+              'except' => [],
+              'only' => [],
+              'extra_args' =>[]
+            }
+          },
+          'require_paths' => [],
+          'plugins' => [],
+          'max_files' => MAX_FILES
+        }
+      end
+
+      # Get an array of files from the provided globs.
+      #
+      # @param globs [Array<String>]
+      # @return [Array<String>]
+      def process_globs globs
+        result = []
+        globs.each do |glob|
+          result.concat Dir[File.join directory, glob].map{ |f| f.gsub(/\\/, '/') }
+        end
+        result
+      end
+
+      # Modify the included files based on excluded directories and get an
+      # array of additional files to exclude.
+      #
+      # @param globs [Array<String>]
+      # @return [Array<String>]
+      def process_exclusions globs
+        remainder = globs.select do |glob|
+          if glob_is_directory?(glob)
+            exdir = File.join(directory, glob_to_directory(glob))
+            included.delete_if { |file| file.start_with?(exdir) }
+            false
+          else
+            true
+          end
+        end
+        process_globs remainder
+      end
+
+      # True if the glob translates to a whole directory.
+      #
+      # @example
+      #   glob_is_directory?('path/to/dir')       # => true
+      #   glob_is_directory?('path/to/dir/**/*)   # => true
+      #   glob_is_directory?('path/to/file.txt')  # => false
+      #   glob_is_directory?('path/to/*.txt')     # => false
+      #
+      # @param glob [String]
+      # @return [Boolean]
+      def glob_is_directory? glob
+        File.directory?(glob) || File.directory?(glob_to_directory(glob))
+      end
+
+      # Translate a glob to a base directory if applicable
+      #
+      # @example
+      #   glob_to_directory('path/to/dir/**/*') # => 'path/to/dir'
+      #
+      # @param glob [String]
+      # @return [String]
+      def glob_to_directory glob
+        glob.gsub(/(\/\*|\/\*\*\/\*\*?)$/, '')
+      end
+
+      def excluded_directories
+        @raw_data['exclude']
+          .select { |g| glob_is_directory?(g) }
+          .map { |g| File.join(directory, glob_to_directory(g)) }
+      end
+    end
+  end
+end