Add piping from stdin (#7)

WizardBit · web-flow · commit 07e6eeffdc45 · 2026-06-03T10:50:30.000-05:00
diff --git a/README.md b/README.md
@@ -17,20 +17,25 @@ sudo snap install xjs
 
 ## ⌨️ Usage
 
-With yaml:
+Read from a file (yaml or json):
 
 ```bash
 juju status --format yaml > juju-status.yaml
 xjs juju-status.yaml
 ```
 
-With json:
-
 ```bash
 juju status --format json > juju-status.json
 xjs juju-status.json
 ```
 
+Pipe stdin directly:
+
+```bash
+juju status --format yaml | xjs --unwanted
+juju status --format json | xjs --show-units
+```
+
 Options:
 
 ```bash
diff --git a/xjs/cli.py b/xjs/cli.py
@@ -612,8 +612,8 @@ def filter_results(
     help="Show only units with unwanted workload or agent status",
 )
 @click.argument(
-    "statusfiles", required=True, type=click.File("r"),
-    nargs=-1, metavar="<status files>",
+    "statusfiles", required=False, type=click.File("r"),
+    nargs=-1, metavar="[status files]",
 )
 def main(
     statusfiles: tuple[TextIO, ...],
@@ -637,6 +637,16 @@ def main(
     agent_status: str,
     unwanted: bool,
 ) -> None:
+    if not statusfiles:
+        if sys.stdin.isatty():
+            console = Console()
+            console.print(
+                "[red]Error: no status files provided"
+                " and no data piped to stdin[/red]",
+            )
+            sys.exit(1)
+        statusfiles = (sys.stdin,)
+
     color = not no_color
     controllers: dict[str, Controller] = {}
     for statusfile in statusfiles:
