Use just tool to run examples

.github/workflows/ci.yml

@@ -110,12 +110,15 @@ jobs:
           save-if: ${{ github.ref == 'refs/heads/main' }}
 
       # general examples
+      - run: cargo install just --locked
+      - name: "Rust Dataflow example"
+        timeout-minutes: 30
+        working-directory: examples/rust-dataflow
+        run: just run
+
       - name: "Build examples"
         timeout-minutes: 30
         run: cargo build --examples
-      - name: "Rust Dataflow example"
-        timeout-minutes: 30
-        run: cargo run --example rust-dataflow
       - name: "Multiple Daemons example"
         timeout-minutes: 30
         run: cargo run --example multiple-daemons

Cargo.toml

@@ -101,10 +101,6 @@ tokio-stream = "0.1.11"
 name = "c-dataflow"
 path = "examples/c-dataflow/run.rs"
 
-[[example]]
-name = "rust-dataflow"
-path = "examples/rust-dataflow/run.rs"
-
 [[example]]
 name = "rust-ros2-dataflow"
 path = "examples/rust-ros2-dataflow/run.rs"

examples/rust-dataflow/.gitignore

@@ -0,0 +1 @@
+out

examples/rust-dataflow/README.md

@@ -0,0 +1,6 @@
+# Rust Dataflow Example
+
+This example uses the [`just`](https://github.com/casey/just) tool for building and running the dataflow:
+
+- Build: `just build`
+- Run: `just run`

examples/rust-dataflow/justfile

@@ -0,0 +1,12 @@
+# you can use the installed `dora` command instead of this `cargo run` command
+dora := "cargo run -p dora-cli --"
+
+# build dora and the example nodes/operators
+build:
+    {{ dora }} build dataflow.yml
+
+# build and run the dataflow example
+run: build
+    # The `--run-dataflow` argument is mostly meant for testing. It's recommended
+    # to instead run `dora daemon` in one terminal and `dora start dataflow.yml` in another
+    RUST_LOG=debug {{ dora }} daemon --run-dataflow dataflow.yml