From 8507aaa41c1aae07b34ce6024e800550ec097435 Mon Sep 17 00:00:00 2001
From: Peter Holloway <peter.holloway@diamond.ac.uk>
Date: Wed, 11 Nov 2026 18:31:19 +0000
Subject: [PATCH] dev: Add 'listen' task to justfile

Easily stream documents from the message bus without passing config

    $ just listen

is equivalent to

    $ blueapi controller listen

with the correct configuration passed in.

An optional argument lets the format be set as well so

    $ just listen json | jq

will stream messages as raw JSON and pipe them through jq to be
pretty-printed.
---
 justfile | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/justfile b/justfile
index e0b40df56..df77e8d78 100644
--- a/justfile
+++ b/justfile
@@ -71,3 +71,7 @@ repl:
         traceback.print_exception(e, chain=False)
     EOF
     )
+
+[doc('Stream documents from the stomp message bus - see blueapi controller listen')]
+listen FORMAT="full":
+    uv run blueapi -c tests/system_tests/config.yaml controller -o {{ FORMAT }} listen