Sorbetto for VS Code
Sorbetto is a Visual Studio Code extension that provides Ruby language support using Sorbet, a static type checker for Ruby. It is a fork of the official extension, focusing on user experience (UX) and maintainability improvements.
Features
- Uses the Language Status Item.
- Provides a collection of snippets for Sorbet constructs to make common patterns easier to insert and speed up development.
- Performs automatic dependency checks (e.g.,
bundle, srb) and streamlines workspace setup, ensuring a smoother startup experience.
# typed -sigil completion provider.
Maintainability Updates
- Minimum VSCode version updated to 1.77, allowing use of more recent extensibility APIs.
- Language Client library updated to version 9.0.
- Shipped dependencies limited to Language Client library, reducing complexity and risk.
- Migrating to
esbuild enables minification and bundling, resulting in a significantly smaller runtime code footprint.
Sorbet Language Status
Sorbetto replaces the custom Sorbet status bar item from the official extension with direct integration with VS Code's Language Status Item for Ruby. This does not result in any loss in functionality, however, as it is possible to pin any entry from the pop-up onto the status bar. So if you preferred the status bar item experience, you still can have it.
The following entries are available on the language status item:
Sorbet Configuration: shows the active Sorbet LSP configuration name as set via sorbetto.sorbetLspConfiguration, along with a quick Configure action to modify it.Sorbet Status: displayes the current status of the Sorbet LSP, including a busy indicator. The Output action brings the Sorbetto Output pane into view for checking log entries.
Sorbet Snippets
Sorbetto provides snippets for standard Sorbet constructs. You can access them via the Snippet: Fill File with Snippet command on any open editor, as well as the Snippet: Insert Snippet on any Ruby editor. Additionally, each snippet has an associated trigger word that is recognized by IntelliSense while typing. For example, typing abstract will display the snippets for an abstract class, module or method, allowing for quick and intuitive code insertion. Use the Snippet: Insert Snippet from a Ruby editor to browse a list of all available snippets in your installed version of the extension.
Extension Logs
Sorbetto uses a single output channel to log its exceptions and Sorbet's. The log level can be controlled via the standard Developer: Set Log Level commmand, seleting Sorbetto from the dropdown. See VS Code documentation for details.
Workspace Setup
The Setup Workspace command automates all steps from Adopting Sorbet into a convenient place. When setting up bundler, it will force local installation of gems via bundle config set --local path 'vendor/bundle'. Don't use this command if you prefer globally installed gems, and follow the linked documentation to setup your workspace.
