Using Binaries

If you prefer not to use a package manager on macOS or Windows or you're on Linux then you can run Roo from its provided binary.

macOS and Linux

First download the correct release from Github. The zip file will contain the following files/folders:

roo Libs/
roo

Copy these to somewhere within your $PATH. Launch the roo binary to use the interpreter. If you copy the contents to your $PATH then you'll be able to run the interpreter simply by typing roo in the Terminal.

Windows

First download the correct release from Github. The zip file will contain the following files/folders:

Copy these to somewhere within your $PATH. Launch the roo binary to use the interpreter. If you copy the contents to your $PATH then you'll be able to run the interpreter simply by typing roo.exe in the Terminal.

From Source

Clone this repo and the core classes repo above. The Xojo IDE will likely prompt you to resolve some path issues regarding the core classes so you will have to manually tell the IDE where the core classes are located on your system. After this, build the app from within the Xojo IDE for your platform of choice. Remember to place the roo executable in your PATH (and make sure the dependency folder/files are in the same place). The interpreter is written entirely in native Xojo code and no external plugins are required.

The console project for the Roo interpreter contains a number of build scripts. These will fail without some modification on your part.

Using The Interpreter

After successfully installing the interpreter you should have the roo binary at your disposal. For clarity, in the following examples, the $ denotes the command line prompt.

Running A Script

Running a script is easy. Just pass, as an argument, to the Roo interpreter the full path to the script to run:

$ roo my_program.roo

### Using The REPL

It's possible to use the interpreter as a REPL. This allows the execution of Roo commands with immediate response in real time:

$ roo
Roo interpreter (v3.0.0)
>>>

Just type Roo commands at the prompt (>>>) and you'll get immediate output from the Terminal.