Convert several operator examples to mdtest-spq

Author: philrz

docs/language/operators/assert.md

@@ -15,18 +15,20 @@ structured error if it does not.
 
 ### Examples
 
-```mdtest-command
-echo {a:1} | super -z -c 'assert a > 0' -
-```
-
-```mdtest-output
+```mdtest-spq
+# spq
+assert a > 0
+# input
+{a:1}
+# expected output
 {a:1}
 ```
 
-```mdtest-command
-echo {a:-1} | super -z -c 'assert a > 0' -
-```
-
-```mdtest-output
+```mdtest-spq {data-layout="stacked"}
+# spq
+assert a > 0
+# input
+{a:-1}
+# expected output
 error({message:"assertion failed",expr:"a > 0",on:{a:-1}})
 ```

docs/language/operators/combine.md

@@ -5,7 +5,7 @@
 ### Synopsis
 
 ```
-( => ... => ...) |> ...
+( => ... => ...) | ...
 ```
 ### Description
 
@@ -20,11 +20,16 @@ and its semantics of undefined merge order.
 ### Examples
 
 _Copy input to two pipeline branches and combine with the implied operator_
-```mdtest-command
-echo '1 2' | super -z -c 'fork (=>pass =>pass) |> sort this' -
-```
-
-```mdtest-output
+```mdtest-spq
+# spq
+fork (
+  =>pass
+  =>pass
+)
+| sort this
+# input
+1 2
+# expected output
 1
 1
 2

docs/language/operators/cut.md

@@ -23,7 +23,7 @@ Each right-hand side `<expr>` can be any Zed expression and is optional.
 When the right-hand side expressions are omitted,
 the _cut_ operation resembles the Unix shell command, e.g.,
 ```
-... |> cut a,c |> ...
+... | cut a,c | ...
 ```
 If an expression results in `error("quiet")`, the corresponding field is omitted
 from the output.  This allows you to wrap expressions in a `quiet()` function
@@ -42,38 +42,47 @@ yield {<field>:<expr> [, <field>:<expr>...]}
 ### Examples
 
 _A simple Unix-like cut_
-```mdtest-command
-echo '{a:1,b:2,c:3}' | super -z -c 'cut a,c' -
-```
-
-```mdtest-output
+```mdtest-spq
+# spq
+cut a,c
+# input
+{a:1,b:2,c:3}
+# expected output
 {a:1,c:3}
 ```
-_Missing fields show up as missing errors_
-```mdtest-command
-echo '{a:1,b:2,c:3}' | super -z -c 'cut a,d' -
-```
 
-```mdtest-output
+_Missing fields show up as missing errors_
+```mdtest-spq
+# spq
+cut a,d
+# input
+{a:1,b:2,c:3}
+# expected output
 {a:1,d:error("missing")}
 ```
-_The missing fields can be ignored with quiet_
-```mdtest-command
-echo '{a:1,b:2,c:3}' | super -z -c 'cut a:=quiet(a),d:=quiet(d)' -
-```
 
-```mdtest-output
+_The missing fields can be ignored with quiet_
+```mdtest-spq
+# spq
+cut a:=quiet(a),d:=quiet(d)
+# input
+{a:1,b:2,c:3}
+# expected output
 {a:1}
 ```
-_Non-record values generate missing errors for fields not present in a non-record `this`_
-```mdtest-command
-echo '1 {a:1,b:2,c:3}' | super -z -c 'cut a,b' -
-```
 
-```mdtest-output
+_Non-record values generate missing errors for fields not present in a non-record `this`_
+```mdtest-spq {data-layout="stacked"}
+# spq
+cut a,b
+# input
+1
+{a:1,b:2,c:3}
+# expected output
 {a:error("missing"),b:error("missing")}
 {a:1,b:2}
 ```
+
 _Invoke a function while cutting to set a default value for a field_
 
 {{% tip "Tip" %}}
@@ -84,11 +93,13 @@ the output will be exported in formats such as `csv` or `parquet` (see also:
 
 {{% /tip %}}
 
-```mdtest-command
-echo '{a:1,b:null}{a:1,b:2}' | super -z -c 'cut a,b:=coalesce(b, 0)' -
-```
-
-```mdtest-output
+```mdtest-spq
+# spq
+cut a,b:=coalesce(b, 0)
+# input
+{a:1,b:null}
+{a:1,b:2}
+# expected output
 {a:1,b:0}
 {a:1,b:2}
 ```

docs/language/operators/drop.md

@@ -17,19 +17,23 @@ non-record values are copied unmodified.
 ### Examples
 
 _Drop of a field_
-```mdtest-command
-echo '{a:1,b:2,c:3}' | super -z -c 'drop b' -
-```
-
-```mdtest-output
+```mdtest-spq
+# spq
+drop b
+# input
+{a:1,b:2,c:3}
+# expected output
 {a:1,c:3}
 ```
-_Non-record values are copied to output_
-```mdtest-command
-echo '1 {a:1,b:2,c:3}' | super -z -c 'drop a,b' -
-```
 
-```mdtest-output
+_Non-record values are copied to output_
+```mdtest-spq
+# spq
+drop a,b
+# input
+1
+{a:1,b:2,c:3}
+# expected output
 1
 {c:3}
 ```

docs/language/operators/file.md

@@ -4,11 +4,10 @@
 
 ### Synopsis
 
-`file` is a shorthand notation for `from`. See the [from operator](from.md) documentation for details.
+`file` is a shorthand notation for `from`. See the [`from` operator](from.md) documentation for details.
 
 {{% tip "Note" %}}
 
-The `file` shorthand is exclusively for working with inputs to
-[`super`](../../commands/super.md) and is not available for use with [SuperDB data lakes](../../commands/super-db.md).
+The `file` shorthand is not available for use with [SuperDB data lakes](../../commands/super-db.md).
 
 {{% /tip %}}

docs/language/operators/fork.md

@@ -23,11 +23,17 @@ merged with an automatically inserted [combine operator](combine.md).
 ### Examples
 
 _Copy input to two pipeline branches and merge_
-```mdtest-command
-echo '1 2' | super -z -c 'fork (=>pass =>pass) |> sort this' -
-```
-
-```mdtest-output
+```mdtest-spq
+# spq
+fork (
+  =>pass
+  =>pass
+)
+| sort this
+# input
+1
+2
+# expected output
 1
 1
 2

docs/language/operators/from.md

@@ -49,28 +49,28 @@ In the fifth form, multiple sources are accessed in parallel and may be
 
 A pipeline can be split with the [`fork` operator](fork.md) as in
 ```
-from PoolOne |> fork (
-  => op1 |> op2 | ...
-  => op1 |> op2 | ...
-) |> merge ts | ...
+from PoolOne | fork (
+  => op1 | op2 | ...
+  => op1 | op2 | ...
+) | merge ts | ...
 ```
 
 Or multiple pools can be accessed and, for example, joined:
 ```
 from (
-  pool PoolOne => op1 |> op2 | ...
-  pool PoolTwo => op1 |> op2 | ...
-) |> join on key=key | ...
+  pool PoolOne => op1 | op2 | ...
+  pool PoolTwo => op1 | op2 | ...
+) | join on key=key | ...
 ```
 
 Similarly, data can be routed to different pipeline branches with replication
 using the [`switch` operator](switch.md):
 ```
-from ... |> switch color (
-  case "red" => op1 |> op2 | ...
-  case "blue" => op1 |> op2 | ...
-  default => op1 |> op2 | ...
-) |> ...
+from ... | switch color (
+  case "red" => op1 | op2 | ...
+  case "blue" => op1 | op2 | ...
+  default => op1 | op2 | ...
+) | ...
 ```
 
 ### Input Data
@@ -91,8 +91,8 @@ echo '{number:1,word:"one"} {number:2,word:"two"} {number:3,word:"three"}' |
   super db load -q -use numbers -
 super db query -f text '
   from :branches
-  |> yield pool.name + "@" + branch.name
-  |> sort'
+  | yield pool.name + "@" + branch.name
+  | sort'
 ```
 
 The lake then contains the two pools:
@@ -114,7 +114,7 @@ The following file `hello.jsup` is also used.
 _Source structured data from a local file_
 
 ```mdtest-command
-super -z -c 'file hello.jsup |> yield greeting'
+super -z -c 'file hello.jsup | yield greeting'
 ```
 
 ```mdtest-output
@@ -133,7 +133,7 @@ super -z -c 'file hello.jsup format line'
 _Source structured data from a URI_
 ```
 super -z -c 'get https://raw.githubusercontent.com/brimdata/zui-insiders/main/package.json
-       |> yield productName'
+       | yield productName'
 ```
 =>
 ```
@@ -163,7 +163,7 @@ super db -lake example query -z 'from coinflips@trial'
 
 _Count the number of values in the `main` branch of all pools_
 ```mdtest-command
-super db -lake example query -f text 'from * |> count()'
+super db -lake example query -f text 'from * | count()'
 ```
 
 ```mdtest-output
@@ -172,9 +172,9 @@ super db -lake example query -f text 'from * |> count()'
 _Join the data from multiple pools_
 ```mdtest-command
 super db -lake example query -z '
-  from coinflips |> sort flip
-  |> join (
-    from numbers |> sort number
+  from coinflips | sort flip
+  | join (
+    from numbers | sort number
   ) on flip=number word'
 ```
 
@@ -186,16 +186,16 @@ super db -lake example query -z '
 _Use `pass` to combine our join output with data from yet another source_
 ```mdtest-command
 super db -lake example query -z '
-  from coinflips |> sort flip
-  |> join (
-    from numbers |> sort number
+  from coinflips | sort flip
+  | join (
+    from numbers | sort number
   ) on flip=number word
-  |> from (
+  | from (
     pass
     pool coinflips@trial =>
       c:=count()
-      |> yield f"There were {int64(c)} flips"
-  ) |> sort this'
+      | yield f"There were {int64(c)} flips"
+  ) | sort this'
 ```
 
 ```mdtest-output