bashly 0.8.1 → 0.8.4

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"
+> }
+> 

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

@@ -0,0 +1,41 @@
+if whitelisted_args.any? or whitelisted_flags.any?
+  = view_marker
+
+  whitelisted_args.each do |arg|
+    if arg.repeatable
+      > eval "input_array=(${args[{{ arg.name }}]})"
+      > for i in "${input_array[@]}"; do
+      >   if [[ ! $i =~ ^({{ arg.allowed.join '|' }})$ ]]; then
+      >     printf "%s\n" "{{ strings[:disallowed_argument] % { name: arg.name, allowed: arg.allowed.join(', ') } }}"
+      >     exit 1
+      >   fi
+      > done
+
+    else
+      > if [[ ! ${args[{{ arg.name }}]} =~ ^({{ arg.allowed.join '|' }})$ ]]; then
+      >   printf "%s\n" "{{ strings[:disallowed_argument] % { name: arg.name, allowed: arg.allowed.join(', ') } }}"
+      >   exit 1
+      > fi
+
+    end
+  end
+
+  whitelisted_flags.each do |flag|
+    if flag.repeatable
+      > eval "input_array=(${args[{{ flag.name }}]})"
+      > for i in "${input_array[@]}"; do
+      >   if [[ ! $i =~ ^({{ flag.allowed.join '|' }})$ ]]; then
+      >     printf "%s\n" "{{ strings[:disallowed_flag] % { name: flag.name, allowed: flag.allowed.join(', ') } }}"
+      >     exit 1
+      >   fi
+      > done
+    
+    else
+      > if [[ ! ${args[{{ flag.name }}]} =~ ^({{ flag.allowed.join '|' }})$ ]]; then
+      >   printf "%s\n" "{{ strings[:disallowed_flag] % { name: flag.name, allowed: flag.allowed.join(', ') } }}"
+      >   exit 1
+      > fi
+
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+= view_marker
+
+> echo "  {{ usage_string extended: true }}"
+> printf "{{ help.wrap(76).indent(4).sanitize_for_print }}\n"
+
+if default
+  > printf "    {{ strings[:default] % { value: default } }}\n"
+end
+
+> echo
+> 

data/lib/bashly/views/flag/case.gtx

@@ -0,0 +1,6 @@
+= view_marker
+
+> {{ aliases.join " | " }} )
+= render(:conflicts).indent 2
+= render(arg ? :case_arg : :case_no_arg).indent 2
+>

data/lib/bashly/views/flag/case_arg.gtx

@@ -0,0 +1,25 @@
+= view_marker
+
+> if [[ -n ${2+x} ]]; then
+= render(:validations).indent 2
+
+if repeatable
+  >   if [[ -z ${args[{{ name }}]+x} ]]; then
+  >     args[{{ name }}]="\"$2\""
+  >   else
+  >     args[{{ name }}]="${args[{{ name }}]} \"$2\""
+  >   fi
+
+else
+  >   args[{{ name }}]="$2"
+
+end
+
+>   shift
+>   shift
+> else
+>   printf "%s\n" "{{ strings[:flag_requires_an_argument] % { name: name, usage: usage_string } }}"
+>   exit 1
+> fi
+> ;;
+> 

data/lib/bashly/views/flag/case_no_arg.gtx

@@ -0,0 +1,11 @@
+= view_marker
+
+if repeatable
+  > (( args[<%= name %>]+=1 ))
+else
+  > args[<%= name %>]=1
+end
+
+> shift
+> ;;
+> 

data/lib/bashly/views/flag/conflicts.gtx

@@ -0,0 +1,22 @@
+if conflicts
+
+  = view_marker
+  
+  if conflicts.count == 1
+    > if [[ -n "${args[{{ conflicts.first }}]:-}" ]]; then
+    >   printf "{{ strings[:conflicting_flags] }}\n" "$key" "{{ conflicts.first }}"
+    >   exit 1
+    > fi
+    >
+
+  else
+    > for conflict in {{ conflicts.join ' ' }}; do
+    >   if [[ -n "${args[$conflict]:-}" ]]; then
+    >     printf "{{ strings[:conflicting_flags] }}\n" "$key" "$conflict"
+    >     exit 1
+    >   fi
+    > done
+    >
+
+  end
+end

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

@@ -0,0 +1,15 @@
+= view_marker
+
+> echo "  {{ usage_string extended: true }}"
+> printf "{{ help.wrap(76).indent(4).sanitize_for_print }}\n"
+
+if allowed
+> printf "    {{ strings[:allowed] % { values: allowed.join(', ') } }}\n"
+end
+
+if default
+> printf "    {{ strings[:default] % { value: default } }}\n"
+end
+
+> echo
+> 

data/lib/bashly/views/flag/validations.gtx

@@ -0,0 +1,11 @@
+if validate
+
+  = view_marker
+
+  > if [[ -n $(validate_{{ validate }} "$2") ]]; then
+  >   printf "{{ strings[:validation_error] }}\n" "{{ usage_string }}" "$(validate_{{ validate }} "$2")"
+  >   exit 1
+  > fi
+  > 
+
+end

data/lib/bashly/views/wrapper/bash3_bouncer.gtx

@@ -0,0 +1,7 @@
+= view_marker
+
+> if [[ "${BASH_VERSINFO:-0}" -lt 4 ]]; then
+>   printf "{{ strings[:unsupported_bash_version] }}\n"
+>   exit 1
+> fi
+> 

data/lib/bashly/views/wrapper/header.gtx

@@ -0,0 +1,5 @@
+> #!/usr/bin/env bash
+> # This script was generated by bashly {{ Bashly::VERSION }} (https://bashly.dannyb.co)
+> # Modifying it manually is not recommended
+> 
+>

data/lib/bashly/views/wrapper/wrapper.gtx

@@ -0,0 +1,8 @@
+= view_marker
+
+> {{ function_name }}() {
+= body.indent 2
+> }
+>
+> (return 0 2>/dev/null) || {{ function_name }} "$@"
+>