![Build Status](https://github.com/Shopify/vscode-shopify-ruby/workflows/CI/badge.svg)
VS Code Shopify Ruby
This extension pack contains an opinionated collection of extensions for Ruby development in VS Code:
Note that the Sorbet extension will only be activated if your project is onboarded to the Sorbet type checker. Also, the Ruby LSP extension includes a debugger for common debugging use-cases. You may need to use the Ruby Debugger extension for certain scenarios.
[!NOTE]
This extension does not implement any Ruby related features. It's just a pack containing other extensions, which are
the ones that deliver the features.
If you encounter Sorbet related issues, please report them in https://github.com/sorbet/sorbet
If you are using RDBG to debug and encounter issues, please report them in https://github.com/ruby/vscode-rdbg
For other Ruby development issues, please report them in https://github.com/Shopify/vscode-ruby-lsp
Usage
Search for
Shopify.ruby-extensions-pack
in
the extensions tab and click install.
Themes
Included in this extension is the Spinel dark theme, which is made specifically for Ruby using all of the semantic
highlighting information provided by the Ruby LSP.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/Shopify/vscode-shopify-ruby.
This project is intended to be a safe, welcoming space for collaboration, and contributors
are expected to adhere to the
Contributor Covenant
code of conduct.
Executing tests
- Open VS Code on this repo
- Make sure dependencies are installed (
yarn install
)
- On VS Code's run and debug tab, select the
Extension tests
task
- Click the run button or press F5 to run tests. Output is displayed in the debug console
Testing the extension locally
- Open VS Code on this repo
- Make sure dependencies are installed (
yarn install
)
- On VS Code's run and debug tab, select the
Extension
task
- This will open a second VS Code window where the development version of the extension is running. Use it to verify
that the extension is working as expected
- If needed, the cache and recommended settings can be cleared by running the
Ruby extension pack: Clear cache and recommended settings
command. This will make the extension prompt overrides again
Debugging
To debug the extension, add breakpoints using the VS Code interface and either run the tests or the extension in
development mode.
License
The extension is available as open source under the terms of the
MIT License.