Skip to content
<open-source>
Oeiuwq Faith Blog OpenSource Porfolio

waxeye-org/waxeye

Waxeye is a parser generator based on parsing expression grammars (PEGs). It supports C, Java, JavaScript, Python, Racket, and Ruby.
Source code at GitHub https://waxeye-org.github.io/waxeye/index.html
waxeye-org/waxeye.json
{
  "createdAt": "2008-10-23T17:07:48Z",
  "defaultBranch": "master",
  "description": "Waxeye is a parser generator based on parsing expression grammars (PEGs). It supports C, Java, JavaScript, Python, Racket, and Ruby.",
  "fullName": "waxeye-org/waxeye",
  "homepage": "https://waxeye-org.github.io/waxeye/index.html",
  "language": "Racket",
  "name": "waxeye",
  "pushedAt": "2023-01-07T02:17:06Z",
  "stargazersCount": 235,
  "topics": [],
  "updatedAt": "2025-06-16T20:56:59Z",
  "url": "https://github.com/waxeye-org/waxeye"
}

404: Not FoundWaxeye Parser Generator [![Build Status][badge-travis]][travis]

Section titled “404: Not FoundWaxeye 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

Section titled “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

Section titled “User Manual”

Waxeye’s user manual is in docs/manual.html. The latest version is also online at http://waxeye.org/manual.html.

Installation

Section titled “Installation”

Unix and OSX

Section titled “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

Section titled “Windows”

  1. Extract the files of the distribution.

  2. Copy the waxeye directory to where you wish to install it.

Running

Section titled “Running”

Unix and OSX

Section titled “Unix and OSX”

Use the waxeye command.

Windows

Section titled “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

Section titled “Building from Source”

  1. Install Racket

  2. Build Waxeye

    • Unix and OSX

      Terminal window
      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

Section titled “Running tests”

First, install all packages necessary for running the tests. On Ubuntu, run:

Terminal window
sudo apt-get install racket nodejs ant checkstyle testng

To then run all the tests, run:

Terminal window
make test-all

To run individual language tests, make the respective target, e.g. for JavaScript:

Terminal window
make test-javascript

Support

Section titled “Support”

License

Section titled “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