bazel-stack-vscode installs statistics

bazel-stack-vscode

Bazel Support for Visual Studio Code.

<table><tr> <td style="width: 120px; text-align: center"><img src="https://upload.wikimedia.org/wikipedia/en/thumb/7/7d/Bazel_logo.svg/240px-Bazel_logo.svg.png" height="120"/></td> <td style="width: 120px; text-align: center"><img src="https://user-images.githubusercontent.com/50580/78734740-486ba400-7906-11ea-89fa-f207544de185.png" height="100"/></td> <td style="width: 120px; text-align: center"><img src="https://user-images.githubusercontent.com/29654835/27530004-e789a11e-5a13-11e7-8a34-870da7e678ac.PNG" height="100"/></td> </tr><tr> <td style="text-align: center">Bazel</td> <td style="text-align: center">Stack</td> <td style="text-align: center">VSCode</td> </tr></table>

Documentation

https://docs.stack.build/docs/vscode/installation

Marketplace

https://marketplace.visualstudio.com/items?itemName=StackBuild.bazel-stack-vscode

This extension provides editor support for the starlark language and the bazel dialect of starlark.

The following operating systems are supported:

• linux
• mac
• windows

NOTE: while the list above is sorted alphabetically, windows is not an afterthought; one of the main supporters of bazel-stack-vscode is a windows-only shop).

Contributions

The major contribution points include:

Language

• starlark language (matches .sky, .star files).
• bazel language (matches BUILD, BUILD.bazel, .bzl and related files).
• bazelrc language (matches .bazelrc and related files).

Grammar

• starlark grammar (syntax highlighting for starlark language).
• bazel grammar (syntax highlighting for bazel language).
• bazelrc grammar (syntax highlighting for bazelrc language).

Commands

See Keybindings for description of commands bound to keyboard shortcuts. Other commands included are typically meant to be activated by menus or buttons (see Tools).

Keybindings

• shift+cmd+space runs the bsv.bzl.redo command; to use this, click on a build/test code action to run it the first time; then slap the space bar while holding down the command key to quickly rebuild/retest it.
• ctrl+shift+cmd+b runs the bsv.bzl.copyLabel command. To use this, place your cursor in the name of a build rule (e.g. name = "my_f|oo_library") and stroke the keybinding; the full label //pkg/app:my_foo_library will be copied to the clipboard.
• cmd+; runs the bsv.bzl.goToLabel command. To use this, stroke the keybinding (designed to be ergonomically similar to the builtin cmd+p menu); this will open an input box where you can type/paste in a bazel label; press ENTER to move to the rule/file implied by the label.
• shift+cmd+t runs the workbench.view.extension.bazel-explorer command. This will show the Tools.
• ctrl+shift+cmd+p runs the bsv.buildozer.wizard command. To use this, stroke the keybinding; a sequence of input boxes / picks will guide you through formulating a buildozer command.

View

• The bazel-explorer contains a number of so-called Tools. Each tool has a similar look-and-feel for enablement, configuration, documentation/help, and possible launch/execution of the tool. See Tools for reference.

Debugger

• Support for bazel language debugging via the debug adapter protocol. See description of the Starlark Debugger Tool for details.

Breakpoint

• Support for setting breakpoints for the bazel language. See Debugger.

Snippet

Assorted bazel language snippets for templating out rule, provider implementations, etc.

Tools

The activity view contains a list of tree items; each top-level item represents a "tool". The tool may be something like buildifier, which actually downloads and runs an executable; or something like a service that shows information (e.g. bazel info).

Each "tool" component has a set of configurable elements; to configure them either expand the Settings tree item and click on it, or go directly to your user/workspace settings and hunt for the corresponding configuration item (e.g. bsv.bzl.lsp.enableCodelenses).

Buildifier Tool

Buildifier provides linting and formatting support for the bazel language. It is highly recommended to always format on save: to do this, add the following to your settings.json:

"[bazel]": {
    "editor.formatOnSave": true
}

Buildozer Tool

Buildozer performs bulk editing of BUILD files and can be very useful for various refactoring activities. If you are buildozer expert, you may not need this. For the rest of us who use buildozer relatively infrequently, you can use the bsv.buildozer.wizard to help step through the various possibilities and construct a buildozer command. See Keybindings.

Starlark Debugger Tool

The starlark debugger tool launches the debug adapter tool when a bazel language debug session is starting. You can customize the settings used for the adapter or the bazel server.

See the Debugging section of the docs for more details.

Starlark Language Server Tool

The starlark language server provides LSP support for the bazel and starlark languages. Supported features include:…