Gno for Visual Studio Code

Welcome to the VS Code Gno extension!

This extension provides rich language support for the Gno programming language, including features such as IntelliSense, code navigation, code editing, and testing.

Requirements

• Visual Studio Code 1.75 or newer (or editors compatible with VS Code 1.75+ APIs)
• Go 1.21
• Gno (Gnolang Virtual Machine)

Quick Start

1. Install Go 1.21 or newer (required for automatic installation of missing tools).

2. Install the Gno VM.

3. Install the VS Code Gnolang extension.

   a. Stable releases are available on the Visual Studio Marketplace.

   b. Nightly releases are available on GitHub Releases as .vsix files.

4. Open any Gno file to automatically activate the extension. The Gno status bar appears in the bottom right corner of the window and displays your Go version.

5. The extension depends on go, gno, gnopls (the Gno language server), and optional tools (like gnokey) depending on your settings. If gnopls is missing, the extension will try to install it. The ⚡ sign next to the Gno version indicates the language server is running.

(Install Missing Tools)

You are ready to Gno! 🎉🎉🎉

Feature highlights

• IntelliSense - Results appear for symbols as you type.
• Code navigation - Jump to or peek at a symbol's declaration.
• Code editing - Support for saved snippets, formatting and code organization, and automatic organization of imports.
• Testing - Run or debug tests at the cursor, in the current file, or in the current package.

(Code completion and Signature Help)

(Toggle Test File)

In addition to integrated editing features, the extension provides several commands for working with Gno files. You can access any of these by opening the Command Palette (Ctrl+Shift+P on Linux/Windows or Cmd+Shift+P on macOS), and then typing in the command name.

What's next

• Explore more features of the VS Code Gno extension.
• View the complete command list provided by the extension.
• Customize the extension by changing settings.
• Explore Gno language resources on docs.gno.land.
• Open an issue on GitHub if you encounter any problems or have suggestions for new features.

Contributing

We welcome your contributions and thank you for working to improve the Gno development experience in VS Code. If you would like to help work on the VS Code Gno extension, see our contribution guide to learn how to build and run the VS Code Gno extension locally and contribute to the project.

Credits

A big thank you to the developers of the vscode-go extension for Go. Their work was a huge help in creating this extension for the Gno language, as I adapted their ideas and structure to fit this new context. Thank you for your contribution to open source and for the inspiration!

License

Apache License version 2.0