This language server is still in a very early development stage.
The goal of this project is to make a fully functional Language Server for Pkl language and have lots of fun.
I would really love to make it a community driven project, so don't hesitate to contribute or help in any way possible.
The Discord Server is there for any question, help, advice or just casual chatting.
Also check out Unofficial Pkl Community Discord Server, lots of great people there discussing Pkl. They also have a channel about LSPs!
And don't forget to check Code of Conduct.
| Feature | Status |
|---|---|
| Completion | 🟢 |
| Definition | 🟢 |
| Diagnostics | 🟢 |
| Document Symbols | 🟢 |
| Renaming | 🟠 |
| Semantic Highlighting | TBA |
- 🟢 -- Feature is working
- 🟠 -- Feature is working, however due to early development stage may be incomplete or not working as intended (disabled by default, can be enabled with
--enable-experimental-features) - 🔴 -- Not planned
- TBA -- Work on the feature is not yet in progress, but it's being looked into
- WIP -- Development work on the feature is actively progressing
-
Module imports are indexed for completion only with relative paths or standard pkl library.
import*expression also does not work yet. -
Diagnostics are working on a basic level. Type checking isn't a thing yet.
Install libjemalloc:
(Alternatively, you can comment out benchmarking target in Package.swift and skip this step)
# macOS (Homebrew)
brew install jemalloc
# Linux
sudo apt install libjemalloc-dev
Clone repository and build the project:
git clone https://github.com/jayadamsmorgan/PklLanguageServer --recurse-submodules
cd PklLanguageServer
make install
You will be prompted to type in your password so the server could be installed to /usr/local/bin folder.
Now you can run the server with:
pkl-lsp-server
Check help for more options:
pkl-lsp-server -h
pkl-lsp-server will use standard output and JSONRPC connection with error log level to print logs.
pkl-lsp-server -log debug will print out logs with debug log level.
Use your client's LSP log or standard output to check the logs.
Huge shoutout to Mattie, creator of LanguageServerProtocol and SwiftTreeSitter libraries.
This project could not have been possible without his great work and huge help. Check out his awesome blog.