bashly 0.8.10 → 0.9.1

data/lib/bashly/message_strings.rb

@@ -13,7 +13,7 @@ module Bashly
   private
 
     def values!
-      defaults = YAML.properly_load_file asset("templates/strings.yml")
+      defaults = YAML.properly_load_file asset('templates/strings.yml')
       defaults.merge project_strings
     end
 

data/lib/bashly/refinements/compose_refinements.rb

@@ -23,9 +23,9 @@ module ComposeRefinements
 
     def safe_load_yaml(path)
       loaded = YAML.properly_load_file path
-      return loaded if loaded.is_a? Array or loaded.is_a? Hash
-      raise Bashly::ConfigurationError, "Cannot find a valid YAML in !txtgrn!#{path}"
+      return loaded if loaded.is_a?(Array) || loaded.is_a?(Hash)
 
+      raise Bashly::ConfigurationError, "Cannot find a valid YAML in !txtgrn!#{path}"
     rescue Errno::ENOENT
       raise Bashly::ConfigurationError, "Cannot find import file !txtgrn!#{path}"
     end

data/lib/bashly/script/argument.rb

@@ -18,4 +18,4 @@ module Bashly
       end
     end
   end
-end
+end

data/lib/bashly/script/base.rb

@@ -12,7 +12,8 @@ module Bashly
       end
 
       def initialize(options)
-        raise Error, "Invalid options provided" unless options.respond_to? :keys
+        raise Error, 'Invalid options provided' unless options.respond_to? :keys
+
         @options = options
       end
 
@@ -21,7 +22,7 @@ module Bashly
       end
 
       def summary
-        help.empty? ? "" : help.split("\n").first
+        help.empty? ? '' : help.split("\n").first
       end
 
       def help

data/lib/bashly/script/catch_all.rb

@@ -18,12 +18,15 @@ module Bashly
             {}
           end
 
-          new **options
+          new(**options)
         end
       end
 
       def initialize(label: nil, help: nil, required: false, enabled: true)
-        @label, @help, @required, @enabled = label, help, required, enabled
+        @label = label
+        @help = help
+        @required = required
+        @enabled = enabled
       end
 
       def enabled?
@@ -44,10 +47,9 @@ module Bashly
 
       def usage_string
         return nil unless enabled?
+
         required? ? label : "[#{label}]"
       end
-
     end
   end
 end
-

data/lib/bashly/script/command.rb

@@ -26,7 +26,7 @@ module Bashly
       #   by space. For example, for a command like "docker container run"
       #   the action name is "container run".
       def action_name
-        parents.any? ? (parents[1..-1] + [name]).join(' ') : "root"
+        parents.any? ? (parents[1..] + [name]).join(' ') : 'root'
       end
 
       # Returns all the possible aliases for this command
@@ -34,28 +34,20 @@ module Bashly
         [name] + alt
       end
 
-      # Returns an array of all full names (including aliases and aliases of
-      # parents)
-      def all_full_names
-        if parent_command
-          parent_command.all_full_names.product(aliases).map { |a| a.join ' ' }
-        else
-          aliases
-        end
-      end
-
       # Returns an array of alternative aliases if any
       def alt
         # DEPRECATION 0.8.0
         options['alias'] ||= options['short']
-        return [] unless options["alias"]
+        return [] unless options['alias']
+
         options['alias'].is_a?(String) ? [options['alias']] : options['alias']
       end
 
       # Returns an array of Arguments
       def args
-        return [] unless options["args"]
-        options["args"].map do |options|
+        return [] unless options['args']
+
+        options['args'].map do |options|
           Argument.new options
         end
       end
@@ -85,8 +77,8 @@ module Bashly
 
           command.public_commands.each do |subcommand|
             result[command.group_string]["#{command.name} #{subcommand.name}"] = {
-              summary: subcommand.summary_string,
-              help_only: command.expose != 'always'
+              summary:   subcommand.summary_string,
+              help_only: command.expose != 'always',
             }
           end
         end
@@ -96,13 +88,14 @@ module Bashly
 
       # Returns only the names of the Commands
       def command_names
-        commands.map &:name
+        commands.map(&:name)
       end
 
       # Returns an array of the Commands
       def commands
-        return [] unless options["commands"]
-        options["commands"].map do |options|
+        return [] unless options['commands']
+
+        options['commands'].map do |options|
           result = Command.new options
           result.parents = parents + [name]
           result.parent_command = self
@@ -126,48 +119,51 @@ module Bashly
       # If any of this command's subcommands has the default option set to
       # true, this default command will be returned, nil otherwise.
       def default_command
-        commands.find { |c| c.default }
+        commands.find(&:default)
       end
 
       # Returns an array of all the default Args
       def default_args
-        args.select &:default
+        args.select(&:default)
       end
 
       # Returns an array of all the default Environment Variables
       def default_environment_variables
-        environment_variables.select &:default
+        environment_variables.select(&:default)
       end
 
       # Returns an array of all the default Flags
       def default_flags
-        flags.select &:default
+        flags.select(&:default)
       end
 
       # Returns an array of EnvironmentVariables
       def environment_variables
-        return [] unless options["environment_variables"]
-        options["environment_variables"].map do |options|
+        return [] unless options['environment_variables']
+
+        options['environment_variables'].map do |options|
           EnvironmentVariable.new options
         end
       end
 
       # Returns an array of examples
       def examples
-        return nil unless options["examples"]
-        options["examples"].is_a?(Array) ? options['examples'] : [options['examples']]
+        return nil unless options['examples']
+
+        options['examples'].is_a?(Array) ? options['examples'] : [options['examples']]
       end
 
       # Returns the bash filename that is expected to hold the user code
       # for this command
       def filename
-        options["filename"] || "#{action_name.to_underscore}_command.sh"
+        options['filename'] || "#{action_name.to_underscore}_command.#{Settings.partials_extension}"
       end
 
       # Returns an array of Flags
       def flags
-        return [] unless options["flags"]
-        options["flags"].map do |options|
+        return [] unless options['flags']
+
+        options['flags'].map do |options|
           Flag.new options
         end
       end
@@ -192,7 +188,7 @@ module Bashly
       # Returns the string for the group caption
       def group_string
         if group
-          strings[:group] % { group: group } 
+          strings[:group] % { group: group }
         else
           strings[:commands]
         end
@@ -200,18 +196,17 @@ module Bashly
 
       # Returns a mode identifier
       def mode
-        @mode ||= begin
-          if global_flags?               then :global_flags
-          elsif commands.any?            then :commands
-          elsif args.any? and flags.any? then :args_and_flags
-          elsif args.any?                then :args
-          elsif flags.any?               then :flags
-          else                           :empty
-          end
+        @mode ||= if global_flags?    then :global_flags
+        elsif commands.any?           then :commands
+        elsif args.any? && flags.any? then :args_and_flags
+        elsif args.any?               then :args
+        elsif flags.any?              then :flags
+        else
+          :empty
         end
       end
 
-      # Returns an array of all parents. For example, the command 
+      # Returns an array of all parents. For example, the command
       # "docker container run" will have [docker, container] as its parents
       def parents
         @parents ||= []
@@ -219,7 +214,7 @@ module Bashly
 
       # Returns only commands that are not private
       def public_commands
-        commands.reject &:private
+        commands.reject(&:private)
       end
 
       # Returns true if one of the args is repeatable
@@ -229,17 +224,17 @@ module Bashly
 
       # Returns an array of all the required Arguments
       def required_args
-        args.select &:required
+        args.select(&:required)
       end
 
       # Returns an array of all the required EnvironmentVariables
       def required_environment_variables
-        environment_variables.select &:required
+        environment_variables.select(&:required)
       end
 
       # Returns an array of all the required Flags
       def required_flags
-        flags.select &:required
+        flags.select(&:required)
       end
 
       # Returns true if this is the root command (no parents)
@@ -266,38 +261,37 @@ module Bashly
         result = [full_name]
 
         result.push case mode
-        when :global_flags    then ["[OPTIONS]", "COMMAND"]
-        when :commands        then ["COMMAND"]
-        when :args_and_flags  then usage_string_args + ["[OPTIONS]"]
+        when :global_flags    then ['[OPTIONS]', 'COMMAND']
+        when :commands        then ['COMMAND']
+        when :args_and_flags  then usage_string_args + ['[OPTIONS]']
         when :args            then usage_string_args
-        when :flags           then ["[OPTIONS]"]
-        else                  nil
+        when :flags           then ['[OPTIONS]']
         end
 
         result.push catch_all.usage_string if catch_all.enabled? && commands.empty?
-        result.compact.join " "
+        result.compact.join ' '
       end
 
       # Returns an array of args usage_string for the command's usage_string
       def usage_string_args
-        args.map { |arg| arg.usage_string }
+        args.map(&:usage_string)
       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.full_lib_dir}/**/*.sh"].sort
+        @user_lib ||= Dir["#{Settings.full_lib_dir}/**/*.#{Settings.partials_extension}"].sort
       end
 
       # Returns an array of all the args with a whitelist
       def whitelisted_args
-        args.select &:allowed
+        args.select(&:allowed)
       end
 
       # Returns an array of all the flags with a whitelist arg
       def whitelisted_flags
-        flags.select &:allowed
+        flags.select(&:allowed)
       end
     end
   end

data/lib/bashly/script/environment_variable.rb

@@ -3,15 +3,15 @@ module Bashly
     class EnvironmentVariable < Base
       class << self
         def option_keys
-          @option_keys ||= %i[default help name required]
+          @option_keys ||= %i[default help name required private]
         end
       end
-      
+
       def usage_string(extended: false)
         result = [name.upcase]
-        result << strings[:required] if required and extended
-        result.join " "
+        result << strings[:required] if required && extended
+        result.join ' '
       end
     end
   end
-end
+end

data/lib/bashly/script/flag.rb

@@ -11,9 +11,9 @@ module Bashly
           ]
         end
       end
-      
+
       def aliases
-        if long and short
+        if long && short
           [long, short]
         elsif long
           [long]
@@ -27,12 +27,12 @@ module Bashly
       end
 
       def usage_string(extended: false)
-        result = [aliases.join(", ")]
+        result = [aliases.join(', ')]
         result << arg.upcase if arg
-        result << strings[:required] if required and extended
-        result << strings[:repeatable] if repeatable and extended
-        result.join " "
+        result << strings[:required] if required && extended
+        result << strings[:repeatable] if repeatable && extended
+        result.join ' '
       end
     end
   end
-end
+end

data/lib/bashly/script/wrapper.rb

@@ -6,7 +6,8 @@ module Bashly
       attr_reader :command, :function_name
 
       def initialize(command, function_name = nil)
-        @command, @function_name = command, function_name
+        @command = command
+        @function_name = function_name
       end
 
       def code(tab_indent: false)
@@ -38,18 +39,18 @@ module Bashly
       end
 
       def default_header
-        result = render('header')
+        result = render 'header'
         result += render('bash3_bouncer') unless function_name
         result
       end
 
       def body
-        @body ||= command.render('master_script')
+        @body ||= command.render 'master_script'
       end
 
       def custom_header_path
-        @custom_header_path ||= "#{Settings.source_dir}/header.sh"
+        @custom_header_path ||= "#{Settings.source_dir}/header.#{Settings.partials_extension}"
       end
     end
   end
-end
+end

data/lib/bashly/settings.rb

@@ -3,47 +3,51 @@ module Bashly
     class << self
       include AssetHelper
 
-      attr_writer :compact_short_flags, :source_dir, :target_dir,
-        :lib_dir, :strict, :tab_indent
+      attr_writer :compact_short_flags, :lib_dir, :partials_extension,
+        :source_dir, :strict, :tab_indent, :target_dir
 
-      def source_dir
-        @source_dir ||= get :source_dir
+      def compact_short_flags
+        @compact_short_flags ||= get :compact_short_flags
       end
 
-      def target_dir
-        @target_dir ||= get :target_dir
+      def env
+        @env ||= get(:env)&.to_sym
       end
 
-      def lib_dir
-        @lib_dir ||= get :lib_dir
+      def env=(value)
+        @env = value&.to_sym
       end
 
-      def strict
-        @strict ||= get :strict
+      def full_lib_dir
+        "#{source_dir}/#{lib_dir}"
       end
 
-      def tab_indent
-        @tab_indent ||= get :tab_indent
+      def lib_dir
+        @lib_dir ||= get :lib_dir
       end
 
-      def compact_short_flags
-        @compact_short_flags ||= get :compact_short_flags
+      def partials_extension
+        @partials_extension ||= get :partials_extension
       end
 
-      def env
-        @env ||= get(:env)&.to_sym
+      def production?
+        env == :production
       end
 
-      def env=(value)
-        @env = value&.to_sym
+      def source_dir
+        @source_dir ||= get :source_dir
       end
 
-      def production?
-        env == :production
+      def strict
+        @strict ||= get :strict
       end
 
-      def full_lib_dir
-        "#{source_dir}/#{lib_dir}"
+      def tab_indent
+        @tab_indent ||= get :tab_indent
+      end
+
+      def target_dir
+        @target_dir ||= get :target_dir
       end
 
     private
@@ -51,8 +55,8 @@ module Bashly
       def get(key)
         case env_value key
         when nil                 then config[key.to_s]
-        when "0", "false", "no"  then false
-        when "1", "true", "yes"  then true
+        when '0', 'false', 'no'  then false
+        when '1', 'true', 'yes'  then true
         else                     env_value key
         end
       end
@@ -70,13 +74,12 @@ module Bashly
       end
 
       def defsult_settings
-        @defsult_settings ||= Config.new(default_settings_path)
+        @defsult_settings ||= Config.new default_settings_path
       end
 
       def default_settings_path
-        asset "templates/settings.yml"
+        asset 'templates/settings.yml'
       end
-
     end
   end
 end

data/lib/bashly/templates/help/help_command.sh

@@ -0,0 +1,30 @@
+## Help command [@bashly-upgrade help]
+## This file is a part of Bashly standard library
+##
+## Add this as a command to your bashly.yml:
+##
+##   commands:
+##     - name: help
+##       help: Show help about a command
+##       args:
+##       - name: command
+##         help: Help subject
+##
+command="${args[command]}"
+long_usage=yes
+
+if [[ -z "$command" ]]; then
+  # No command argument, show the global help
+  help_function=%{name}_usage
+else
+  # Show the help for the requested command
+  help_function="%{name}_${command}_usage"
+fi
+
+# Call the help function if it exists
+if [[ $(type -t "$help_function") ]]; then
+  "$help_function"
+else
+  echo "No help available for this command"
+  exit 1
+fi

data/lib/bashly/templates/lib/colors.sh

@@ -14,9 +14,9 @@ print_in_color() {
   local color="$1"
   shift
   if [[ -z ${NO_COLOR+x} ]]; then
-    printf "$color%b\e[0m\n" "$*";
+    printf "$color%b\e[0m\n" "$*"
   else
-    printf "%b\n" "$*";
+    printf "%b\n" "$*"
   fi
 }
 

data/lib/bashly/templates/lib/config.sh

@@ -24,13 +24,13 @@ config_get() {
   local value=""
 
   config_init
-  
+
   while IFS= read -r line || [ -n "$line" ]; do
     if [[ $line =~ $regex ]]; then
       value="${BASH_REMATCH[1]}"
       break
     fi
-  done < "$CONFIG_FILE"
+  done <"$CONFIG_FILE"
 
   echo "$value"
 }
@@ -48,7 +48,7 @@ config_set() {
   local output=""
   local found_key=""
   local newline
-  
+
   while IFS= read -r line || [ -n "$line" ]; do
     newline=$line
     if [[ $line =~ $regex ]]; then
@@ -58,13 +58,13 @@ config_set() {
     elif [[ $line ]]; then
       output="$output$line\n"
     fi
-  done < "$CONFIG_FILE"
+  done <"$CONFIG_FILE"
 
   if [[ -z $found_key ]]; then
     output="$output$key = $value\n"
   fi
 
-  printf "%b\n" "$output" > "$CONFIG_FILE"
+  printf "%b\n" "$output" >"$CONFIG_FILE"
 }
 
 ## Delete a key from the config.
@@ -81,9 +81,9 @@ config_del() {
     if [[ $line ]] && [[ ! $line =~ $regex ]]; then
       output="$output$line\n"
     fi
-  done < "$CONFIG_FILE"
+  done <"$CONFIG_FILE"
 
-  printf "%b\n" "$output" > "$CONFIG_FILE"
+  printf "%b\n" "$output" >"$CONFIG_FILE"
 }
 
 ## Show the config file
@@ -106,20 +106,20 @@ config_keys() {
 
   local keys=()
   local key
-  
+
   while IFS= read -r line || [ -n "$line" ]; do
     if [[ $line =~ $regex ]]; then
       key="${BASH_REMATCH[1]}"
       keys+=("$key")
     fi
-  done < "$CONFIG_FILE"
+  done <"$CONFIG_FILE"
   echo "${keys[@]}"
 }
 
 ## Returns true if the specified key exists in the config file.
 ## Usage:
 ##
-##   if config_has_key "key" ; then
+##   if config_has_key "key"; then
 ##     echo "key exists"
 ##   fi
 ##

data/lib/bashly/templates/lib/yaml.sh

@@ -11,16 +11,16 @@
 ##   eval $(yaml_load "settings.yml")     # create variables in scope
 ##
 yaml_load() {
-   local prefix=$2
-   local s='[[:space:]]*' w='[a-zA-Z0-9_]*'
-   local fs
+  local prefix=$2
+  local s='[[:space:]]*' w='[a-zA-Z0-9_]*'
+  local fs
 
-   fs=$(echo @|tr @ '\034')
+  fs=$(echo @ | tr @ '\034')
 
-   sed -ne "s|^\($s\):|\1|" \
-        -e "s|^\($s\)\($w\)$s:${s}[\"']\(.*\)[\"']$s\$|\1$fs\2$fs\3|p" \
-        -e "s|^\($s\)\($w\)$s:$s\(.*\)$s\$|\1$fs\2$fs\3|p"  "$1" |
-   awk -F"$fs" '{
+  sed -ne "s|^\($s\):|\1|" \
+    -e "s|^\($s\)\($w\)$s:${s}[\"']\(.*\)[\"']$s\$|\1$fs\2$fs\3|p" \
+    -e "s|^\($s\)\($w\)$s:$s\(.*\)$s\$|\1$fs\2$fs\3|p" "$1" |
+    awk -F"$fs" '{
       indent = length($1)/2;
       vname[indent] = $2;
       for (i in vname) {if (i > indent) {delete vname[i]}}
@@ -28,5 +28,5 @@ yaml_load() {
          vn=""; for (i=0; i<indent; i++) {vn=(vn)(vname[i])("_")}
          printf("%s%s%s=\"%s\"\n", "'"$prefix"'",vn, $2, $3);
       }
-   }'
+    }'
 }

data/lib/bashly/templates/settings.yml

@@ -30,3 +30,6 @@ compact_short_flags: true
 # - production    generate a smaller script, without file markers
 # - development   generate with file markers
 env: development
+
+# The extension to use when reading/writing partial script snippets.
+partials_extension: sh