add command filename spec and example

Author: DannyBen

examples/command-filenames/.gitignore

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

examples/command-filenames/README.md

@@ -0,0 +1,124 @@
+# Command Groups Example
+
+Demonstrates how to visually group commands under their own caption. This is
+useful for scripts that contain many commands that provide different sets of
+functionality.
+
+This example was generated with:
+
+```bash
+$ bashly init
+# ... now edit src/bashly.yml to match the example ...
+$ bashly generate
+```
+
+-----
+
+## `bashly.yml`
+
+```yaml
+name: ftp
+help: Sample application with command grouping
+version: 0.1.0
+
+commands:
+- name: download
+  help: Download a file
+
+  # By specifying a group, the `download` comnmand (and all subsequent
+  # commands until the next `group`) will be printed under this `File` 
+  # caption.
+  group: File
+
+  args:
+  - name: file
+    required: true
+    help: File to download
+
+- name: upload
+  help: Upload a file
+
+  args:
+  - name: file
+    required: true
+    help: File to upload
+
+- name: login
+  help: Write login credentials to the config file
+
+  # The `login` command (and all subsequent commands) will be printed under
+  # the `Login` caption.
+  group: Login
+
+- name: logout
+  help: Delete login credentials to the config file
+```
+
+
+
+## Generated script output
+
+### `$ ./ftp`
+
+```shell
+ftp - Sample application with command grouping
+
+Usage:
+  ftp [command]
+  ftp [command] --help | -h
+  ftp --version | -v
+
+File Commands:
+  download   Download a file
+  upload     Upload a file
+
+Login Commands:
+  login      Write login credentials to the config file
+  logout     Delete login credentials to the config file
+
+
+
+```
+
+### `$ ./ftp -h`
+
+```shell
+ftp - Sample application with command grouping
+
+Usage:
+  ftp [command]
+  ftp [command] --help | -h
+  ftp --version | -v
+
+File Commands:
+  download   Download a file
+  upload     Upload a file
+
+Login Commands:
+  login      Write login credentials to the config file
+  logout     Delete login credentials to the config file
+
+Options:
+  --help, -h
+    Show this help
+
+  --version, -v
+    Show version number
+
+
+
+```
+
+### `$ ./ftp login`
+
+```shell
+# this file is located in 'src/login_command.sh'
+# code for 'ftp login' goes here
+# you can edit it freely and regenerate (it will not be overwritten)
+args: none
+
+
+```
+
+
+

examples/command-filenames/src/bashly.yml

@@ -0,0 +1,35 @@
+name: cli
+help: Demonstrate custom command filenames
+version: 0.1.0
+
+commands:
+- name: dir
+  short: d
+  help: Directory commands
+
+  commands:
+  - name: list
+    help: Show files in the directory
+    
+    # Define a custom filename for this command source.
+    # This is relative to the `src` directory, and sub-directories will be
+    # created as needed.
+    filename: dir_commands/list.sh
+
+  - name: remove
+    help: Remove directory
+    filename: dir_commands/remove.sh
+
+- name: file
+  short: f
+  help: File commands
+
+  commands:
+  - name: show
+    help: Show file contents
+    filename: file_commands/show.sh
+
+  - name: edit
+    help: Edit the file
+    filename: file_commands/edit.sh
+

examples/command-filenames/src/dir_commands/list.sh

@@ -0,0 +1,4 @@
+echo "# this file is located in 'src/dir_commands/list.sh'"
+echo "# code for 'cli dir list' goes here"
+echo "# you can edit it freely and regenerate (it will not be overwritten)"
+inspect_args

examples/command-filenames/src/dir_commands/remove.sh

@@ -0,0 +1,4 @@
+echo "# this file is located in 'src/dir_commands/remove.sh'"
+echo "# code for 'cli dir remove' goes here"
+echo "# you can edit it freely and regenerate (it will not be overwritten)"
+inspect_args

examples/command-filenames/src/file_commands/edit.sh

@@ -0,0 +1,4 @@
+echo "# this file is located in 'src/file_commands/edit.sh'"
+echo "# code for 'cli file edit' goes here"
+echo "# you can edit it freely and regenerate (it will not be overwritten)"
+inspect_args

examples/command-filenames/src/file_commands/show.sh

@@ -0,0 +1,4 @@
+echo "# this file is located in 'src/file_commands/show.sh'"
+echo "# code for 'cli file show' goes here"
+echo "# you can edit it freely and regenerate (it will not be overwritten)"
+inspect_args

examples/command-filenames/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/command-filenames/test.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+rm -f ./src/*.sh
+
+set -x
+
+bashly generate
+
+### Try Me ###
+
+./cli
+./cli -h
+./cli dir list

lib/bashly/config_validator.rb

@@ -117,6 +117,7 @@ def assert_command(key, value)
       assert_optional_string "#{key}.help", value['help']
       assert_optional_string "#{key}.footer", value['footer']
       assert_optional_string "#{key}.group", value['group']
+      assert_optional_string "#{key}.filename", value['filename']
 
       assert_boolean "#{key}.default", value['default']
       assert_version "#{key}.version", value['version']