parol-ls 4.2.0

Language server for parol parser generator
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# parol-ls README


<!-- markdownlint-disable Inline HTML -->

<br>
<img src="https://github.com/jsinger67/parol/raw/main/crates/parol-ls/images/ParolLS_300x300.png" alt="Logo" height=300 with=300>
<br><br><br>
<!-- markdownlint-enable Inline HTML -->

This project provides a Language Server to support
[`parol`](https://github.com/jsinger67/parol.git)'s syntax of grammar description files (.par files).

It is used for instance by
[Parol's VSCode extension](https://marketplace.visualstudio.com/items?itemName=jsinger67.parol-vscode)

This Language Server is developed with the help of `parol` itself.

## Features


The Language Server currently supports

* GotoDefinition
* Hover
* Document symbols
* Renaming non-terminal symbols (except the start symbol)
* Formatting the source configurable via format settings
* and shows syntax errors as you are used to.

Also problems in your grammar are detected and reported.

<!-- markdownlint-disable Inline HTML -->

<br>
<img src="https://github.com/jsinger67/parol/raw/main/crates/parol-ls/images/Example.png" alt="Example">
<br><br><br>
<!-- markdownlint-enable Inline HTML -->

This tool is still in early development phase. But it can be used in conjunction with Parol's VSCode
extension.

## Installation


Please install this language server on your platform using the following command.

```shell
cargo install --force parol-ls
```

Also check regularly for updates and issue the command above again on demand.

## Acknowledgements


I took some snippets and inspirations from the language server for
[Lelwel](https://github.com/0x2a-42/lelwel.git).
It is licensed under MIT and Apache-2.0. Thanks a lot and kudos!

## Further readings


* [CHANGELOG](https://github.com/jsinger67/parol/blob/main/crates/parol-ls/CHANGELOG.md)