REPL Mode

The following page details the default Lumorphix mode, the REPL Mode. If you are unfamiliar with a REPL, we recommend you familiarize yourself by reading some background information.

Prompt

The user is prompted by '$' in this mode, for example:

$ 

If Lumorphix has been configured for multiple Cores, by default the current Core number that the user is interacting with will precede the user prompt. For example, if the user is interacting with the fourth Core.

[ #4 ] $

Example

The following is a basic example of REPL usage.

$ foo = 123
$ foo
123
$ foo * foo
15129
$ foo_cubed = foo * foo * foo
$ foo_cubed
1860867

The above interaction with the Lumorphix REPL can be described as follows:

1. A variable named 'foo' is declared, and given the value 123.

2. The user typed 'foo' and pressed return - the Lumorphix REPL fetched that variable and printed its value.

3. The variable named 'foo' is multiplied by itself, which equates to 15129.

4. A variable named 'foo_cubed' is declared, and given the value of foo * foo * foo.

5. Finally, the user typed 'foo_cubed' and pressed return - the Lumorphix REPL fetched that variable and printed its value.

One other feature of the REPL to note - multiline input is accepted. Every non-first line of a multiline script will be prompted by the the multiline prompt, '$$', until the end of the script section. For example:

$ if foo_cubed > 999 then
$$ print("Variable 'foo_cubed' is bigger than 999!")
$$ end
Variable 'foo_cubed' is bigger than 999!

User Interrupt

To prevent the critical failure case of remaining stuck in a scripted loop, or to simply exit a program or line of script earlier than it would naturally exit, simply press the 'q' key on your keyboard. This is obviously a bit difficult to illustrate via an example, however consider the following interaction with the Lumorphix REPL on Core #2:

[ #2 ] $ import("sleep")
[ #2 ] $ while true do print("Forever ?"); sleep(1); end
Forever ?
Forever ?
Forever ?
Forever ?
stdin:1: <user interruption>
stack traceback:
	[C]: in function 'sleep'
	stdin:1: in main chunk

The user didn’t want to remain stuck printing ‘Forever ?’ forever, so they pressed the keyboard 'q' key after line 6 occurred.

History

Simply press the ‘up’ or ‘down’ arrow keys on your keyboard to access (up to) the previous ten entries. This is functionality is present for both the REPL Mode and Command Mode.

An entry wont be stored in history that exceeds one hundred and twenty eight characters, in order to minimise memory utilization.

Summary

The above information provides a brief overview of the Lumorphix REPL. Of course, in addition to supporting the Lua scripting language, Lumorphix offers a rich API, which allows interaction with various internal hardware components, as well as external I/O. See API for more information.

In additional to REPL Mode, Lumorphix also offers Command Mode, which allows the user to peruse and configure various hardware options (I/O, Core XBar, etc) and capabilities. See Command Mode for more information.