Bunzo

Official Visual Studio Code support for the Bunzo Programming Language.

Bunzo is a modern, developer-friendly language designed to reduce boilerplate and simplify application development. This extension provides full editor integration for Bunzo projects, utilizing the Bunzo Language Server to deliver IDE features.

Features

This extension integrates rich language features:

• Syntax Highlighting: Complete syntax coloring for Bunzo keywords, operators, classes, types, and literals.
• Auto Completion: Intelligent code suggestions for variables, functions, structs, classes, and standard library modules.
• Language Server Protocol (LSP): Integrates directly with bzc lsp to provide robust editor services.
• Diagnostics: Real-time syntax and type checking, highlighting errors directly in your editor.
• Formatting: Auto-formats your code instantly on save or format command using bzc fmt.
• Hover Information: Detailed type signatures and docstring tooltips when hovering over symbols and built-ins.
• Go To Definition: Quick navigation to variable, function, struct, and class declarations across your project.
• Document Symbols: Outline and structure view showing all classes, methods, and functions in the active file.

Screenshots

Below are placeholders for the extension interface in action:

Syntax Highlighting & Auto-Completion

[!NOTE] Screenshots showing syntax coloring and code suggestion tooltips will be added here.

Diagnostics & Error Highlighting

[!NOTE] Screenshots showing compiler error squiggles and diagnostics messages will be added here.

Installation

1. Open Visual Studio Code.
2. Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X).
3. Search for Bunzo.
4. Click Install.

Requirements

To utilize the language server features (such as Diagnostics, Formatting, Hover, and Go To Definition), you must install the Bunzo compiler and add it to your system PATH.

Windows Installer (Recommended)

Download and run the latest installer from the official release page: bunzo-0.8.0-alpha-windows-x64-setup.exe

Using WinGet (Windows Package Manager)

You can easily install the Bunzo compiler using the following command in PowerShell:

winget install UgeshPraavin.Bunzo

PATH Configuration

Ensure that the directory containing bzc (or bzc.exe) is added to your system PATH. If you used the Windows Installer, this is configured automatically.

Extension Settings

Configure the extension behavior under VS Code Settings (Ctrl+, or Cmd+,):

• bunzo.compilerPath: Absolute path to the Bunzo compiler executable (bzc). Default: "bzc".
• bunzo.useCompilerLsp: Set to true to launch the native compiler-based LSP server (bzc lsp) instead of the default Node-based client. Default: false.
• bunzo.trace.server: Traces the JSON-RPC communication between VS Code and the Bunzo language server. Options: off, messages, verbose. Default: "off".

Example

Write your first Bunzo program! Create a file named hello.bz and add:

// A Hello World example in Bunzo
func main() {
    let message = "Hello, World!"
    print(message)
}

main()

Known Issues

• The compiler-based LSP (bzc lsp) requires compiler version v0.8.0 or higher.
• Multi-folder workspaces are not fully supported yet in the language server context.

Contributing

Contributions are welcome! Please check out the Contributing Guide and report issues on our GitHub Issue Tracker.

License

This extension is licensed under the MIT License.