Be advised that this is a work in progress repository and is not yet considered as a fully functional VSCode extension.

Client side:

• Syntax highlighting

LSP-server:

• Highlighting of miscellaneous type of errors
• Auto-completion

In order to build and use this extension, you will need to install:

• OPAM, the OCaml package manager
• npm, the JavaScript package manager

As this extension is still a work in progress, it uses some Catala compiler's experimental features that are yet to be merged in the published OPAM's Catala package. Therefore, it requires to also clone Catala and install the experimental branch locally through these steps:

git clone https://github.com/CatalaLang/catala.git
cd catala
git checkout vbot@lsp-tools
opam pin add catala .

Instead of pinning the experimental version, it is also possible to copy the Catala's cloned repository (including the branch switch) to server/vendors/.

# 1. Clone this repository
git clone https://github.com/CatalaLang/catala-language-server/
# 2. Go to the directory
cd catala-language-server/
# 3. Install the JS dependencies
npm install
# 4. Install the OCaml dependencies
cd server ; opam install . --deps-only ; cd ..
# 5. Build the extension
npm run compile

1. Open VSCode at the repository's root (e.g., in a terminal $ code .)
2. Go to "Run and Debug" in the VSCode sidebar (invoked by command "View: Show Run and Debug")
3. Choose "Launch Client" and click on the play button
4. A new VSCode window should open with the extension running
   • you can press CTRL+R to reload the extension window to apply changes

All the code contained in this repository is released under the Apache license (version 2) unless another license is explicited for a sub-directory.