Troupe 2 Example Project

A starter project for Troupe, an actor-based programming language with dynamic information flow control.

Prerequisites

• Docker
• VS Code with the Dev Containers extension

Getting Started

1. Clone this repository.

2. Open the folder in VS Code.

3. When prompted, click Reopen in Container (or press F1 and run Dev Containers: Reopen in Container).

4. Once the container is running, open a terminal and try:

   local.sh examples/helloworld.trp

5. Try the actor example:

   local.sh examples/actors.trp

Running the Troupe Notebook

The container includes the Troupe Notebook, an interactive environment for writing and running Troupe programs in your browser.

notebook.sh

Then open http://localhost:8888 (the port is forwarded automatically by the dev container).

Example notebooks are available inside the container at /Troupe/examples/userguide-tpnb/.

Available Commands

Command	Description
local.sh <file.trp>	Compile and run locally (no networking)
network.sh <file.trp>	Compile and run with P2P networking
notebook.sh	Start the Troupe Notebook server

Integrated user-guide

The Troupe installation has an integrate user guide for the basic language referene and the information flow. To check it out, invoke the script $TROUPE/notebook/tools/import-userguide.sh.

V1 user guide

Note that the online Troupe user guide still refers to Troupe V1; so you should use the integrated one above.

• Troupe User Guide
• Troupe on GitHub