IDE & Tooling

The BoxLang IDE leverages VSCode!

We have an official first-party extension for VSCode. You can find it in the VSCode marketplace.

Features at a Glance

• Language server integration

  • Inline documentation

  • Launguage hints

  • Type information (experimental)

• Built-in debugger

• Mini BoxLang web server for quick development/testing

Language Server

The extension bundles a language server based on the BoxLang runtime that gives VSCode access to the same information used when executing your sourcecode. This provides us the ability to display rich information right in the editor.

Some features provided by the language server are

Code outlines

Function definition

Type hinting (experimental - must configure in settings)

Much functionality is still provided through the old JavaScript API. It is being converted to use the language server ASAP.

Debugger

The debugger is implemented in Java using the JDP. It provides complete control over a running BoxLang application.

The extension provides quick ways to run your BoxLang programs. Simply right-click within a .bxs file or class (.bx) that implements a main method and select "BoxLang: Run File".

You can use it to debug command line scripts or the built-in web server.

Mini Web Server

The MinServer provides a lightweight web runtime powered by undertow. Simply hit ctrl+shift+p to bring up the command palette and select "BoxLang: Run Web Server". When you run the command it will open up the MinServer on the configured port (defaults to 8085) and open your browser.

The web server will automatically be configured to use your projects directory as the web root. You will be prompted to select your web root if you have more than one folder open in your workspace.

Contributing

Checkout the git repository for our extension.

Feel free to create an issue if you are having any problemsor want to create a feature request. Pull requests are welcome as well.