| Waxeye Parser Generator | | v 0.7.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

    • C

    • Java

    • Python

    • Ruby

    • Scheme

User Manual

Waxeye’s user manual is in ‘docs/manual.html’. 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 v4; 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 directory ‘src/scheme/waxeye’ into your PLT-Scheme ‘collects’ directory. For example, that might be ‘C:Program FilesPLTcollects’.

  3. Build Waxeye Unix, OSX: ./build/unix

    Windows:

    • If your PLT-Scheme installation isn’t ‘C:Program FilesPLT’ then you will

    need to modify ‘buildexe.bat’ to use the correct path.

    • From your Waxeye installation directory, run the ‘buildexe.bat’ script in a

    command prompt.

    • When the script has finished, press ‘y’ then ‘Enter’ to remove the

    temporary files.

Running

Unix, OSX: Use ‘waxeye’.

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.

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 the files ‘doc/book/book’ and ‘doc/manual.html’.

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