add split config example

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/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/split-config/.gitignore

@@ -0,0 +1,3 @@
+src/download_command.sh
+src/initialize.sh
+cli

examples/split-config/README.md

@@ -0,0 +1,164 @@
+# Split Config Example
+
+Demonstrates how to separate your bashly.yml into several files, and load 
+configuration data from other YAML files, or directly from a YAML front matter
+in your code.
+
+This example was generated with:
+
+```bash
+$ bashly init
+$ bashly generate
+# ... now edit all files in the src folder ...
+$ bashly generate
+```
+
+<!-- include: src/download_command.yml src/upload_command.sh src/common_flags.yml -->
+
+-----
+
+## `bashly.yml`
+
+```yaml
+name: cli
+help: Configuration splitting example
+version: 0.1.0
+
+commands:
+  # Import a command that is defined in another YAML file
+  - import: src/download_command.yml
+  
+  # Import a command that is defined in the front matter of its own shell
+  # function.
+  - import: src/upload_command.sh
+```
+
+## `src/download_command.yml`
+
+```yaml
+name: download
+short: d
+help: Download a file
+
+args:
+- name: source
+  required: true
+  help: URL to download from
+- name: target
+  help: "Target filename (default: same as source)"
+
+flags:
+  import: src/common_flags.yml
+
+```
+
+## `src/upload_command.sh`
+
+```bash
+# This is a YAML front matter describing the command
+# It is imported to bashly.yml when running "bashly generate"
+
+name: upload
+short: u
+help: Upload a file
+args:
+- name: source
+  required: true
+  help: File to upload
+
+flags:
+  import: src/common_flags.yml
+
+---
+# Shell script starts here
+inspect_args
+
+```
+
+## `src/common_flags.yml`
+
+```yaml
+- long: --force
+  short: -f
+  help: Overwrite existing files
+
+```
+
+
+## Generated script output
+
+### `$ ./cli`
+
+```shell
+cli - Configuration splitting example
+
+Usage:
+  cli [command]
+  cli [command] --help | -h
+  cli --version | -v
+
+Commands:
+  download   Download a file
+  upload     Upload a file
+
+
+
+```
+
+### `$ ./cli download -h`
+
+```shell
+cli download - Download a file
+
+Shortcut: d
+
+Usage:
+  cli download SOURCE [TARGET] [options]
+  cli download --help | -h
+
+Options:
+  --help, -h
+    Show this help
+
+  --force, -f
+    Overwrite existing files
+
+Arguments:
+  SOURCE
+    URL to download from
+
+  TARGET
+    Target filename (default: same as source)
+
+
+
+```
+
+### `$ ./cli upload -h`
+
+```shell
+cli upload - Upload a file
+
+Shortcut: u
+
+Usage:
+  cli upload SOURCE [options]
+  cli upload --help | -h
+
+Options:
+  --help, -h
+    Show this help
+
+  --force, -f
+    Overwrite existing files
+
+Arguments:
+  SOURCE
+    File to upload
+
+
+
+```
+
+
+

examples/split-config/src/bashly.yml

@@ -0,0 +1,11 @@
+name: cli
+help: Configuration splitting example
+version: 0.1.0
+
+commands:
+  # Import a command that is defined in another YAML file
+  - import: src/download_command.yml
+  
+  # Import a command that is defined in the front matter of its own shell
+  # function.
+  - import: src/upload_command.sh

examples/split-config/src/common_flags.yml

@@ -0,0 +1,3 @@
+- long: --force
+  short: -f
+  help: Overwrite existing files

examples/split-config/src/download_command.yml

@@ -0,0 +1,13 @@
+name: download
+short: d
+help: Download a file
+
+args:
+- name: source
+  required: true
+  help: URL to download from
+- name: target
+  help: "Target filename (default: same as source)"
+
+flags:
+  import: src/common_flags.yml

examples/split-config/src/upload_command.sh

@@ -0,0 +1,17 @@
+# This is a YAML front matter describing the command
+# It is imported to bashly.yml when running "bashly generate"
+
+name: upload
+short: u
+help: Upload a file
+args:
+- name: source
+  required: true
+  help: File to upload
+
+flags:
+  import: src/common_flags.yml
+
+---
+# Shell script starts here
+inspect_args

examples/split-config/test.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+rm -f "src/download_command.sh"
+rm -f "src/initialize.sh"
+
+set -x
+
+bashly generate
+
+### Try Me ###
+
+./cli
+./cli download -h
+./cli upload -h

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")"