🛝 Lingua Franca Playground

Get to know the Lingua Franca coordination language and browse example programs. To view, edit, and run the programs, you can either run locally on your computer or run in the cloud using either GitHub Codespaces or Gitpod.

💻 Running Locally

Quick start:

1. Clone this repo (git clone git@github.com:lf-lang/playground-lingua-franca.git)
2. Open with VS Code (code playground-lingua-franca)
3. Install the Lingua Franca extension (Ctrl+P and enter ext install lf-lang.vscode-lingua-franca).

Once in VSCode, navigate to ./examples and click on any of the .lf files to open them into your editor. To build and run, use Ctrl+Shift+P and select Lingua Franca: Build and Run. Note: You might need not install additional dependencies in order to successfully build some of the code you find in this repository. For more information, see the setup-env.bash script that we use to configure our Docker-based environments.

🚀 Running in the Cloud

Spin up a fully configured dev environment in the cloud that start in seconds. Any dependencies required for building or running any of the examples are preinstalled. A web-based VS Code editor, preloaded with the Lingua Franca extension, is accessible through either GitHub Codespaces or GitPod. Simply click on either of the links below to get started.

(NOTE: This can be quite slow to start.)

Once in Codespaces or GitPod, navigate to ./examples and click on any of the .lf files to open them in the editor. To build and run, use Ctrl+Shift+P and select Lingua Franca: Build and Run.

🔧 Switch Lingua Franca Build Channels

By default, the Lingua Franca toolchain installed in the container will be the latest nightly version, freshly fetched when the container boots up. This fetching process is handled by a utility script called setup-lf.bash, located in the utils/scripts directory.

If you wish to switch to a different build channel for Lingua Franca, you can use the following commands in your console:

# To install the nightly version, built within the last 24 hours
bash ./utils/scripts/setup-lf.bash nightly

# To install the latest stable version
bash ./utils/scripts/setup-lf.bash stable

# To clone the repository and build Lingua Franca from source
bash ./utils/scripts/setup-lf.bash dev

Please note that running these commands will remove the current lingua-franca directory.