rslua 0.2.8

Yet another Lua lexer and Lua parser for Lua 5.3
Documentation 
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

# rslua 

[![Crates.io](https://img.shields.io/crates/v/rslua)](https://crates.io/crates/rslua)
![Rust](https://github.com/sssooonnnggg/rslua/workflows/Rust/badge.svg)

Yet another Lua lexer and Lua parser for Lua 5.3 written in pure Rust.

## Lexer

- **input** str
- **output** Result<Vec\<Token>, LexError>

```rust
use rslua::lexer::Lexer;
let mut lexer = Lexer::new();
let tokens = lexer.run(input_lua_code)?;
```

### Lexer Config

| Key | Type | Default | Descripten | 
| --- | --- | --- | --- |
| `use_origin_string` | bool | false | Use origin string as token value instead of escaped one. |
| `reserve_comments` | bool | false | Reserve comments as tokens. |

## Parser

- **input** Vec\<Token>
- **output** Result<Block, SyntaxError>

```rust
let mut parser = Parser::new();
let block = parser.run(tokens)?;
```

## AST walker

Use `ast_walker` to travel the AST, implement the `AstVisitor` trait to run custom logic.

## A complete example

Read Lua source files from `./lua` folder, parse them, generate ASTs and walk them through, use a `LuaWritter` struct which impletements the `AstVisitor` trait to re-generate formatted Lua source again to `./tmp` folder.

See [tests/lua_to_lua.rs](tests/lua_to_lua.rs)