Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/waxeye-org/waxeye
Waxeye is a parser generator based on parsing expression grammars (PEGs). It supports C, Java, JavaScript, Python, Racket, and Ruby.
https://github.com/waxeye-org/waxeye
Last synced: 2 months ago
JSON representation
Waxeye is a parser generator based on parsing expression grammars (PEGs). It supports C, Java, JavaScript, Python, Racket, and Ruby.
- Host: GitHub
- URL: https://github.com/waxeye-org/waxeye
- Owner: waxeye-org
- License: other
- Created: 2008-10-23T17:07:48.000Z (about 16 years ago)
- Default Branch: master
- Last Pushed: 2023-01-07T02:17:06.000Z (about 2 years ago)
- Last Synced: 2024-08-03T22:04:52.187Z (6 months ago)
- Language: Racket
- Homepage: https://waxeye-org.github.io/waxeye/index.html
- Size: 1.24 MB
- Stars: 235
- Watchers: 18
- Forks: 39
- Open Issues: 48
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-racket-and-scheme - waxeye
README
Waxeye Parser Generator [![Build Status][badge-travis]][travis]
===============================================================
Waxeye is a parser generator based on parsing expression grammars (PEGs). It
supports C, Java, Javascript, Python, Ruby and Scheme.
Features
--------
* Choice of Programming Language
- C
- Java
- Javascript
- Python
- Ruby
- Racket
* Scanner-less Parsing
* Automatic AST Generation
* Language Independent, Reusable Grammars
* Modular, Composable Grammars
* Grammar Testing
User Manual
-----------
Waxeye's user manual is in `docs/manual.html`. The latest version is also
online at http://waxeye.org/manual.html.
Installation
------------
### Unix and OSX
1. Extract the files of the distribution.
2. Copy the `waxeye` directory to where you wish to install it.
3. Add the `bin/waxeye` binary to your search path. e.g. If you have `~/bin` in
your `PATH` and installed waxeye to `/usr/local/waxeye` then you might do
the following.
`ln -s /usr/local/waxeye/bin/waxeye ~/bin/`
### Windows
1. Extract the files of the distribution.
2. Copy the `waxeye` directory to where you wish to install it.
Running
-------
### Unix and OSX
Use the `waxeye` command.
### Windows
Use a command prompt to run `waxeye.exe`. Note: If using the interpreter under
Windows, you will need to press `Ctrl-z` and then 'Enter' after the input you
want to interpret.
Building from Source
--------------------
1. Install [Racket](http://racket-lang.org)
2. Build Waxeye
* Unix and OSX
```bash
make compiler
```
* Windows
- If your Racket installation isn't `C:\Program Files\Racket`, then you
will need to modify `build\exe.bat` to use the correct path.
- Run the `build\exe.bat` script. The `waxeye.exe` executable
will be saved to the directory you run the script from.
Running tests
-------------
First, install all packages necessary for running the tests.
On Ubuntu, run:
```bash
sudo apt-get install racket nodejs ant checkstyle testng
```
To then run all the tests, run:
```bash
make test-all
```
To run individual language tests, `make` the respective target, e.g. for JavaScript:
```bash
make test-javascript
```
Support
-------
* [Mailing List](https://lists.sourceforge.net/lists/listinfo/waxeye-users)
* [Issue Tracker](https://github.com/waxeye-org/waxeye/issues)
License
-------
MIT -- All files (except the user manual) are under the permissive MIT license.
GNU FDL -- Waxeye's user manual is under the GNU Free Documentation License.
This includes the files `doc/book/book` and `doc/manual.html`.
[badge-travis]: https://img.shields.io/travis/waxeye-org/waxeye.svg
[travis]: https://travis-ci.org/waxeye-org/waxeye