jq-lsp

jq language server.

You probably want to use this via one of these:

• vscode-jq
• neovim using nvim-lspconfig and mason.nvim
• Emacs using lsp-mode

It can currently do:

• Syntax checking.
• Error on missing function or binding.
• Goto definition of function or binding.
• Auto complete function and binding.
• Include/Import support.
• Hover definition of function.
• Hover documentation for builtin.
• Function symbols per document.
• Read additional builtins from .jq-lsp.jq.

Own builtins and global variables using .jq-lsp.jq

jq-lsp will automcatically include .jq-lsp.jq in the smae directory as the file being edited.

Example .jq-lsp.jq file adding builtin new_builtin and global variable $new_variable:

# body will be ignored
def new_builtin: empty;
def $new_variable: empty;

Install

# install directly
go install github.com/wader/jq-lsp@master
# copy binary to $PATH
cp "$(go env GOPATH)/bin/jq-lsp" /usr/local/bin

# build binary from cloned repo
go build -o jq-lsp .

Development

# run all tests
go test -v ./...
# run tests and update responses
go test -v ./... -update

Thanks

jq-lsp uses a modified version of itchyny's gojq parser.

builtins documentation is based on https://github.com/stedolan/jq/blob/master/docs/content/manual/manual.yml and is licensed under https://github.com/stedolan/jq/blob/master/COPYING

TODO and ideas

• Semantic tokens
• Own parser or modified gojq parser to be able to recover and give more useful errors
• Server loop and itchyny/gojq#86
• Warn about unused functions and bindings
• Better at handling broken syntax while typing
  • $<cursor>/@<cursor> auto complete, add temp name?
  • a | n<cursor> f, add temp name/try fix syntax?
• Transitive include behavior (jq/gojq behaves differently?)
• Source formatting
  • Requires whitespace/comment support in lexer/parser
• Goto definition for builtin functions somehow
• Input completion. How to indicate input and to do safe eval?
• REPL or some kind of eval support?
  • See https://github.com/ailisp/commonlisp-vscode