bashly 0.8.0 → 0.8.3

data/lib/bashly/views/command/command_fallback.gtx

@@ -0,0 +1,42 @@
+= view_marker
+
+> "" )
+>   {{ function_name }}_usage
+>   exit 1
+>   ;;
+>
+> * )
+
+if default_command
+  >   action="{{ default_command.name }}"
+  >   {{ default_command.function_name }}_parse_requirements "$@"
+  >   shift $#
+  >   ;;
+  >
+
+elsif extensible.is_a? String
+  >   if [[ -x "$(command -v "{{ extensible }}")" ]]; then
+  >     exec {{ extensible }} "$@"
+  >   else
+  >     printf "{{ strings[:invalid_command] }}\n" "$action"
+  >     exit 1
+  >   fi
+  >
+
+elsif extensible
+  >   if [[ -x "$(command -v "{{ function_name }}-$action")" ]]; then
+  >     shift
+  >     exec "{{ function_name }}-$action" "$@"
+  >   else
+  >     printf "{{ strings[:invalid_command] }}\n" "$action"
+  >     exit 1
+  >   fi
+  >
+
+else
+  >   printf "{{ strings[:invalid_command] }}\n" "$action"
+  >   exit 1
+  >   ;;
+  >
+
+end

data/lib/bashly/views/command/command_filter.gtx

@@ -0,0 +1,29 @@
+= view_marker
+
+if commands.any?
+  > action=${1:-}
+  > 
+  > case $action in
+  > -* )
+  >   ;;
+  > 
+
+  commands.each do |command|
+    > {{ command.aliases.join " | " }} )
+    >   action="{{ command.name }}"
+    >   shift
+    >   {{ command.function_name }}_parse_requirements "$@"
+    >   shift $#
+    >   ;;    
+    > 
+
+  end
+
+  = render :command_fallback
+  > esac
+  >
+
+else
+  > action="{{ action_name }}"
+
+end

data/lib/bashly/views/command/command_functions.gtx

@@ -0,0 +1,5 @@
+= view_marker
+
+deep_commands.each do |command|
+  = command.render :function unless command.commands.any?
+end

data/lib/bashly/views/command/default_assignments.gtx

@@ -0,0 +1,13 @@
+if default_args.any? or default_flags.any?
+  = view_marker
+
+  default_args.each do |arg|
+    > [[ -n ${args[{{ arg.name }}]:-} ]] || args[{{ arg.name }}]="{{ arg.default }}"
+  end
+
+  default_flags.each do |flag|
+    > [[ -n ${args[{{ flag.long }}]:-} ]] || args[{{ flag.long }}]="{{ flag.default }}"
+  end
+
+  >
+end

data/lib/bashly/views/command/default_initialize_script.gtx

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

data/lib/bashly/views/command/default_root_script.gtx

@@ -0,0 +1,4 @@
+> echo "# this file is located in '{{ "#{Settings.source_dir}/#{filename}" }}'"
+> echo "# you can edit it freely and regenerate (it will not be overwritten)"
+> inspect_args
+>

data/lib/bashly/views/command/default_script.gtx

@@ -0,0 +1,5 @@
+> echo "# this file is located in '{{ "#{Settings.source_dir}/#{filename}" }}'"
+> echo "# code for '{{ full_name }}' goes here"
+> echo "# you can edit it freely and regenerate (it will not be overwritten)"
+> inspect_args
+>

data/lib/bashly/views/command/dependencies_filter.gtx

@@ -0,0 +1,10 @@
+if dependencies
+  = view_marker
+
+  dependencies.each do |dependency|
+    > if ! [[ -x "$(command -v {{ dependency }})" ]]; then
+    >   printf "{{ strings[:missing_dependency] % { dependency: dependency } }}\n"
+    >   exit 1
+    > fi
+  end
+end

data/lib/bashly/views/command/environment_variables_filter.gtx

@@ -0,0 +1,18 @@
+if default_environment_variables.any? or required_environment_variables.any?
+  = view_marker 
+
+  if default_environment_variables.any?
+    default_environment_variables.each do |env_var|
+      > export {{ env_var.name.upcase }}="${<%= env_var.name.upcase %>:-<%= env_var.default %>}"
+    end
+  end
+
+  if required_environment_variables.any?
+    required_environment_variables.each do |env_var|
+      > if [[ -z "${<%= env_var.name.upcase %>:-}" ]]; then
+      >   printf "{{ strings[:missing_required_environment_variable] % { var: env_var.name.upcase } }}\n"
+      >   exit 1
+      > fi
+    end
+  end
+end

data/lib/bashly/views/command/fixed_flags_filter.gtx

@@ -0,0 +1,20 @@
+= view_marker
+
+> case "${1:-}" in
+
+if root_command?
+  = short_flag_exist?("-v") ? "--version )" : "--version | -v )"
+  >   version_command
+  >   exit
+  >   ;;
+  > 
+end
+
+= short_flag_exist?("-h") ? "--help )" : "--help | -h )"
+>   long_usage=yes
+>   <%= function_name %>_usage
+>   exit
+>   ;;
+> 
+> esac
+>

data/lib/bashly/views/command/footer.gtx

@@ -0,0 +1,5 @@
+= view_marker
+
+> printf "{{ footer.gsub("\n", '\n').gsub('"', '\"') }}\n"
+> echo
+>

data/lib/bashly/views/command/function.gtx

@@ -0,0 +1,6 @@
+= view_marker
+
+> {{ function_name }}_command() {
+= load_user_file(filename).indent 2
+> }
+>

data/lib/bashly/views/command/initialize.gtx

@@ -0,0 +1,12 @@
+= view_marker
+
+> initialize() {
+>   version="<%= version %>"
+>   long_usage=''
+>   {{ Settings.strict ? "set -euo pipefail" : "set -e" }}
+> 
+
+= load_user_file("initialize.sh", placeholder: false).indent 2
+
+> }
+>

data/lib/bashly/views/command/inspect_args.gtx

@@ -0,0 +1,21 @@
+= view_marker
+
+> inspect_args() {
+>   readarray -t sorted_keys < <(printf '%s\n' "${!args[@]}" | sort)
+>   if (( ${#args[@]} )); then
+>     echo args:
+>     for k in "${sorted_keys[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
+>   else
+>     echo args: none
+>   fi
+> 
+>   if (( ${#other_args[@]} )); then
+>     echo
+>     echo other_args:
+>     echo "- \${other_args[*]} = ${other_args[*]}"
+>     for i in "${!other_args[@]}"; do
+>       echo "- \${other_args[$i]} = ${other_args[$i]}"
+>     done
+>   fi
+> }
+> 

data/lib/bashly/views/command/long_usage.gtx

@@ -0,0 +1,13 @@
+= view_marker
+
+> if [[ -n $long_usage ]]; then
+>   printf "{{ strings[:options] }}\n"
+>
+= render(:usage_fixed_flags).indent 2
+= render(:usage_flags).indent 2 if flags.any?
+= render(:usage_args).indent 2 if args.any? or catch_all.help
+= render(:usage_environment_variables).indent 2 if environment_variables.any?
+= render(:usage_examples).indent 2 if examples
+= render(:footer).indent 2 if footer
+>
+> fi

data/lib/bashly/views/command/master_script.gtx

@@ -0,0 +1,17 @@
+= view_marker
+
+= render :root_command if commands.empty?
+= render :version_command
+= render :usage
+= render :normalize_input
+= render :inspect_args
+= render :user_lib if user_lib.any?
+= render :command_functions
+= render :parse_requirements
+= render :initialize
+= render :run
+
+> 
+> initialize
+> run "$@"
+> 

data/lib/bashly/views/command/normalize_input.gtx

@@ -0,0 +1,25 @@
+= view_marker
+
+> normalize_input() {
+>   local arg flags
+> 
+>   while [[ $# -gt 0 ]]; do
+>     arg="$1"
+>     if [[ $arg =~ ^(--[a-zA-Z0-9_\-]+)=(.+)$ ]]; then
+>       input+=("${BASH_REMATCH[1]}")
+>       input+=("${BASH_REMATCH[2]}")
+>     elif [[ $arg =~ ^(-[a-zA-Z0-9])=(.+)$ ]]; then
+>       input+=("${BASH_REMATCH[1]}")
+>       input+=("${BASH_REMATCH[2]}")
+>     elif [[ $arg =~ ^-([a-zA-Z0-9][a-zA-Z0-9]+)$ ]]; then
+>       flags="${BASH_REMATCH[1]}"
+>       for (( i=0 ; i < ${#flags} ; i++ )); do
+>         input+=("-${flags:i:1}")
+>       done
+>     else
+>       input+=("$arg")
+>     fi
+> 
+>     shift
+>   done
+> }

data/lib/bashly/views/command/parse_requirements.gtx

@@ -0,0 +1,26 @@
+= view_marker
+
+if root_command?
+  > parse_requirements() {
+else
+  > {{ function_name }}_parse_requirements() {
+end
+
+= render(:fixed_flags_filter).indent 2
+= render(:environment_variables_filter).indent 2
+= render(:dependencies_filter).indent 2
+= render(:command_filter).indent 2
+= render(:parse_requirements_while).indent 2
+= render(:required_args_filter).indent 2
+= render(:required_flags_filter).indent 2
+= render(:catch_all_filter).indent 2
+= render(:default_assignments).indent 2
+= render(:whitelist_filter).indent 2
+= render(:user_filter).indent 2
+
+> }
+> 
+
+commands.each do |command|
+  = command.render :parse_requirements
+end

data/lib/bashly/views/command/parse_requirements_case.gtx

@@ -0,0 +1,11 @@
+= view_marker
+
+if catch_all.enabled?
+  = render :parse_requirements_case_catch_all
+elsif repeatable_arg_exist?
+  = render :parse_requirements_case_repeatable
+else
+  = render :parse_requirements_case_simple
+end
+
+>

data/lib/bashly/views/command/parse_requirements_case_catch_all.gtx

@@ -0,0 +1,23 @@
+= view_marker
+
+if args.any?
+  condition = "if"
+  args.each do |arg|
+    > {{ condition }} [[ -z ${args[{{ arg.name }}]+x} ]]; then
+    =   arg.render(:validations).indent 2
+    >   args[{{ arg.name }}]=$1
+    >   shift
+    
+    condition = "elif"
+  end
+
+  > else
+  >   other_args+=("$1")
+  >   shift
+  > fi
+
+else
+  > other_args+=("$1")
+  > shift
+
+end

data/lib/bashly/views/command/parse_requirements_case_repeatable.gtx

@@ -0,0 +1,24 @@
+= view_marker
+
+condition = "if"
+args.each do |arg|
+  > {{ condition }} [[ -z ${args[{{ arg.name }}]+x} ]]; then
+  = arg.render(:validations).indent 2
+
+  if arg.repeatable
+    >   args[{{ arg.name }}]="\"$1\""
+    >   shift
+    > else
+    >   args[{{ arg.name }}]="${args[{{ arg.name }}]} \"$1\""
+    >   shift
+
+  else
+    >   args[{{ arg.name }}]=$1
+    >   shift
+
+  end
+  condition = "elif"
+end
+
+> fi
+> 

data/lib/bashly/views/command/parse_requirements_case_simple.gtx

@@ -0,0 +1,25 @@
+= view_marker
+
+if args.any?
+  condition = "if"
+  args.each do |arg|
+    > {{ condition }} [[ -z ${args[{{ arg.name }}]+x} ]]; then
+    > {{ arg.render(:validations).indent 2 }}
+    >   args[{{ arg.name }}]=$1
+    >   shift
+
+    condition = "elif"
+  end
+
+  > else
+  >   printf "{{ strings[:invalid_argument] }}\n" "$key"
+  >   exit 1
+  > fi
+
+else
+  > printf "{{ strings[:invalid_argument] }}\n" "$key"
+  > exit 1
+
+end
+
+>

data/lib/bashly/views/command/parse_requirements_while.gtx

@@ -0,0 +1,33 @@
+= view_marker
+
+> while [[ $# -gt 0 ]]; do
+>   key="$1"
+>   case "$key" in
+
+flags.each do |flag|
+  = flag.render(:case).indent 2
+end
+
+>
+>   -?* )
+
+if catch_all.enabled?
+  >     other_args+=("$1")
+  >     shift
+  >     ;;
+
+else
+  >     printf "<%= strings[:invalid_flag] %>\n" "$key"
+  >     exit 1
+  >     ;;
+
+end
+
+> 
+>   * )
+= render(:parse_requirements_case).indent 4
+>     ;;
+> 
+>   esac
+> done
+

data/lib/bashly/views/command/required_args_filter.gtx

@@ -0,0 +1,13 @@
+if required_args.any?
+  = view_marker
+
+  required_args.each do |arg|
+    > if [[ -z ${args[{{ arg.name }}]+x} ]]; then
+    >   printf "{{ strings[:missing_required_argument] % { arg: arg.name.upcase, usage: usage_string } }}\n"
+    >   exit 1
+    > fi
+  end
+
+  >
+
+end

data/lib/bashly/views/command/required_flags_filter.gtx

@@ -0,0 +1,12 @@
+if required_flags.any?
+  = view_marker
+
+  required_flags.each do |flag|
+    > if [[ -z ${args[{{ flag.long }}]+x} ]]; then
+    >   printf "{{ strings[:missing_required_flag] % { usage: flag.usage_string } }}\n"
+    >   exit 1
+    > fi
+  end
+
+  >
+end

data/lib/bashly/views/command/root_command.gtx

@@ -0,0 +1,6 @@
+= view_marker
+
+> root_command() {
+= load_user_file(filename).indent 2
+> }
+> 

data/lib/bashly/views/command/run.gtx

@@ -0,0 +1,28 @@
+= view_marker
+
+> run() {
+>   declare -A args=()
+>   declare -a other_args=()
+>   declare -a input=()
+>   normalize_input "$@"
+>   parse_requirements "${input[@]}"
+> 
+
+condition = "if"
+deep_commands.each do |command|
+  >   {{ condition }} [[ $action == "{{ command.action_name }}" ]]; then
+  >     if [[ ${args[--help]:-} ]]; then
+  >       long_usage=yes
+  >       {{ command.function_name }}_usage
+  >     else
+  >       {{ command.function_name }}_command
+  >     fi
+  >
+    
+  condition = "elif"
+end
+
+>   {{ condition }} [[ $action == "root" ]]; then
+>     root_command
+>   fi
+> }

data/lib/bashly/views/command/usage.gtx

@@ -0,0 +1,50 @@
+= view_marker
+
+> {{ function_name }}_usage() {
+>   if [[ -n $long_usage ]]; then
+
+if summary == help
+  >     printf "{{ caption_string }}\n"
+  >     echo 
+else
+  >     printf "{{ full_name }}\n"
+  >     echo 
+  >     printf "{{ help.wrap(78).indent(2).sanitize_for_print }}\n"
+  >     echo 
+end
+
+>   else
+>     printf "{{ caption_string }}\n"
+>     echo 
+>   fi
+> 
+
+if alt&.any?
+  >   printf "{{ strings[:command_alias] % { alias: alt.join(', ') } }}\n"
+  >   echo
+end
+
+>
+>   printf "{{ strings[:usage] }}\n"
+>   printf "  {{ usage_string }}\n"
+
+if commands.any?
+  >   printf "  {{ full_name }} [command] --help{{ " | -h" unless short_flag_exist? "-h" }}\n"
+else
+  >   printf "  {{ full_name }} --help{{ " | -h" unless short_flag_exist? "-h" }}\n"
+end
+
+if root_command?
+  >   printf "  {{ full_name }} --version{{ " | -v" unless short_flag_exist? "-v" }}\n"
+end
+  >   echo
+
+= render(:usage_commands).indent 2 if commands.any?
+>
+= render(:long_usage).indent 2
+> }
+>
+
+commands.each do |command|
+  = command.render 'usage'
+end

data/lib/bashly/views/command/usage_args.gtx

@@ -0,0 +1,20 @@
+= view_marker
+
+> printf "{{ strings[:arguments] }}\n"
+
+if args.any?
+  >
+  args.each do |arg|
+    = arg.render(:usage)
+  end
+end
+
+if catch_all.help
+  >
+  > echo "  {{ catch_all.label }}"
+  > printf "{{ catch_all.help.wrap(76).indent(4).sanitize_for_print }}\n"
+  > echo
+end
+
+>
+

data/lib/bashly/views/command/usage_commands.gtx

@@ -0,0 +1,18 @@
+= view_marker
+
+maxlen = command_help_data.values.map(&:keys).flatten.map(&:size).max
+
+command_help_data.each do |group, commands|
+  > printf "{{ group }}\n"
+
+  commands.each do |command, info|
+    if info[:help_only]
+      > [[ -n $long_usage ]] && echo "  {{ command.ljust maxlen }}   {{ info[:summary] }}"
+    else
+      > echo "  {{ command.ljust maxlen }}   {{ info[:summary] }}"
+    end
+  end
+
+  > echo
+
+end

data/lib/bashly/views/command/usage_environment_variables.gtx

@@ -0,0 +1,10 @@
+= view_marker
+
+> printf "{{ strings[:environment_variables] }}\n"
+> 
+
+environment_variables.each do |env_var|
+  = env_var.render :usage
+end
+
+>

data/lib/bashly/views/command/usage_examples.gtx

@@ -0,0 +1,10 @@
+= view_marker
+
+> printf "{{ strings[:examples] }}\n"
+
+examples.each do |example|
+  > printf "{{ example.wrap(78).indent(2).sanitize_for_print }}\n"
+end
+
+> echo
+>

data/lib/bashly/views/command/usage_fixed_flags.gtx

@@ -0,0 +1,13 @@
+= view_marker
+
+= short_flag_exist?("-h") ? 'echo "  --help"' : 'echo "  --help, -h"'
+> printf "    {{ strings[:help_flag_text] }}\n"
+> echo
+
+if root_command?
+  = short_flag_exist?("-v") ? 'echo "  --version"' : 'echo "  --version, -v"'
+  > printf "    {{ strings[:version_flag_text] }}\n"
+  > echo
+end
+
+>

data/lib/bashly/views/command/usage_flags.gtx

@@ -0,0 +1,7 @@
+= view_marker
+
+flags.each do |flag|
+  = flag.render :usage
+end
+
+>

data/lib/bashly/views/command/user_filter.gtx

@@ -0,0 +1,13 @@
+if filters
+
+  = view_marker
+
+  filters.each do |filter|
+    > filter_error=$(filter_{{ filter }})
+    > if [[ -n $filter_error ]]; then
+    >   echo "$filter_error"
+    >   exit 1
+    > fi
+    > 
+  end
+end

data/lib/bashly/views/command/user_lib.gtx

@@ -0,0 +1,11 @@
+if user_lib.any?
+  = view_marker
+
+  user_lib.each do |file|
+    = view_marker file
+    = File.read file
+    > 
+  end
+
+  >
+end

data/lib/bashly/views/command/version_command.gtx

@@ -0,0 +1,6 @@
+= view_marker
+
+> version_command() {
+>   echo "$version"
+> }
+>