solargraph 0.58.0 → 0.59.0

data/CHANGELOG.md

@@ -1,3 +1,27 @@
+## 0.59.0 - May 13, 2026
+- Ensure pathname is required for rbs in shell caching processes (#1183)
+- Pre-release branch 2026-01-12 (#1152)
+- 2026-01-27 dev branch (#1165)
+- Position linting (#1179)
+- Revert YARD and RBS pin caching (#1180)
+- Ensure pathname is required for rbs in shell caching processes (#1183)
+- Limit default include glob to current directory (#1184) 
+- Require Ruby >= 3.1.0
+- Require RBS >= 3.10.0
+- Stub combine_same_type_arity_signatures (#1186)
+
+## 0.58.3 - March 9, 2026
+- Ignore workspace dependencies in cache processes (#1174)
+
+## 0.58.2 - January 19, 2026
+- Avoid rbs pollution (#1146)
+- Fix 'solargraph pin --references ClassName' private method call (#1150)
+- Improve memory efficiency of Position class (#1054)
+- Raise InvalidOffsetError for offsets > text (#1155)
+
+## 0.58.1 - January 2, 2026
+- Normalize line endings to LF (#1142)
+
 ## 0.58.0 - January 1, 2026
 - Faster constant resolution (#1083)
 - [regression] Handle RBS static method aliases (#1094)

data/Gemfile

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 gemspec name: 'solargraph'
 
 # Local gemfile for development tools, etc.
-local_gemfile = File.expand_path(".Gemfile", __dir__)
+local_gemfile = File.expand_path('.Gemfile', __dir__)
 instance_eval File.read local_gemfile if File.exist? local_gemfile

data/README.md

@@ -51,6 +51,8 @@ Plug-ins and extensions are available for the following editors:
 
 Solargraph's behavior can be controlled via optional [configuration](https://solargraph.org/guides/configuration) files. The highest priority file is a `.solargraph.yml` file at the root of the project. If not present, any global configuration at `~/.config/solargraph/config.yml` will apply. The path to the global configuration can be overridden with the `SOLARGRAPH_GLOBAL_CONFIG` environment variable.
 
+Use `bundle exec solargraph config` to create a configuration file.
+
 ### Plugins
 
 Solargraph supports [plugins](https://solargraph.org/guides/plugins) that implement their own Solargraph features, such as diagnostics reporters and conventions to provide LSP features and type-checking, e.g. for frameworks which use metaprogramming and/or DSLs.
@@ -132,9 +134,7 @@ See [https://solargraph.org/guides](https://solargraph.org/guides) for more tips
 
 ### Development
 
-To see more logging when typechecking or running specs, set the
-`SOLARGRAPH_LOG` environment variable to `debug` or `info`.  `warn` is
-the default value.
+To see more logging when typechecking or running specs, set the `SOLARGRAPH_LOG` environment variable to `debug` or `info`.  `warn` is the default value.
 
 Code contributions are always appreciated. Feel free to fork the repo and submit pull requests. Check for open issues that could use help. Start new issues to discuss changes that have a major impact on the code or require large time commitments.
 

data/Rakefile

@@ -1,42 +1,44 @@
+# frozen_string_literal: true
+
 require 'rake'
 require 'bundler/gem_tasks'
 require 'fileutils'
 require 'open3'
 
-desc "Open a Pry session preloaded with this library"
+desc 'Open a Pry session preloaded with this library'
 task :console do
-  sh "pry -I lib -r solargraph.rb"
+  sh 'pry -I lib -r solargraph.rb'
 end
 
-desc "Run the type checker"
+desc 'Run the type checker'
 task typecheck: [:typecheck_strong]
 
-desc "Run the type checker at typed level - return code issues provable without annotations being correct"
+desc 'Run the type checker at typed level - return code issues provable without annotations being correct'
 task :typecheck_typed do
-  sh "SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level typed"
+  sh 'SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level typed'
 end
 
-desc "Run the type checker at strict level - report issues using type annotations"
+desc 'Run the type checker at strict level - report issues using type annotations'
 task :typecheck_strict do
-  sh "SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level strict"
+  sh 'SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level strict'
 end
 
-desc "Run the type checker at strong level - enforce that type annotations exist"
+desc 'Run the type checker at strong level - enforce that type annotations exist'
 task :typecheck_strong do
-  sh "SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level strong"
+  sh 'SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level strong'
 end
 
-desc "Run the type checker at alpha level - run high-false-alarm checks"
+desc 'Run the type checker at alpha level - run high-false-alarm checks'
 task :typecheck_alpha do
-  sh "SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level alpha"
+  sh 'SOLARGRAPH_ASSERTS=on bundle exec solargraph typecheck --level alpha'
 end
 
-desc "Run RSpec tests, starting with the ones that failed last time"
+desc 'Run RSpec tests, starting with the ones that failed last time'
 task spec: %i[spec_failed undercover_no_fail full_spec] do
   undercover
 end
 
-desc "Run all RSpec tests"
+desc 'Run all RSpec tests'
 task :full_spec do
   warn 'starting spec'
   sh 'TEST_COVERAGE_COMMAND_NAME=full-new bundle exec rspec' #  --profile'
@@ -63,19 +65,20 @@ def undercover
   status
 rescue StandardError => e
   warn "hit error: #{e.message}"
+  # @sg-ignore Need to add nil check here
   warn "Backtrace:\n#{e.backtrace.join("\n")}"
   warn "output: #{output}"
-  puts "Flushing"
+  puts 'Flushing'
   $stdout.flush
   raise
 end
 
-desc "Check PR coverage"
+desc 'Check PR coverage'
 task :undercover do
-  raise "Undercover failed" unless undercover.success?
+  raise 'Undercover failed' unless undercover.success?
 end
 
-desc "Branch-focused fast-feedback quality/spec/coverage checks"
+desc 'Branch-focused fast-feedback quality/spec/coverage checks'
 task test: %i[overcommit spec typecheck] do
   # do these in order
   Rake::Task['typecheck_strict'].invoke
@@ -83,18 +86,18 @@ task test: %i[overcommit spec typecheck] do
   Rake::Task['typecheck_alpha'].invoke
 end
 
-desc "Re-run failed specs.  Add --fail-fast in your .rspec-local file if desired."
+desc 'Re-run failed specs.  Add --fail-fast in your .rspec-local file if desired.'
 task :spec_failed do
   # allow user to check out any persistent failures while looking for
   # more in the whole test suite
   sh 'TEST_COVERAGE_COMMAND_NAME=next-failure bundle exec rspec --only-failures || true'
 end
 
-desc "Run undercover and show output without failing the task if it fails"
+desc 'Run undercover and show output without failing the task if it fails'
 task :undercover_no_fail do
   undercover
 rescue StandardError
-  puts "Undercover failed, but continuing with other tasks."
+  puts 'Undercover failed, but continuing with other tasks.'
 end
 
 # @return [void]
@@ -103,7 +106,7 @@ def simplecov_collate
   require 'simplecov-lcov'
   require 'undercover/simplecov_formatter'
 
-  SimpleCov.collate(Dir["coverage/{next-failure,full,ad-hoc}/.resultset.json"]) do
+  SimpleCov.collate(Dir['coverage/{next-failure,full,ad-hoc}/.resultset.json']) do
     cname = 'combined'
     command_name cname
     new_dir = File.join('coverage', cname)
@@ -118,7 +121,7 @@ def simplecov_collate
              ])
     SimpleCov::Formatter::LcovFormatter.config.report_with_single_file = true
   end
-  puts "Simplecov collated results into coverage/combined/.resultset.json"
+  puts 'Simplecov collated results into coverage/combined/.resultset.json'
 rescue StandardError => e
   puts "Simplecov collate failed: #{e.message}"
 ensure
@@ -130,7 +133,7 @@ task :simplecov_collate do
   simplecov_collate
 end
 
-desc "Show quality checks on this development branch so far, including any staged files"
+desc 'Show quality checks on this development branch so far, including any staged files'
 task :overcommit do
   # OVERCOMMIT_DEBUG=1 will show more detail
   sh 'SOLARGRAPH_ASSERTS=on bundle exec overcommit --run --diff origin/master'

data/bin/solargraph

@@ -1,8 +1,9 @@
-#!/usr/bin/env ruby
-
-# turn off warning diagnostics from Ruby
-$VERBOSE=nil
-
-require 'solargraph'
-
-Solargraph::Shell.start(ARGV)
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# turn off warning diagnostics from Ruby
+$VERBOSE = nil
+
+require 'solargraph'
+
+Solargraph::Shell.start(ARGV)

data/lib/solargraph/api_map/cache.rb

@@ -1,110 +1,110 @@
-# frozen_string_literal: true
-
-module Solargraph
-  class ApiMap
-    class Cache
-      def initialize
-        # @type [Hash{String => Array<Pin::Method>}]
-        @methods = {}
-        # @type [Hash{String, Array<String> => Array<Pin::Base>}]
-        @constants = {}
-        # @type [Hash{String => String}]
-        @qualified_namespaces = {}
-        # @type [Hash{String => Pin::Method}]
-        @receiver_definitions = {}
-        # @type [Hash{String => SourceMap::Clip}]
-        @clips = {}
-      end
-
-      def to_s
-        self.class.to_s
-      end
-
-      # avoid enormous dump
-      def inspect
-        to_s
-      end
-
-      # @param fqns [String]
-      # @param scope [Symbol]
-      # @param visibility [Array<Symbol>]
-      # @param deep [Boolean]
-      # @return [Array<Pin::Method>]
-      def get_methods fqns, scope, visibility, deep
-        @methods["#{fqns}|#{scope}|#{visibility}|#{deep}"]
-      end
-
-      # @param fqns [String]
-      # @param scope [Symbol]
-      # @param visibility [Array<Symbol>]
-      # @param deep [Boolean]
-      # @param value [Array<Pin::Method>]
-      # @return [void]
-      def set_methods fqns, scope, visibility, deep, value
-        @methods["#{fqns}|#{scope}|#{visibility}|#{deep}"] = value
-      end
-
-      # @param namespace [String]
-      # @param contexts [Array<String>]
-      # @return [Array<Pin::Base>]
-      def get_constants namespace, contexts
-        @constants["#{namespace}|#{contexts}"]
-      end
-
-      # @param namespace [String]
-      # @param contexts [Array<String>]
-      # @param value [Array<Pin::Base>]
-      # @return [void]
-      def set_constants namespace, contexts, value
-        @constants["#{namespace}|#{contexts}"] = value
-      end
-
-      # @param name [String]
-      # @param context [String]
-      # @return [String]
-      def get_qualified_namespace name, context
-        @qualified_namespaces["#{name}|#{context}"]
-      end
-
-      # @param name [String]
-      # @param context [String]
-      # @param value [String]
-      # @return [void]
-      def set_qualified_namespace name, context, value
-        @qualified_namespaces["#{name}|#{context}"] = value
-      end
-
-      # @param path [String]
-      # @return [Pin::Method]
-      def get_receiver_definition path
-        @receiver_definitions[path]
-      end
-
-      # @param path [String]
-      # @param pin [Pin::Method]
-      # @return [void]
-      def set_receiver_definition path, pin
-        @receiver_definitions[path] = pin
-      end
-
-      # @return [void]
-      def clear
-        return if empty?
-
-        all_caches.each(&:clear)
-      end
-
-      # @return [Boolean]
-      def empty?
-        all_caches.all?(&:empty?)
-      end
-
-      private
-
-      # @return [Array<Object>]
-      def all_caches
-        [@methods, @constants, @qualified_namespaces, @receiver_definitions, @clips]
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Solargraph
+  class ApiMap
+    class Cache
+      def initialize
+        # @type [Hash{String => Array<Pin::Method>}]
+        @methods = {}
+        # @type [Hash{String, Array<String> => Array<Pin::Base>}]
+        @constants = {}
+        # @type [Hash{String => String, nil}]
+        @qualified_namespaces = {}
+        # @type [Hash{String => Pin::Method}]
+        @receiver_definitions = {}
+        # @type [Hash{String => SourceMap::Clip}]
+        @clips = {}
+      end
+
+      def to_s
+        self.class.to_s
+      end
+
+      # avoid enormous dump
+      def inspect
+        to_s
+      end
+
+      # @param fqns [String]
+      # @param scope [Symbol]
+      # @param visibility [Array<Symbol>]
+      # @param deep [Boolean]
+      # @return [Array<Pin::Method>]
+      def get_methods fqns, scope, visibility, deep
+        @methods["#{fqns}|#{scope}|#{visibility}|#{deep}"]
+      end
+
+      # @param fqns [String]
+      # @param scope [Symbol]
+      # @param visibility [Array<Symbol>]
+      # @param deep [Boolean]
+      # @param value [Array<Pin::Method>]
+      # @return [void]
+      def set_methods fqns, scope, visibility, deep, value
+        @methods["#{fqns}|#{scope}|#{visibility}|#{deep}"] = value
+      end
+
+      # @param namespace [String]
+      # @param contexts [Array<String>]
+      # @return [Array<Pin::Base>]
+      def get_constants namespace, contexts
+        @constants["#{namespace}|#{contexts}"]
+      end
+
+      # @param namespace [String]
+      # @param contexts [Array<String>]
+      # @param value [Array<Pin::Base>]
+      # @return [void]
+      def set_constants namespace, contexts, value
+        @constants["#{namespace}|#{contexts}"] = value
+      end
+
+      # @param name [String]
+      # @param context [String]
+      # @return [String, nil]
+      def get_qualified_namespace name, context
+        @qualified_namespaces["#{name}|#{context}"]
+      end
+
+      # @param name [String]
+      # @param context [String]
+      # @param value [String, nil]
+      # @return [void]
+      def set_qualified_namespace name, context, value
+        @qualified_namespaces["#{name}|#{context}"] = value
+      end
+
+      # @param path [String]
+      # @return [Pin::Method]
+      def get_receiver_definition path
+        @receiver_definitions[path]
+      end
+
+      # @param path [String]
+      # @param pin [Pin::Method]
+      # @return [void]
+      def set_receiver_definition path, pin
+        @receiver_definitions[path] = pin
+      end
+
+      # @return [void]
+      def clear
+        return if empty?
+
+        all_caches.each(&:clear)
+      end
+
+      # @return [Boolean]
+      def empty?
+        all_caches.all?(&:empty?)
+      end
+
+      private
+
+      # @return [Array<Object>]
+      def all_caches
+        [@methods, @constants, @qualified_namespaces, @receiver_definitions, @clips]
+      end
+    end
+  end
+end