ROS Index
|
playground-lingua-franca repositoryplayground examples experiments gitpod codespaces py_pubsub lf_simple carla_intersection carla_intersection_msgs |
Repository Summary
| Description | 🚀 Try Lingua Franca now! |
| Checkout URI | https://github.com/lf-lang/playground-lingua-franca.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2025-03-28 |
| Dev Status | UNKNOWN |
| CI status | No Continuous Integration |
| Released | UNRELEASED |
| Tags | playground examples experiments gitpod codespaces |
| Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
| Name | Version |
|---|---|
| py_pubsub | 0.0.0 |
| lf_simple | 0.0.0 |
| carla_intersection | 0.0.0 |
| carla_intersection_msgs | 0.0.0 |
README
🛝 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:
- Clone this repo (
git clone git@github.com:lf-lang/playground-lingua-franca.git) - Open with VS Code (
code playground-lingua-franca) - 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 to 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.
:rocket: 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.
:wrench: 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.