grammar's Introduction

erlang_ls

An Erlang server implementing Microsoft's Language Server Protocol 3.17.

Minimum Requirements

Supported OTP versions

24, 25, 26

Quickstart

Compile the project:

make

To install the produced erlang_ls escript in /usr/local/bin:

make install

To install to a different directory set the PREFIX environment variable:

PREFIX=/path/to/directory make install

Command-line Arguments

These are the command-line arguments that can be provided to the erlang_ls escript:

Usage: Erlang LS [-v] [-t [<transport>]] [-p [<port>]] [-d [<log_dir>]]
                 [-l [<log_level>]]

  -v, --version    Print the current version of Erlang LS
  -t, --transport  Specifies the transport the server will use for the
                   connection with the client, either "tcp" or "stdio".
                   [default: tcp]
  -p, --port       Used when the transport is tcp. [default: 10000]
  -d, --log-dir    Directory where logs will be written.
                   [default: filename:basedir(user_log, "erlang_ls")]
  -l, --log-level  The log level that should be used. [default: info]

Configuration

It is possible to customize the behaviour of the erlang_ls server via a configuration file, named erlang_ls.config or erlang_ls.yaml. That file should be placed in the root directory of a given project to store the configuration for that project. It is also possible to store a system-wide default configuration, which is shared across multiple projects.

Please refer to the configuration section of the documentation to learn how to configure Erlang LS for a specific project.

Getting in Touch

If you have any questions about the project, feel free to open a new issue. You can also join the #erlang-ls channel in the Erlanger Slack if you would like to get involved or if you prefer a more informal mean of communication.

All contributions are welcome, be them in the form of a bug report, a question, feedback, or code.

I occasionally blog about the project on Medium.

References

https://microsoft.github.io/language-server-protocol/

License

The erlang_ls project is licensed under the Apache License 2.0. Please refer to the LICENSE file for details.

grammar's People

Contributors

Stargazers

Watchers

grammar's Issues

Wrong automatic indentation after trailing operators

Describe the bug
Given the code below:

function() ->
    expr() andalso
        expr().

pressing enter indents the cursor by 8 spaces to align with the final expr().. We end up with:

function() ->
    expr() andalso
        expr().

        |

This is also visible when pasting some code after similar function. For example, manually removing the extra indentation, and then pasting function2() -> ok. ends up with:

function() ->
    expr() andalso
        expr().

    function2() -> ok.

In this case the final indentation is only 4 spaces, rather than the 8 spaces produced by simply pressing enter.

Expected behavior
The indentation should be reset to the left margin given we're outside any function.

Context

erlang_ls version (tag/sha): v0.0.32 of the VS Code extension

erlang-ls / grammar Goto Github PK