131 lines
6.6 KiB
Markdown
131 lines
6.6 KiB
Markdown
|
|
|
|
|
|
|
|
|
|
Zig Language Server, or `zls`, is a language server for Zig. The Zig wiki states that "The Zig community is decentralized" and "There is no concept of 'official' or 'unofficial'", so instead of calling `zls` unofficial, and I'm going to call it a cool option, one of [many](https://github.com/search?q=zig+language+server).
|
|
|
|
<!-- omit in toc -->
|
|
## Table Of Contents
|
|
- [Installation](#installation)
|
|
- [Build Options](#build-options)
|
|
- [Configuration Options](#configuration-options)
|
|
- [Usage](#usage)
|
|
- [VSCode](#vscode)
|
|
- [Sublime Text 3](#sublime-text-3)
|
|
- [Kate](#kate)
|
|
- [Neovim/Vim8](#neovimvim8)
|
|
- [Related Projects](#related-projects)
|
|
- [License](#license)
|
|
|
|
## Installation
|
|
|
|
Installing `zls` is pretty simple;
|
|
|
|
```bash
|
|
git clone --recurse-submodules https://github.com/zigtools/zls
|
|
cd zls
|
|
zig build
|
|
|
|
# To configure ZLS:
|
|
zig build config
|
|
```
|
|
|
|
### Build Options
|
|
|
|
| Option | Type | Default Value | What it Does |
|
|
| --- | --- | --- | --- |
|
|
| `-Ddata_version` | `string` (master or 0.6.0) | 0.6.0 | The data file version. This selects the files in the `src/data` folder that correspond to the Zig version being served.
|
|
|
|
Then, you can use the `zls` executable in an editor of your choice that has a Zig language server client!
|
|
|
|
*Note: `zls` itself must be built using the master branch of zig currently due to a bug in `std.json` which was [fixed](https://github.com/ziglang/zig/pull/5167) after 0.6.0 was released, as well as various parser changes that have happened since.*
|
|
|
|
### Configuration Options
|
|
|
|
You can configure zls by providing a zls.json file.
|
|
zls will look for a zls.json configuration file in multiple locations with the following priority:
|
|
- In the folders open in your workspace (this applies for files in those folders)
|
|
- In the local configuration folder of your OS (as provided by [known-folders](https://github.com/ziglibs/known-folders#folder-list))
|
|
- In the same directory as the executable
|
|
|
|
The following options are currently available.
|
|
|
|
| Option | Type | Default value | What it Does |
|
|
| --- | --- | --- | --- |
|
|
| `enable_snippets` | `bool` | `false` | Enables snippet completion, set to false for compatibility with language clients that do not support snippets (such as ale). |
|
|
| `zig_lib_path` | `?[]const u8` | `null` | zig library path, e.g. `/path/to/zig/lib/zig`, used to analyze std library imports. |
|
|
| `zig_exe_path` | `?[]const u8` | `null` | zig executable path, e.g. `/path/to/zig/zig`, used to run the custom build runner. If `null`, zig is looked up in `PATH`. Will be used to infer the zig standard library path if none is provided. |
|
|
| `warn_style` | `bool` | `false` | Enables warnings for style *guideline* mismatches |
|
|
| `build_runner_path` | `?[]const u8` | `null` | Path to the build_runner.zig file provided by zls. This option must be present in one of the global configuration files to have any effect. `null` is equivalent to `${executable_directory}/build_runner.zig` |
|
|
|
|
## Usage
|
|
|
|
`zls` will supercharge your Zig programming experience with autocomplete, function documentation, and more! Follow the instructions for your specific editor below:
|
|
|
|
### VSCode
|
|
|
|
Install the `zls-vscode` extension from [here](https://github.com/zigtools/zls-vscode/releases).
|
|
|
|
### Sublime Text 3
|
|
|
|
- Install the `LSP` package from [here](https://github.com/sublimelsp/LSP/releases) or via Package Control.
|
|
- Add this snippet to `LSP's` user settings:
|
|
```json
|
|
{
|
|
"clients": {
|
|
"zig":{
|
|
"command": ["zls"],
|
|
"enabled": true,
|
|
"languageId": "zig",
|
|
"scopes": ["source.zig"],
|
|
"syntaxes": ["Packages/Zig/Syntaxes/Zig.tmLanguage"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Kate
|
|
|
|
- Enable `LSP client` plugin in Kate settings.
|
|
- Add this snippet to `LSP client's` user settings (e.g. /$HOME/.config/kate/lspclient)
|
|
(or paste it in `LSP client's` GUI settings)
|
|
```json
|
|
{
|
|
"servers": {
|
|
"zig": {
|
|
"command": ["zls"],
|
|
"url": "https://github.com/zigtools/zls",
|
|
"highlightingModeRegex": "^Zig$"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Neovim/Vim8
|
|
|
|
- Install the CoC engine from [here](https://github.com/neoclide/coc.nvim).
|
|
- Issue `:CocConfig` from within your Vim editor, and the following snippet:
|
|
```json
|
|
{
|
|
"lanuageserver": {
|
|
"zls" : {
|
|
"command": "command_or_path_to_zls",
|
|
"filetypes": ["zig"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Related Projects
|
|
- [`sublime-zig-language` by @prime31](https://github.com/prime31/sublime-zig-language)
|
|
- Supports basic language features
|
|
- Uses data provided by `src/data` to perform builtin autocompletion
|
|
- [`zig-lsp` by @xackus](https://github.com/xackus/zig-lsp)
|
|
- Inspiration for `zls`
|
|
- [`known-folders` by @ziglibs](https://github.com/ziglibs/known-folders)
|
|
- Provides API to acces known folders on Linux, Windows and Mac OS
|
|
|
|
## License
|
|
MIT
|