Using the REPL
BlueScript includes an interactive shell, also known as a REPL (Read-Eval-Print Loop). This allows you to execute BlueScript code line-by-line and see the results immediately, without the need to compile and flash a full project.
It is perfect for:
- Testing language syntax.
- Performing quick calculations.
- Verifying logic functions.
Starting the REPL
Connect your ESP32 device and run the following command in your terminal:
bscript repl -b esp32
Once connected, you will see the prompt > indicating the device is ready for input.
Basic Usage
You can type standard BlueScript expressions and statements.
Calculations
Expressions are evaluated and the result is printed automatically.
> console.log(10 + 20)
30
> console.log(3.14 * 2.0)
6.28
Variables and Logic
You can define variables and use them in subsequent commands.
> let name: string = "BlueScript";
> console.log("Hello " + name);
Hello BlueScript
Functions
You can also define simple functions interactively.
> function square(x: integer): integer { return x * x; }
> console.log(square(5))
25
Current Limitations
Currently, the REPL does not support loading external hardware libraries such as gpio.
You cannot import modules in the REPL at this moment.
Future Roadmap:
We are actively working on enabling dynamic library loading for the REPL.
In a future update, you will be able to type led.write(1) and toggle pins directly from the terminal!
Exiting
To exit the REPL mode, press Ctrl + D.