[!IMPORTANT]
Next LS now has support for Credo, so Credo Language Server will not receive further significant updates.
credo-language-server
![GitHub Discussions](https://img.shields.io/github/discussions/elixir-tools/discussions)
credo-language-server is an LSP implementation for Credo.
Features
- Project wide diagnostics
- Code Actions
Editor Support
- Neovim: elixir-tools.nvim
- VSCode: elixir-tools.vscode
-
Emacs
#### Using lsp-mode:
credo-language-server is included with [lsp-mode](https://github.com/emacs-lsp/lsp-mode) and can be installed by running `M-x lsp-install-server credo-language-server`.
You might want to set the lsp-credo-version to the latest release:
```elisp
(custom-set-variables '(lsp-credo-version "0.1.3"))
```
or by running `M-x customize-group lsp-credo` and updating the version.
Visit [lsp-mode](https://github.com/emacs-lsp/lsp-mode) for detailed
installation instructions.
#### Using eglot:
```elisp
(require 'eglot)
(add-to-list 'exec-path "path/to/credo-language-server/bin")
(with-eval-after-load 'eglot
(add-to-list 'eglot-server-programs
`((elixir-ts-mode heex-ts-mode elixir-mode) .
("credo-language-server" "--stdio=true"))))
(add-hook 'elixir-mode-hook 'eglot-ensure)
(add-hook 'elixir-ts-mode-hook 'eglot-ensure)
(add-hook 'heex-ts-mode-hook 'eglot-ensure)
```
Eglot only allows one server per mode, but it is possible to
configure eglot alternatives to prompt for a specific language server.
```elisp
(require 'eglot)
(setq exec-path
(append exec-path
'("path/to/credo-language-server/bin"
"path/to/elixir-ls/bin")))
(add-to-list
'eglot-server-programs
`((elixir-mode elixir-ts-mode heex-ts-mode) .
,(eglot-alternatives
`(,(if (and (fboundp 'w32-shell-dos-semantics)
(w32-shell-dos-semantics))
'("language_server.bat")
'("language_server.sh"))
("credo-language-server" "--stdio=true")))))
```
-
Helix
Here is an example configuration for `languages.toml`
```toml
[[language]]
name = "elixir"
scope = "source.elixir"
injection-regex = "elixir"
file-types = ["ex", "exs"]
roots = ["mix.exs"]
auto-format = false
diagnostic-severity = "Hint"
comment-token = "#"
indent = {tab-width = 2, unit = " "}
language-servers = ["elixir-ls", "credo"]
[language-server.elixir-ls]
command = "elixir-ls"
config = { elixirLS.dialyzerEnabled = true }
[language-server.credo]
command = "/path/to/executable/credo-language-server"
args = ["--stdio=true", "--port=999"]
```
Installation
The preferred way to use credo-language-server is through one of the supported editor extensions.
If you need to install credo-language-server on it's own, you can download the executable hosted by the GitHub release. The executable is an Elixir script that utilizes Mix.install/2
.
Note
Credo Language Server creates an .elixir-tools
hidden directory in your project.
This should be added to your project's .gitignore
.
Code Actions
DisableCheck
Check: all
If there is a check that you'd wish to disable, you can trigger the code action on that line to insert a magic comment to disable that check.
ModuleDocFalse
Check: Credo.Check.Readability.ModuleDoc
Inject a @moduledoc false
snippet into the module.
Contributing
Running tests
# setup the test project
$ (cd test/support/project && mix deps.get)
# run the tests
$ mix test
Built with gen_lsp