add catch_all + stdin example

Author: DannyBen

examples/README.md

@@ -21,6 +21,7 @@ Each of these examples demonstrates one aspect or feature of bashly.
 
 - [catch-all](catch-all#readme) - a command that can receive an arbitrary number of arguments
 - [catch-all-advanced](catch-all-advanced#readme) - another example for the `catch_all` option
+- [catch-all-stdin](catch-all-stdin#readme) - combining `catch_all` with `stdin` to read multiple files
 - [extensible](extensible#readme) - letting your script's users extend the script
 - [extensible-delegate](extensible-delegate#readme) - extending your script by delegating commands to an external executable
 - [whitelist](whitelist#readme) - arguments and flags with a predefined allowed list of values

examples/catch-all-stdin/.gitignore

@@ -0,0 +1 @@
+cli

examples/catch-all-stdin/README.md

@@ -0,0 +1,15 @@
+# Catch All with stdin input
+
+Demonstrates how to process multiple files as arguments, or from stdin.
+
+This example was generated with:
+
+```bash
+$ bashly init
+# ... now edit src/bashly.yml to match the example ...
+# ... now edit src/root_command.yml to match the example ...
+$ bashly generate
+```
+
+-----
+

examples/catch-all-stdin/file1

@@ -0,0 +1 @@
+file1 content

examples/catch-all-stdin/file2

@@ -0,0 +1 @@
+file2 content

examples/catch-all-stdin/src/bashly.yml

@@ -0,0 +1,21 @@
+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

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

@@ -0,0 +1,6 @@
+## Code here runs inside the initialize() function
+## Use it for anything that you need to run before any other function, like
+## setting environment vairables:
+## CONFIG_FILE=settings.ini
+##
+## Feel free to empty (but not delete) this file.

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

@@ -0,0 +1,21 @@
+inspect_args
+
+# Collect the catch_all
+files=( ${other_args[*]} )
+
+# Read contents of the provided file(s)
+content=""
+for file in "${files[@]}"; do
+  content+="$(cat "$file")"
+  content+=$'\n'
+done
+
+# Read stdin if file(s) not provided as arguments
+if [[ -z "$content" ]]; then
+  content="$(cat -)"
+fi
+
+echo "Collected file contents:"
+echo "$content"
+
+

examples/catch-all-stdin/test.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+set -x
+
+bashly generate
+
+### Try Me ###
+
+./cli -h
+./cli file1 file2 --format csv
+./cli -f=csv file1 file2
+cat file1 | ./cli --format csv
+cat file* | ./cli -

spec/approvals/examples/catch-all-stdin

@@ -0,0 +1,78 @@
++ bashly generate
+creating user files in src
+skipped src/initialize.sh (exists)
+skipped src/root_command.sh (exists)
+created ./cli
+run ./cli --help to test your bash script
++ ./cli -h
+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
+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
+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
+args:
+- ${args[--format]} = csv
+Collected file contents:
+file1 content
++ ./cli -
++ cat file1 file2
+args:
+- ${args[--format]} = json
+
+other_args:
+- ${other_args[*]} = -
+- ${other_args[0]} = -
+Collected file contents:
+file1 content
+file2 content
+