1 month ago
source link: https://github.com/dzhu/openscad-language-server
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.


openscad-language-server is an LSP (Language Server Protocol) server for OpenSCAD. It enables IDE-style features for OpenSCAD code in any editor for which an LSP client is available—i.e., most major modern text editors.

Status: Pretty basic by IDE standards, but functional and well beyond what the built-in OpenSCAD editor provides. Tested primarily with lsp-mode on Emacs on Linux.


  • context-aware completion
  • insertion of useful snippets upon completion
  • live diagnostic messages for syntax errors
  • function/module signatures on hover
  • handling of include/use (of both local and library files)
  • reasonable robustness in the presence of ill-formed input files


openscad-language-server is written in Rust and does not depend on OpenSCAD. Currently, in order to use it, you need to have a Rust toolchain installed.

To install the server from crates.io (puts the binary into ~/.cargo/bin/openscad-language-server):

cargo install openscad-language-server

To build directly from the repository (puts the binary into target/release/openscad-language-server in the clone):

git clone https://github.com/dzhu/openscad-language-server
cd openscad-language-server
cargo build --release


Consult the documentation for your editor and its LSP client to configure them to use the server binary for OpenSCAD files. The server communicates over standard input/output.


Parsing of OpenSCAD code is handled by tree-sitter and tree-sitter-openscad. Communicating over LSP is handled by lsp-server. Having those crates handling all the dirty details of interacting with the outside world has made it possible to get started on this project quite quickly and stay focused on the interesting parts in the middle.

Related work

About Joyk

Aggregate valuable and interesting links.
Joyk means Joy of geeK