/vscode-shopify-ruby

An opinionated and auto-configured set of extensions for Ruby development

Primary LanguageTypeScriptMIT LicenseMIT

Ruby extensions pack logo

Build Status

VS Code Shopify Ruby

This extension pack contains an opinionated collection of pre-configured extensions for Ruby development in VS Code:

Usage

Search for Shopify.ruby-extensions-pack in the extensions tab and click install.

When activated, this extension will prompt you about overriding your existing configuration to use the recommended defaults. You may want to backup your settings.json file before trying this extension out.

The recommended settings and their respective values can be found in the extension configuration file.

Commands

The commands offered to help manage the recommended settings are:

"Ruby extensions pack: Force apply defaults" -> Apply all defaults
"Ruby extensions pack: Clear cache and recommended settings" -> Clear all cached choices and remove the recommended settings

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.

Example code highlighted with the Spinel theme

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

  1. Open VS Code on this repo
  2. Make sure dependencies are installed (yarn install)
  3. On VS Code's run and debug tab, select the Extension tests task
  4. Click the run button or press F5 to run tests. Output is displayed in the debug console

Testing the extension locally

  1. Open VS Code on this repo
  2. Make sure dependencies are installed (yarn install)
  3. On VS Code's run and debug tab, select the Extension task
  4. 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
  5. If needed, the cache and recommended settings can be cleared by running the Ruby extensions pack: Clear cache 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.