add example for private commands

Author: DannyBen

examples/command-private/.gitignore

@@ -0,0 +1,6 @@
+src/connect_ftp_command.sh
+src/connect_ssh_command.sh
+src/download_command.sh
+src/initialize.sh
+src/upload_command.sh
+cli

examples/command-private/README.md

@@ -0,0 +1,15 @@
+# Private Command Example
+
+Demonstrates how to hide a command from the commands list.
+
+This example was generated with:
+
+```bash
+$ bashly init
+# ... now edit src/bashly.yml to match the example ...
+$ bashly generate
+```
+
+<!-- include: src/connect_command.sh -->
+
+-----

examples/command-private/src/bashly.yml

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

examples/command-private/src/connect_command.sh

@@ -0,0 +1,5 @@
+# Execute a subsequent (private) command based on the PROTOCOL argument
+protocol=${args[protocol]}
+cmd="./cli connect-$protocol"
+echo "=== Calling $cmd"
+$cmd

examples/command-private/test.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Cleanup before testing
+rm -f "src/connect_ftp_command.sh"
+rm -f "src/connect_ssh_command.sh"
+rm -f "src/download_command.sh"
+rm -f "src/initialize.sh"
+rm -f "src/upload_command.sh"
+
+set -x
+
+bashly generate
+
+### Try Me ###
+
+./cli
+./cli -h
+./cli connect ftp
+./cli connect-ssh
+./cli connect-ftp --help
+

spec/approvals/examples/command-private

@@ -0,0 +1,59 @@
++ bashly generate
+creating user files in src
+created src/initialize.sh
+skipped src/connect_command.sh (exists)
+created src/connect_ftp_command.sh
+created src/connect_ssh_command.sh
+created ./cli
+run ./cli --help to test your bash script
++ ./cli
+cli - Sample application with private commands
+
+Usage:
+  cli [command]
+  cli [command] --help | -h
+  cli --version | -v
+
+Commands:
+  connect       Connect to the metaverse
+
++ ./cli -h
+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
+=== 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
+# 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
+cli connect-ftp - Connect via FTP
+
+Usage:
+  cli connect-ftp
+  cli connect-ftp --help | -h
+
+Options:
+  --help, -h
+    Show this help
+