Alive: The Average Lisp VSCode Environment
An attempt to create a Common Lisp extension for VSCode. It's still a work in progress, though getting better.
The name is partly a self-deprecating take on SLIME's name, but also reflects the goal of the project which is to reach Minimum Viable Product status. For VSCode language extensions, there is a lot that is expected for the bare minimum, including formatting, code completion, syntax highlighting, etc.
The LSP server that the extension relies on currently only supports Steel Bank Common Lisp (SBCL). The extension isn't intended to be compiler-specific, but it is at the moment. The server can be found here, https://github.com/nobody-famous/alive-lsp
The following must be installed prior to useing the Alive extension. It is okay for these to be installed after the extension is installed, although you may need to reload your VS Code window after doing so.
This extension contributes the following settings:
Syntax highlighting is done using semantic tokens. This is mainly to avoid regex hell. The following symantic tokens are added:
The current idea is to use VSCode as the REPL, leveraging VSCode features to give a visual insight into the running image.
An inspector can be opened by evaluating an expression in the inspector view or by clicking
There is also an inspector for macros, using the Inspect Macro command. An inspector opens that shows one level of expansion for the macro at the current cursor position. It has a button to refresh the inspector or increment the level of expansion by one. When an expression is sent for evaluation, such as redefining the macro, the expansion is refreshed back to one level.
At the bottom of each inspector view is a text field that can be used to evaluate expressions.
The value in the inspector can be referenced with
If the result of the expression is not
Forms sent for evaluation by the user are run in their own thread. The threads have names like "N - $/alive/eval" where N is a number. The number is used to try to keep the names unique since getting the underlying system id of the threads isn't as easy as it sounds. If one of them gets stuck in an infinite loop or something, it should be safe to terminate the thread using the "X" action in the threads tree view.
Select S-Expression (Alt+Shift+Up)
Selects the surrounding top level expression for the current cursor position.
Send To REPL (Alt+Shift+Enter)
Sends selected text to the REPL. If nothing is selected, sends the top level form at the cursor position.
Load File (Alt+Shift+L)
Load the current file into the REPL.
Inline Evaluation (Alt+Shift+E)
Evaluate the enclosing form, showing the result inline. If there is a selection, evaluates the selected code.
Clear Inline Results (Alt+Shift+C)
Clear the inline results.
REPL History (Alt+Shift+R)
Expressions that are evaluated from the REPL window are added to the history. This command opens a quick pick selector with the history. The most recently used item is at the top, i.e. similar behavior to the Run Tasks command.
Load ASDF System
Tell the REPL to load an ASDF system. A list of known systems will be given to choose from.
Open Scratch Pad
Opens a temporary file,
Macro Expand All
Selected text is passed to macroexpand and expanded in place. If nothing is selected, the form surrounding the cursor is sent.
Macro Expand 1
Selected text is passed to macroexpand-1 and expanded in place. If nothing is selected, the form surrounding the cursor is sent.
An inspector is opened for the currently selected text. If nothing is selected, the form surrounding the cursor is sent.
Unless otherwise noted, all files are in the Public Domain.
No actual releases, yet.