regenerate example output

Author: DannyBen

examples/colors/README.md

@@ -66,5 +66,18 @@ echo
 
 ```
 
+### `$ NO_COLOR=1 ./colorly`
+
+```shell
+Message Recevied:
+
+  => hello colors
+  ==> hello colors
+  ===> hello colors
+
+
+
+```
+
 
 

examples/command-private/README.md

@@ -13,3 +13,129 @@ $ bashly generate
 <!-- include: src/connect_command.sh -->
 
 -----
+
+## `bashly.yml`
+
+```yaml
+name: cli
+help: Sample application with private commands
+version: 0.1.0
+
+commands:
+- name: connect
+  short: c
+  help: Connect to the metaverse
+
+  args:
+  - name: protocol
+    required: true
+    allowed: [ftp, ssh]
+    help: Protocol to use for connection
+
+# These two commands will be hidden from the commands list, but still executable
+# and visible when running 'cli connect-ftp --help' or 'cli connect-ssh --help'
+- name: connect-ftp
+  help: Connect via FTP
+  private: true
+
+- name: connect-ssh
+  help: Connect via SSH
+  private: true
+```
+
+## `src/connect_command.sh`
+
+```bash
+# Execute a subsequent (private) command based on the PROTOCOL argument
+protocol=${args[protocol]}
+cmd="./cli connect-$protocol"
+echo "=== Calling $cmd"
+$cmd
+```
+
+
+## Generated script output
+
+### `$ ./cli`
+
+```shell
+cli - Sample application with private commands
+
+Usage:
+  cli [command]
+  cli [command] --help | -h
+  cli --version | -v
+
+Commands:
+  connect       Connect to the metaverse
+
+
+
+```
+
+### `$ ./cli -h`
+
+```shell
+cli - Sample application with private commands
+
+Usage:
+  cli [command]
+  cli [command] --help | -h
+  cli --version | -v
+
+Commands:
+  connect       Connect to the metaverse
+
+Options:
+  --help, -h
+    Show this help
+
+  --version, -v
+    Show version number
+
+
+
+```
+
+### `$ ./cli connect ftp`
+
+```shell
+=== Calling ./cli connect-ftp
+# this file is located in 'src/connect_ftp_command.sh'
+# code for 'cli connect-ftp' goes here
+# you can edit it freely and regenerate (it will not be overwritten)
+args: none
+
+
+```
+
+### `$ ./cli connect-ssh`
+
+```shell
+# this file is located in 'src/connect_ssh_command.sh'
+# code for 'cli connect-ssh' goes here
+# you can edit it freely and regenerate (it will not be overwritten)
+args: none
+
+
+```
+
+### `$ ./cli connect-ftp --help`
+
+```shell
+cli connect-ftp - Connect via FTP
+
+Usage:
+  cli connect-ftp
+  cli connect-ftp --help | -h
+
+Options:
+  --help, -h
+    Show this help
+
+
+
+```
+
+
+

examples/environment-variables/README.md

@@ -60,9 +60,9 @@ echo "# you can edit it freely and regenerate (it will not be overwritten)"
 inspect_args
 
 echo "environment:"
-echo "- API_KEY=$API_KEY"
-echo "- ENVIRONMENT=$ENVIRONMENT"
-echo "- MY_SECRET=$MY_SECRET"
+echo "- API_KEY=${API_KEY:-}"
+echo "- ENVIRONMENT=${ENVIRONMENT:-}"
+echo "- MY_SECRET=${MY_SECRET:-}"
 
 ```
 

examples/yaml/README.md

@@ -64,9 +64,9 @@ server:
 ## `src/root_command.sh`
 
 ```bash
-filename=${args[filename]}
-variable=${args[variable]}
-prefix=${args[--prefix]}
+filename=${args[filename]:-}
+variable=${args[variable]:-}
+prefix=${args[--prefix]:-}
 
 if [[ $variable ]]; then
   eval "$(yaml_load "$filename" "$prefix")"