https://github.com/rikulo/jison2dart
Generate Dart parsers using Jison - Bison/Yacc in JavaScript
https://github.com/rikulo/jison2dart
bison dart dart-parser flutter jison yacc
Last synced: 5 months ago
JSON representation
Generate Dart parsers using Jison - Bison/Yacc in JavaScript
- Host: GitHub
- URL: https://github.com/rikulo/jison2dart
- Owner: rikulo
- License: mit
- Created: 2020-01-10T08:01:46.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-30T14:10:11.000Z (about 2 years ago)
- Last Synced: 2025-05-09T00:44:49.751Z (5 months ago)
- Topics: bison, dart, dart-parser, flutter, jison, yacc
- Language: Dart
- Homepage: https://quire.io
- Size: 69.3 KB
- Stars: 5
- Watchers: 7
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# jison2dart
Generate Dart parsers using [Jison](https://github.com/zaach/jison) - [Bison](https://www.gnu.org/software/bison/)/Yacc in JavaScript.
## Getting Started
First, you have to prepare [Nodejs](https://nodejs.org/en/) for your environment, and install `jison`.
```
git clone git@github.com:rikulo/jison2dart.git
cd jison2dart/lib/js
npm install
```
Then, you can compile a Jison file to a Dart parser. For example,
```
cd example
node ../lib/js/jison2dart.js calculator.jison
```
For more options, please run
```
node bison.js --help
```
The Dart file will contain a class depending on the jison filename. For example,
```
class Caculator extends DefaultJisonParser {
Object parse() {
...
```
To use the Dart parser in your application, you have to put `jison2dart` to your `pubspec.yaml`.
Then, you can use the parser. For example,
```
print(Caculator().parse("2 * 3"));
```
## Special Extensions
### `%library`
Optional. Generates the library statement in the Dart pasrer.
```
%library my.lib
```
### `%class`
Optional. Specfies the name of the Dart pasrer.
```
%class CalcParser
```
If you'd like to override it, say, for different platforms, you can specify `abstract` too:
```
%class abstract ParserBase
```
### `%extends`
If you'd like to extend from your custom class, you can specify it as follows:
```
%extends MyGenericParser
```
Note: Your implementation must implement `JisonParser`, or extends `DefaultJisonParser`.
### `%case-sensitive`
By default, the lexer is case senstive. You can turn off as follows:
```
%case-sensitive false
```
### The prologue: `%{` and `%}`
Optional. If you'd like to import other libraries or embed Dart codes, you can put the code between `%{` and `%}`.
```
%{
import "super/foo.dart";
String camelize(String text) {
...
}
}%
```
> Note: unlike [Bison's prologue](https://www.gnu.org/software/bison/manual/html_node/Prologue.html), you can put at most one prologue.
## Resources
* [API Reference](https://pub.dev/documentation/jison2dart/latest)
* [Git Repos](https://github.com/rikulo/jison2dart)
## Who Uses
* [Quire](https://quire.io) - a simple, collaborative, multi-level task management tool.
* [Keikai](https://keikai.io) - a sophisticated spreadsheet for big data