update catch all stdin example

Author: DannyBen

examples/catch-all-stdin/README.md

@@ -13,3 +13,143 @@ $ bashly generate
 
 -----
 
+## `bashly.yml`
+
+```yaml
+name: cli
+help: Sample application
+version: 0.1.0
+
+catch_all:
+  label: file
+  help: Path to one or more files. Reads from stdin if empty or "-".
+
+flags:
+- long: --format
+  short: -f
+  arg: format
+  help: Specify file format
+  default: json
+  allowed: [csv, json]
+
+examples:
+- cli file1 file2 --format csv
+- cli --format csv file1 file2
+- cat file1 | cli --format csv
+- cat file* | cli - --format csv
+```
+
+
+
+## Generated script output
+
+### `$ ./cli -h`
+
+```shell
+cli - Sample application
+
+Usage:
+  cli [options] [FILE...]
+  cli --help | -h
+  cli --version | -v
+
+Options:
+  --help, -h
+    Show this help
+
+  --version, -v
+    Show version number
+
+  --format, -f FORMAT
+    Specify file format
+    Allowed: csv, json
+    Default: json
+
+Arguments:
+  FILE...
+    Path to one or more files. Reads from stdin if empty or "-".
+
+Examples:
+  cli file1 file2 --format csv
+  cli --format csv file1 file2
+  cat file1 | cli --format csv
+  cat file* | cli - --format csv
+
+
+
+```
+
+### `$ ./cli file1 file2 --format csv`
+
+```shell
+args:
+- ${args[--format]} = csv
+
+other_args:
+- ${other_args[*]} = file1 file2
+- ${other_args[0]} = file1
+- ${other_args[1]} = file2
+
+collected file contents:
+file1 content
+file2 content
+
+
+
+
+```
+
+### `$ ./cli -f=csv file1 file2`
+
+```shell
+args:
+- ${args[--format]} = csv
+
+other_args:
+- ${other_args[*]} = file1 file2
+- ${other_args[0]} = file1
+- ${other_args[1]} = file2
+
+collected file contents:
+file1 content
+file2 content
+
+
+
+
+```
+
+### `$ cat file1 | ./cli --format csv`
+
+```shell
+args:
+- ${args[--format]} = csv
+
+collected file contents:
+file1 content
+
+
+
+```
+
+### `$ cat file* | ./cli -`
+
+```shell
+args:
+- ${args[--format]} = json
+
+other_args:
+- ${other_args[*]} = -
+- ${other_args[0]} = -
+
+collected file contents:
+file1 content
+file2 content
+
+
+
+
+```
+
+
+

examples/catch-all-stdin/src/root_command.sh

@@ -15,7 +15,9 @@ if [[ -z "$content" ]]; then
   content="$(cat -)"
 fi
 
-echo "Collected file contents:"
+echo
+echo "collected file contents:"
 echo "$content"
+echo
 
 

spec/approvals/examples/catch-all-stdin

@@ -42,10 +42,12 @@ other_args:
 - ${other_args[*]} = file1 file2
 - ${other_args[0]} = file1
 - ${other_args[1]} = file2
-Collected file contents:
+
+collected file contents:
 file1 content
 file2 content
 
+
 + ./cli -f=csv file1 file2
 args:
 - ${args[--format]} = csv
@@ -54,16 +56,20 @@ other_args:
 - ${other_args[*]} = file1 file2
 - ${other_args[0]} = file1
 - ${other_args[1]} = file2
-Collected file contents:
+
+collected file contents:
 file1 content
 file2 content
 
+
 + cat file1
 + ./cli --format csv
 args:
 - ${args[--format]} = csv
-Collected file contents:
+
+collected file contents:
 file1 content
+
 + ./cli -
 + cat file1 file2
 args:
@@ -72,7 +78,9 @@ args:
 other_args:
 - ${other_args[*]} = -
 - ${other_args[0]} = -
-Collected file contents:
+
+collected file contents:
 file1 content
 file2 content
 
+