| Waxeye Parser Generator | | v 0.4.0 | | www.waxeye.org | | Copyright © 2008 Orlando D. A. R. Hill |

What is Waxeye?

Waxeye makes language development easy and fun. With Waxeye, you can rapidly explore ideas for the syntax of your language.

Whether you are creating a full programming language, a domain-specific language or just a simple data format, Waxeye will get you there faster.

Features

  • Scanner-less Parsing

  • Language Independent, Reusable Grammars

  • Modular, Composable Grammars

  • Grammar Testing

  • Automatic AST Generation

  • Choice of Programming Language

    • Java

    • Ruby

    • Scheme

User Manual

Waxeye’s user manual is in ‘docs/manual.html’ and ‘docs/manual.pdf’. The latest version is also online at waxeye.org/manual.html.

Installation

Unix, 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.

Building

  1. Install MzScheme v372; either with DrScheme or alone. download.plt-scheme.org

  2. Install Waxeye’s backend for PLT Scheme.

Unix, OSX:

sudo ln -s /usr/local/waxeye/src/scheme/waxeye /usr/local/plt/lib/plt/collects/

Windows:

Copy the dir 'src/scheme/waxeye' into your PLT-Scheme collections directory.

  1. Build Waxeye

Unix, OSX:

./build/unix

Windows:

TODO: Translate 'build/unix' to a Windows equivalent.

Running

Unix, OSX: Use ‘waxeye’.

Windows: Use a command prompt to run ‘waxeye.exe`.

License

MIT/X11 - All files (except the user manual) are under the permissive MIT/X11 license.

GNU FDL - Waxeye’s user manual is under the GNU Free Documentation License. This includes all files in the ‘doc/book’ directory, ‘doc/manual.html’ and ‘doc/manual.pdf’.

Support

Feel free to contact me, if you are having trouble or want to give feedback.

Either email me directly: orlandodarhill at Gmail.com

Or signup and post on the mailing list: lists.sourceforge.net/lists/listinfo/waxeye-users