Blues

Blues is a new, in-development, language server aiming to provide first-class IDE features for the Bluespec SystemVerilog language.

[!note] Blues is still early in development. Many crucial features are missing and many sharp edges are left unpolished. Use at your own risk.

Feedback, bug reports and feature requests are greatly appreciated, you can submit these via GitLab issues or email me at runtimetantrum@gmail.com.

Currently, Blues provides the following features:

• Syntax highlighting
• Go-to definition/find references
• Project-wide symbol search
• Diagnostic messages for syntax errors
• Symbol rename
• Folding ranges

Quick start guide

Server component

Latest builds for x86_64 Windows/Linux are available in Releases page.

Alternatively, the LSP server component can be installed via Cargo:

cargo install blues-lsp

Editor integration

VS Code: See extension page

Other editors: TBD. Please consult editor-specific LSP client documentation for integrating an LSP server. Feel free to create an issue for help.

Project setup

To correctly identify source files belonging to a project, Blues currently requires a blues_compdb.json file to be present in a project. For most projects, consisting of a single bsc -u invocation, this minimal example can be used as a template, placed under <PROJECT_ROOT>/blues_compdb.json:

[
  {
    "directory": ".",
    "command": "bsc -u <BSC ARGS>"
  }
]

More info regarding project configuration here

License

This project is licensed under Apache License 2.0. See LICENSE.