Solargraph

NOTE: This is a fork of solargraph which aims to very quickly incorporate fixes from outstanding Pull Requests and release them as a gem called jimeh-solargraph. You can easily compare changes which have been added to this fork.

To use this gem, you should first uninstall the solargraph gem to avoid conflicts, as both gems provide a binary called solargraph.

The version of jimeh-solargraph will follow that of solargraph, with an additional number added at the end. For example solargraph 0.40.4 will be 0.40.4.1 of jimeh-solargraph. The final digit will be incremented independently of the previous three digits that make up solargraph's version.

Solargraph provides a comprehensive suite of tools for Ruby programming: intellisense, diagnostics, inline documentation, and type checking.

A web-based demonstration of Solargraph's autocomplete is available at https://solargraph.org/demo.

Install the gem from the command line:

gem install jimeh-solargraph

Or add it to your Gemfile:

gem 'jimeh-solargraph', group: :development

Plug-ins and extensions are available for the following editors:

• Visual Studio Code

  • Extension: https://marketplace.visualstudio.com/items?itemName=castwide.solargraph
  • GitHub: https://github.com/castwide/vscode-solargraph

• Atom

  • Package: https://atom.io/packages/ruby-solargraph
  • GitHub: https://github.com/castwide/atom-solargraph

• Vim

  • GitHub: https://github.com/autozimu/LanguageClient-neovim

• Emacs

  • GitHub: https://github.com/guskovd/emacs-solargraph

• Eclipse

  • Plugin: https://marketplace.eclipse.org/content/ruby-solargraph
  • GitHub: https://github.com/PyvesB/eclipse-solargraph

Solargraph is capable of providing code completion and documentation for gems that have YARD documentation. You can make sure your gems are documented by running yard gems from the command line. (YARD is included as one of Solargraph's gem dependencies. The first time you run it might take a while if you have a lot of gems installed).

When editing code, a require call that references a gem will pull the documentation into the code maps and include the gem's API in code completion and intellisense.

If your project automatically requires bundled gems (e.g., require 'bundler/require'), Solargraph will add all of the Gemfile's default dependecies to the map.

As of version 0.33.0, Solargraph includes a type checker that uses a combination of YARD tags and code analysis to report missing type definitions. In strict mode, it performs type inference to determine whether the tags match the types it detects from code.

The Solargraph gem ships with documentation for Ruby 2.2.2. You can download documentation for other Ruby versions from the command line.

$ solargraph list-cores      # List the installed documentation versions
$ solargraph available-cores # List the versions available for download
$ solargraph download-core   # Install the best match for your Ruby version
$ solargraph clear           # Reset the documentation cache

Solargraph uses a cache directory to store documentation for the Ruby core and customized documentation for certain gems. The default location is ~/.solargraph/cache, e.g., /home/<username>/.solargraph/cache on Linux or C:\Users\<username>\.solargraph on Windows.

You can change the location of the cache directory with the SOLARGRAPH_CACHE environment variable. This can be useful if you want the cache to comply with the XDG Base Directory Specification.

If you're using the language server with a project that uses Bundler, the most comprehensive way to use your bundled gems is to bundle Solargraph.

In the Gemfile:

gem 'solargraph', group: :development

Run bundle install and use bundle exec yard gems to generate the documentation. This process documents cached or vendored gems, or even gems that are installed from a local path.

In order to make sure you're using the correct dependencies, you can start the language server with Bundler. In VS Code, there's a solargraph.useBundler option. Other clients will vary, but the command you probably want to run is bundle exec solargraph socket or bundle exec solargraph stdio.

The language server protocol is the recommended way for integrating Solargraph into editors and IDEs. Clients can connect using either stdio or TCP. Language client developers should refer to https://solargraph.org/guides/language-server.

See https://solargraph.org/guides for more tips and tutorials about Solargraph.

GitHub Issues are the best place to ask questions, report problems, and suggest improvements.

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.

Use Patreon to support ongoing development of Solargraph at https://www.patreon.com/castwide.

You can also make one-time donations via PayPal at https://www.paypal.me/castwide.