Skip to content

Latest commit

 

History

History
43 lines (25 loc) · 3.04 KB

README.md

File metadata and controls

43 lines (25 loc) · 3.04 KB
Raw

The Roo Programming Language IDE

About

The Roo IDE is a simple integrated development environment that makes it easier to write and debug scripts written in the Roo programming language.

The IDE provides a text editor that will colour Roo syntax as you type. You can execute the Roo code that you've typed from within the IDE or you can load a Roo script file from disk. There is a toggle for enabling/disabling network access for scripts so you can assess the behviour of your code in environments where networking has been prohibited. If you're interested, you can even view the output of the scanner to inspect the individual tokens created just prior to script execution.

The IDE supports dark mode on macOS and provides two themes (light and dark) which you can switch between on both macOS and Windows.

Building

I provide pre-built binaries for macOS and 64-bit Windows. You can find them in the releases section. To build the IDE from source yourself you have two choices:

1. Use the "Xojo Project Format Project File

  1. Clone the repo (or download it as a ZIP file)
  2. Launch the src/Roo IDE.xojo_project file in Xojo
  3. Resolve the missing Roo class dependencies
  4. Comment out the contents of the PublishMac and PublishWin IDE scripts in the Build Settings section of Xojo's navigator. These are only there to help me when I build releases to publish on GitHub. They are not needed for you to build the app and will only generate an error for you.

Number 3 above might require a little clarification. Xojo provides a mechanism for making classes and modules external to a project. This means that you can make changes to those classes and have them reflected in all of your projects which use them. Since I maintain the reference command line interpreter as well I keep the actual classes in that repo. You can find them in the cli repo under src/core/Roo. Download that repo and when the Xojo IDE asks you for the location of the various Roo classes, simply navigate to them and select them. You only need to do this once.

2. Use the "Xojo Binary Format Project File"

To simplify getting started with the project, I have also included the project saved in Xojo's binary file format. This can be found in /binary project/Roo IDE.xojo_binary_project. Simply launch this is Xojo 2019 Release 1.1 or later and you're good to go.

Extras

You'll notices that this repo contains some folders additional to the source code. These are detailed below:

resources/

In this folder you'll find syntax definition XML files for the Roo programming language for Thomas Tempelmann's CustomEditField class. This is what powers the IDE syntax colouring. They are automatically copied into the built app's Resources folder during building by Xojo's compiler.

example scripts/

This folder contains some example scripts.