Merge pull request #14 from DannyBen/user-lib

Add support for extra custom scripts

Author: DannyBen

examples/custom-includes/download

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# This script was generated by bashly (https://github.com/DannyBen/bashly)
+# Modifying it manually is not recommended
+
+# :command.root_command
+root_command() {
+ # :src/root_command.sh
+ # Call our custom library function
+ echo "Before custom code"
+ my_extra_function
+ echo "After custom code"
+}
+
+# :command.version_command
+version_command() {
+ echo "$version"
+}
+
+# :command.usage
+download_usage() {
+ echo -e "download - Sample minimal application with custom strings"
+ echo 
+ echo -e "Usage:"
+ echo -e " download [SOURCE] [options]"
+ echo
+
+
+ if [[ -n $long_usage ]]; then
+ echo -e "Options:"
+ # :command.usage_fixed_flags
+ echo " --help, -h"
+ echo -e " Show this help"
+ echo
+ echo " --version"
+ echo -e " Show version number"
+ echo
+
+ # :command.usage_args
+ echo -e "Arguments:"
+ 
+ # :argument.usage
+ echo " SOURCE"
+ echo " URL to download from"
+ echo
+
+
+
+ fi
+}
+
+
+# :command.inspect_args
+inspect_args() {
+ echo args:
+ for k in "${!args[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
+}
+
+# :command.user_lib
+# :src/lib/my_extra_function.sh
+my_extra_function() {
+ echo "---"
+ echo "This is a place to write custom code that is needed by more than"
+ echo "one part of the application."
+ echo "Under most circumstances, you will not need it, but it is provided"
+ echo "for extra flexibility."
+ echo "---"
+}
+
+
+# :command.command_functions
+
+# :command.parse_args
+parse_args() {
+ # :command.fixed_flag_filter
+ case "$1" in
+ --version | -v ) 
+ version_command
+ exit 1
+ ;;
+ 
+ --help | -h ) 
+ long_usage=yes
+ download_usage
+ exit 1
+ ;;
+ 
+ esac
+ # :command.command_filter
+ action=root
+ # :command.required_args_filter
+ # :command.required_flags_filter
+ # :command.parse_args_while
+ while [[ $# -gt 0 ]]; do
+ key="$1"
+ case "$key" in
+ 
+ -* )
+ echo -e "invalid option: $key"
+ exit 1
+ ;;
+ 
+ * )
+ # :command.parse_args_case
+ if [[ ! ${args[source]} ]]; then
+ args[source]=$1
+ shift
+ else
+ echo -e "invalid argument: $key"
+ exit 1
+ fi
+ ;;
+ 
+ esac
+ done
+}
+
+
+# :command.initialize
+initialize() {
+ version="0.1.0"
+ long_usage=''
+ set -e 
+}
+
+# :command.run
+run() {
+ declare -A args
+ parse_args "$@"
+
+ if [[ ${args[--version]} ]]; then
+ version_command
+ elif [[ ${args[--help]} ]]; then
+ long_usage=yes
+ download_usage
+ elif [[ $action == "root" ]]; then
+ root_command
+ fi
+}
+
+initialize
+run "$@"

examples/custom-includes/src/bashly.yml

@@ -0,0 +1,7 @@
+name: download
+help: Sample minimal application with custom strings
+version: 0.1.0
+
+args:
+- name: source
+ help: URL to download from

examples/custom-includes/src/lib/my_extra_function.sh

@@ -0,0 +1,8 @@
+my_extra_function() {
+ echo "---"
+ echo "This is a place to write custom code that is needed by more than"
+ echo "one part of the application."
+ echo "Under most circumstances, you will not need it, but it is provided"
+ echo "for extra flexibility."
+ echo "---"
+}

examples/custom-includes/src/root_command.sh

@@ -0,0 +1,4 @@
+# Call our custom library function
+echo "Before custom code"
+my_extra_function
+echo "After custom code"

examples/custom-includes/test.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+set -x
+
+bashly generate
+
+./download

examples/custom-strings/download

@@ -61,6 +61,7 @@ inspect_args() {
  for k in "${!args[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
 }
 
+
 # :command.command_functions
 
 # :command.parse_args

examples/minimal/download

@@ -67,6 +67,7 @@ inspect_args() {
  for k in "${!args[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
 }
 
+
 # :command.command_functions
 
 # :command.parse_args

examples/subcommands/cli

@@ -141,6 +141,7 @@ inspect_args() {
  for k in "${!args[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
 }
 
+
 # :command.command_functions
 # :command.function
 cli_download_command() {

lib/bashly/commands/add.rb

@@ -4,18 +4,24 @@ class Add < Base
  help "Add extra features and customization to your script"
 
  usage "bashly add strings [--force]"
+ usage "bashly add lib [--force]"
  usage "bashly add (-h|--help)"
 
  option "-f --force", "Overwrite existing files"
 
  command "strings", "Copy an additional configuration file to your project, allowing you to customize all the tips and error strings."
+ command "lib", "Create the additional lib directory for additional user scripts. All *.sh scripts in this folder will be included in the final bash script."
 
  environment "BASHLY_SOURCE_DIR", "The path to use for creating the configuration file [default: src]"
 
  def strings_command
  safe_copy asset("templates/strings.yml"), "#{Settings.source_dir}/bashly-strings.yml"
  end
 
+ def lib_command
+ safe_copy asset("templates/sample_lib_function.sh"), "#{Settings.source_dir}/lib/sample_lib_function.sh"
+ end
+
  private
 
  def safe_copy(source, target)
@@ -26,10 +32,16 @@ def safe_copy(source, target)
  if File.exist? target and !args['--force']
  say "skipped !txtgrn!#{target}!txtrst! (exists)"
  else
- FileUtils.cp source, target
+ deep_copy source, target
  say "created !txtgrn!#{target}"
  end
  end
+
+ def deep_copy(source, target)
+ target_dir = File.dirname target
+ FileUtils.mkdir_p target_dir unless Dir.exist? target_dir
+ FileUtils.cp source, target
+ end
  end
  end
 end

lib/bashly/models/command.rb

@@ -87,6 +87,15 @@ def usage_string
  result.join " "
  end
 
+ # Returns an array of files to include as is inside the script
+ # This is meant to provide the user with the ability to add custom
+ # functions
+ def user_lib
+ @user_lib ||= Dir["#{Settings.source_dir}/lib/**/*.sh"]
+ end
+
+ # Raise an exception if there are some serious issues with the command
+ # definition.
  def verify
  verify_commands if commands.any?
  end