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
58
59
60
61
62
63
64
65
66
67
68
69
70
|
# Tools (Stand-alone, Nearley)
## Stand-alone parser
Lark can generate a stand-alone LALR(1) parser from a grammar.
The resulting module provides the same interface as Lark, but with a fixed grammar, and reduced functionality.
Run using:
```bash
python -m lark.tools.standalone
```
For a play-by-play, read the [tutorial](http://blog.erezsh.com/create-a-stand-alone-lalr1-parser-in-python/)
## Importing grammars from Nearley.js
Lark comes with a tool to convert grammars from [Nearley](https://github.com/Hardmath123/nearley), a popular Earley library for Javascript. It uses [Js2Py](https://github.com/PiotrDabkowski/Js2Py) to convert and run the Javascript postprocessing code segments.
#### Requirements
1. Install Lark with the `nearley` component:
```bash
pip install lark[nearley]
```
2. Acquire a copy of the Nearley codebase. This can be done using:
```bash
git clone https://github.com/Hardmath123/nearley
```
#### Usage
The tool can be run using:
```bash
python -m lark.tools.nearley <grammar.ne> <start_rule> <path_to_nearley_repo>
```
Here's an example of how to import nearley's calculator example into Lark:
```bash
git clone https://github.com/Hardmath123/nearley
python -m lark.tools.nearley nearley/examples/calculator/arithmetic.ne main ./nearley > ncalc.py
```
You can use the output as a regular python module:
```python
>>> import ncalc
>>> ncalc.parse('sin(pi/4) ^ e')
0.38981434460254655
```
The Nearley converter also supports an experimental converter for newer JavaScript (ES6+), using the `--es6` flag:
```bash
git clone https://github.com/Hardmath123/nearley
python -m lark.tools.nearley nearley/examples/calculator/arithmetic.ne main nearley --es6 > ncalc.py
```
#### Notes
- Lark currently cannot import templates from Nearley
- Lark currently cannot export grammars to Nearley
These might get added in the future, if enough users ask for them.
|
