From c06f074c25d1ff3e692cd75fc0219ca3cf8020ba Mon Sep 17 00:00:00 2001
From: Steven Baltakatei Sandoval <baltakatei@gmail.com>
Date: Mon, 29 Jan 2024 20:56:23 +0000
Subject: [PATCH 1/1] feat(unitproc/bkt-read_stdin): Add exit codes

---
 unitproc/bkt-read_stdin | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/unitproc/bkt-read_stdin b/unitproc/bkt-read_stdin
index 31469b3..bf1873e 100644
--- a/unitproc/bkt-read_stdin
+++ b/unitproc/bkt-read_stdin
@@ -7,15 +7,20 @@ must() { "$@" || die "cannot $*"; } # runs args as command, reports args if comm
 read_stdin() {
     # Desc: Consumes stdin; outputs as stdout lines
     # Input: stdin (consumes)
-    # Output: stdout (newline delimited)
+    # Output: stdout  (newline delimited)
+    #         return  0  stdin read
+    #         return  1  stdin not present
     # Example: printf "foo\nbar\n" | read_stdin
-    # Depends: GNU bash (version 5.1.16)
-    # Version: 0.0.1
+    # Depends: GNU bash (version 5.1.16), GNU Coreutils 8.32 (cat)
+    # Version: 0.1.0
+    # Attrib: Steven Baltakatei Sandoval (2024-01-29). reboil.com
     local input_stdin output;
 
     # Store stdin
     if [[ -p /dev/stdin ]]; then
         input_stdin="$(cat -)";
+    else
+        return 1;
     fi; 
     
     # Store as output array elements
@@ -28,9 +33,8 @@ read_stdin() {
 
     # Print to stdout
     printf "%s\n" "${output[@]}";
+
+    return 0;
 }; # read stdin to stdout lines
-main() {
-    read_stdin "$@";
-};
 
-main "$@";
+yell "WARNING:This is a Bash function definition for read_stdin.";
-- 
2.30.2