Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yunusemredilber/antlr_rust_language
A super simple arithmetic grammar parsing example with ANTLR4 rust target
https://github.com/yunusemredilber/antlr_rust_language
antlr antlr4 hacktoberfest-accepted parsing rust
Last synced: 2 days ago
JSON representation
A super simple arithmetic grammar parsing example with ANTLR4 rust target
- Host: GitHub
- URL: https://github.com/yunusemredilber/antlr_rust_language
- Owner: yunusemredilber
- License: mit
- Created: 2022-10-18T18:42:18.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-10-30T18:40:04.000Z (about 2 years ago)
- Last Synced: 2024-07-30T16:56:20.726Z (6 months ago)
- Topics: antlr, antlr4, hacktoberfest-accepted, parsing, rust
- Language: Rust
- Homepage:
- Size: 16.6 KB
- Stars: 13
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ANTLR Rust Language (Arithmetic)
A super simple language grammar parsing example with ANTLR4 rust target.
It can be used to kicksart a rust based parsing project using ANTLR4.
## Features
- A simple *arithmetic* grammar written in [ANTLR4](https://github.com/antlr/antlr4).
- Building it's ANTLR entites in rust by using [antlr-rust](https://github.com/rrevenantt/antlr4rust).
- Using the generated code to obtain [parse tree](https://en.wikipedia.org/wiki/Parse_tree).
- [Visitor](https://en.wikipedia.org/wiki/Visitor_pattern) implementation to create a basic [AST](https://en.wikipedia.org/wiki/Abstract_syntax_tree).
## Demo
```bash
> Write something like '(3+4)*2' to see the generated AST. ^C to exit:
> 23 * (22 + -3)
Prog(
[
Stat(
BinaryExpr(
"*",
NumberLiteral(23.0),
ParenthesizedExpr(
BinaryExpr(
"+",
NumberLiteral(22.0),
Negative(
NumberLiteral(3.0)
),
),
)
),
)
],
),
```
## Run Locally
Go to the project directory:
```bash
cd antlr_rust_arithmetic
```
Download the [latest](https://github.com/rrevenantt/antlr4rust/releases) custom ANTLR4 build for rust:
```bash
curl -OL https://github.com/rrevenantt/antlr4rust/releases/download/antlr4-4.8-2-Rust0.3.0-beta/antlr4-4.8-2-SNAPSHOT-complete.jar
```
Build and run the application:
```bash
cargo run
```
## Acknowledgements
- Custom ANTLR4 build must to be used until the antlr-rust merge to the main antlr repo.
## Author
- [@yunusemredilber](https://www.github.com/yunusemredilber)