Skip to content

Parasol Cmd Tool

Paul Manias edited this page Apr 28, 2024 · 1 revision

A successful build and install of Parasol will create a parasol executable that is available at the root of the installation folder. This tool allows you to run Fluid scripts with the .fluid extension.

Run the tool with --help to see the available options and confirm that the install worked correctly. At the time of writing, this looks as follows:

This command-line program can execute Fluid scripts and PARC files developed for the Parasol framework.

   parasol [args] [script.ext] arg1 arg2=value ...

The following parameters can be used when executing script files:

 --procedure [n] The name of a procedure to execute.
 --time          Print the amount of time that it took to execute the program.

 --log-api       Activates run-time log messages at API level.
 --log-info      Activates run-time log messages at INFO level.
 --log-error     Activates run-time log messages at ERROR level.

Example scripts are provided in the examples folder of this distribution. We recommend starting with the widget example as follows, where install-path and source-path are replaced appropriately:

[install-path]/parasol --log-error [source-path]/examples/widgets.fluid

Try running a second time with --log-api to observe run-time log output while toying with the example. Try a few of the other examples to get a feel for what you can achieve, and load them into a text editor to see how they were created.

Congratulations, if you made it this far then you have a working build installed correctly!