bashly 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a4a6b6397239e1fc2b30d3f7cace59aa6bff9b305cfad97b43567dd49cd9eeb8
+  data.tar.gz: 27eb14cc3d2f833dec9e218b3affc0e5d90fc0a4cb258e769127590b501a50ac
+SHA512:
+  metadata.gz: 0d907d581476cd66f71078319e1d1290f824d2fbbeac6315cd54988ce1068daf59c31e8ab383b498e7aae4955b7d3b2c225e3a3c701aead077527266d7e7dbe5
+  data.tar.gz: 8ca10f7db1dd3f2fb03909e60b32f858220b85fd3a961d5c8c2b19e19026238fbce5a1c99ac66b8f3949e217ebdd0cd107cb430d74ff060f4e960f511ab9c6a5

data/README.md

@@ -0,0 +1,48 @@
+Bashly - Bbash CLI Generator
+==================================================
+
+Create beautiful bash scripts from simple YAML configuration.
+
+![demo](demo/cast.svg)
+
+---
+
+Installation
+--------------------------------------------------
+
+    $ gem install bashly
+
+
+Usage
+--------------------------------------------------
+
+In an empty directory, create a sample configuration file by running
+
+    $ bashly init
+    # or, to generate a simpler configuration:
+    $ bashly init --minimal
+
+This will create a sample `src/bashly.yml` file.
+You can edit this file to specify which arguments, flags and subcommands you
+need in your bash script.
+
+Then, generate an initial bash script and function placeholder scripts by
+running
+
+    $ bashly generate
+
+This will:
+
+1. Create the bash executable script.
+2. Create files for you to edit in the `src` folder.
+
+Finally, edit the files in the `src` folder. Each of your script's commands
+get their own file. Once you edit, run `bashly generate` again to merge the
+content from your functions back into the script.
+
+
+Contributing / Support
+--------------------------------------------------
+
+If you experience any issue, have a question or a suggestion, or if you wish
+to contribute, feel free to [open an issue][issues].

data/bin/bashly

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+require 'bashly'
+require 'colsole'
+include Colsole
+
+runner = Bashly::CLI.runner
+
+begin
+  exit runner.run ARGV
+rescue Bashly::Interrupt
+  say! "\nGoodbye"
+  exit 1  
+rescue => e
+  puts e.backtrace.reverse if ENV['DEBUG']
+  say! "!undred!#{e.class}!txtrst!\n#{e.message}"
+  exit 1
+end

data/lib/bashly.rb

@@ -0,0 +1,12 @@
+require 'requires'
+
+if ENV['BYEBUG']
+  require 'byebug'
+  require 'lp'
+end
+
+requires 'bashly/settings'
+requires 'bashly/exceptions'
+requires 'bashly/concerns'
+requires 'bashly/models/base'
+requires 'bashly'

data/lib/bashly/cli.rb

@@ -0,0 +1,19 @@
+require 'mister_bin'
+
+module Bashly
+  # The CLI class is used by the bashly binary and forwards incoming CLI 
+  # commands to the relevant Bashly::Commands class
+  class CLI
+    def self.runner
+      runner = MisterBin::Runner.new version: Bashly::VERSION,
+        header: "Bashly - Bash CLI Generator"
+
+      runner.route 'init',      to: Commands::Init
+      runner.route 'preview',   to: Commands::Preview
+      runner.route 'generate',  to: Commands::Generate
+
+      runner
+    end
+  end
+
+end

data/lib/bashly/commands/generate.rb

@@ -0,0 +1,67 @@
+require 'mister_bin'
+
+module Bashly
+  module Commands
+    class Generate < MisterBin::Command
+      help "Generate the bash script and required files"
+
+      usage "bashly generate [--force]"
+      usage "bashly generate (-h|--help)"
+
+      option "-f --force", "Overwrite existing files"
+
+      environment "BASHLY_SOURCE_DIR", "The path to use for creating the configuration file [default: src]"
+      environment "BASHLY_TARGET_DIR", "The path to use for creating the bash script [default: .]"
+
+      def run
+        create_user_files
+        create_master_script
+        say "run !txtpur!#{master_script_path} --help!txtrst! to test your bash script"
+      end
+
+    private
+
+      def create_user_files
+        say "creating user files in !txtgrn!#{Settings.source_dir}"
+
+        if command.commands.empty?
+          create_file "#{Settings.source_dir}/root_command.sh", command.render(:default_root_script)
+        end
+        
+        command.commands.each do |subcommand|
+          file = "#{Settings.source_dir}/#{subcommand.full_name.to_underscore}_command.sh"
+          content = subcommand.render :default_script
+          create_file file, content
+        end
+      end
+
+      def create_file(file, content)
+        if File.exist? file and !args['--force']
+          say "skipped !txtgrn!#{file}!txtrst! (exists)"
+        else
+          File.write file, content
+          say "created !txtgrn!#{file}"
+        end
+      end
+
+      def create_master_script
+        master_script = command.render 'master_script'
+        File.write master_script_path, master_script
+        say "created !txtgrn!#{master_script_path}"
+      end
+
+      def master_script_path
+        "#{Settings.target_dir}/#{command.name}"
+      end
+
+      def config
+        @config ||= Config.new "#{Settings.source_dir}/bashly.yml"
+      end
+
+      def command
+        @command ||= Models::Command.new config
+      end
+
+    end
+  end
+end

data/lib/bashly/commands/init.rb

@@ -0,0 +1,53 @@
+require 'mister_bin'
+
+module Bashly
+  module Commands
+    class Init < MisterBin::Command
+      summary "Initialize a new workspace"
+      help "This command will create the source folder, and place a template configuration file in it."
+
+      usage "bashly init [--minimal]"
+      usage "bashly init (-h|--help)"
+
+      option "-m --minimal", "Use a minimal configuration file (without subcommands)"
+
+      environment "BASHLY_SOURCE_DIR", "The path to use for creating the configuration file [default: src]"
+
+      def run
+        if Dir.exist? target_dir and !Dir.empty? target_dir
+          raise InitError, "Directory !txtgrn!#{target_dir}!txtrst! already exists and is not empty"
+        end
+        Dir.mkdir target_dir unless Dir.exist? target_dir
+        File.write "#{target_dir}/bashly.yml", yaml_content
+        say "created !txtgrn!#{target_dir}/bashly.yml"
+        say "run !txtpur!bashly generate!txtrst! to create the bash script"
+      end
+
+    private
+
+      def yaml_content
+        @yaml_content ||= yaml_content!
+      end
+
+      def yaml_content!
+        if args['--minimal']
+          File.read minimal_template_file
+        else
+          File.read template_file
+        end
+      end
+
+      def template_file
+        File.expand_path '../templates/bashly.yml', __dir__
+      end
+
+      def minimal_template_file
+        File.expand_path '../templates/minimal.yml', __dir__
+      end
+
+      def target_dir
+        @target_dir ||= Settings.source_dir
+      end
+    end
+  end
+end

data/lib/bashly/commands/preview.rb

@@ -0,0 +1,20 @@
+require 'mister_bin'
+
+module Bashly
+  module Commands
+    class Preview < MisterBin::Command
+      help "Generate the bash script to STDOUT"
+
+      usage "bashly preview"
+      usage "bashly preview (-h|--help)"
+
+      environment "BASHLY_SOURCE_DIR", "The path containing the bashly configuration and source files [default: src]"
+
+      def run
+        config = Config.new "#{Settings.source_dir}/bashly.yml"
+        command = Models::Command.new(config)
+        puts command.render 'master_script'
+      end
+    end
+  end
+end

data/lib/bashly/concerns/renderable.rb

@@ -0,0 +1,26 @@
+module Bashly
+  module Renderable
+    def render(view)
+      template = File.read view_path(view)
+      ERB.new(template, nil, '%-').result(binding)
+    end
+
+  private
+
+    def view_path(view)
+      "#{self_views_path}/#{view}.erb"
+    end
+
+    def self_views_path
+      @self_view_path ||= "#{base_views_path}/#{views_subfolder}"
+    end
+
+    def base_views_path
+      @base_views_path ||= File.expand_path("../views/", __dir__)
+    end
+
+    def views_subfolder
+      @views_subfolder ||= self.class.name.split('::').last.to_underscore
+    end
+  end
+end

data/lib/bashly/config.rb

@@ -0,0 +1,17 @@
+require 'yaml'
+
+module Bashly
+  # A convenience class to use either a hash or a filename as a configuration
+  # source
+  class Config
+    attr_reader :config
+
+    def self.new(config)
+      if config.is_a? String
+        YAML.load_file config
+      else
+        config
+      end
+    end
+  end
+end

data/lib/bashly/exceptions.rb

@@ -0,0 +1,6 @@
+module Bashly
+  class Interrupt < Interrupt; end
+  class Error < StandardError; end
+  class InitError < Error; end
+  class ConfigurationError < Error; end
+end

data/lib/bashly/extensions/array.rb

@@ -0,0 +1,7 @@
+class Array
+  def indent(offset)
+    return self unless offset > 0
+    indentation = " " * offset
+    map { |line| "#{indentation}#{line}" }
+  end
+end

data/lib/bashly/extensions/string.rb

@@ -0,0 +1,20 @@
+require 'erb'
+require 'ostruct'
+
+class String
+  def indent(offset)
+    return self unless offset > 0
+    split("\n").indent(offset).join("\n")
+  end
+
+  def to_underscore!
+    gsub!(/(.)([A-Z])/,'\1_\2')
+    gsub!(' ', '_')
+    downcase!
+  end
+
+  def to_underscore
+    dup.tap { |s| s.to_underscore! }
+  end
+
+end

data/lib/bashly/models/argument.rb

@@ -0,0 +1,18 @@
+module Bashly
+  module Models
+    class Argument < Base
+      def optional
+        !required
+      end
+
+      def usage_string
+        required ? name.upcase : "[#{name.upcase}]"
+      end
+
+      def summary
+        return "" unless help
+        help.split("\n").first
+      end
+    end
+  end
+end

data/lib/bashly/models/base.rb

@@ -0,0 +1,38 @@
+module Bashly
+  module Models
+    class Base
+      include Renderable
+
+      attr_reader :options
+
+      OPTION_KEYS = %i[
+        arg
+        description
+        flags
+        help
+        long
+        name
+        parent_name
+        required
+        short
+        version
+      ]
+
+      def initialize(options)
+        raise Error, "Invalid options provided" unless options.respond_to? :keys
+        @options = options
+        verify if respond_to? :verify
+      end
+
+      def method_missing(method_name, *arguments, &block)
+        key = method_name.to_s
+        respond_to?(method_name) ? options[key] : super
+      end
+
+      def respond_to?(method_name, include_private = false)
+        # options.has_key?(method_name.to_s) || super
+        OPTION_KEYS.include?(method_name) || super
+      end
+    end
+  end
+end

data/lib/bashly/models/command.rb

@@ -0,0 +1,104 @@
+module Bashly
+  module Models
+    class Command < Base
+      # Returns all the possible aliases for this command
+      def aliases
+        short ? [name, short] : [name]
+      end
+
+      # Returns an array of Arguments
+      def args
+        return [] unless options["args"]
+        options["args"].map do |options|
+          Argument.new options
+        end
+      end
+
+      # Returns a string suitable to be a headline
+      def caption_string
+        help ? "#{full_name} - #{summary}" : full_name
+      end
+
+      # Returns only the names of the subcommands (Commands)
+      def command_names
+        commands.map &:name
+      end
+
+      # Returns an array of the subcommands (Commands)
+      def commands
+        return [] unless options["commands"]
+        options["commands"].map do |options|
+          options['parent_name'] = full_name
+          command = Command.new options
+        end
+      end
+
+      # Returns an array of Flags
+      def flags
+        return [] unless options["flags"]
+        options["flags"].map do |options|
+          Flag.new options
+        end
+      end
+
+      # Returns the name of the command, including its parent name (in case
+      # this is a subcommand)
+      def full_name
+        parent_name ? "#{parent_name} #{name}" : name
+      end
+
+      # Reads a file from the userspace (Settings.source_dir) and returns
+      # its contents. 
+      # If the file is not found, returns a string with a hint.
+      def load_user_file(file)
+        path = "#{Settings.source_dir}/#{file}"
+        content = if File.exist? path
+          File.read path
+        else
+          "# error: cannot load file"
+        end
+        "# :#{path}\n#{content}"
+      end
+
+      # Returns an array of all the required Arguments
+      def required_args
+        args.select &:required
+      end
+
+      # Returns an array of all the required Flags
+      def required_flags
+        flags.select &:required
+      end
+
+      # Returns the first line of the help message
+      def summary
+        return "" unless help
+        help.split("\n").first
+      end
+
+      # Returns a constructed string suitable for Usage pattern
+      def usage_string
+        result = [full_name]
+        result << "[command]" if commands.any?
+        args.each do |arg|
+          result << arg.usage_string
+        end
+        result << "[options]"
+        result.join " "
+      end
+
+      def verify
+        if commands.any?
+          if args.any? or flags.any?
+            raise ConfigurationError, "Error in the !txtgrn!#{full_name}!txtrst! command.\nThe !txtgrn!commands!txtrst! key cannot be at the same level as the !txtgrn!args!txtrst! or !txtgrn!flags!txtrst! keys."
+          end
+
+          if parent_name
+            raise ConfigurationError, "Error in the !txtgrn!#{full_name}!txtrst! command.\nNested commands are not supported."
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/bashly/models/flag.rb

@@ -0,0 +1,31 @@
+module Bashly
+  module Models
+    class Flag < Base
+      def aliases
+        if long and short
+          [long, short]
+        elsif long
+          [long]
+        else
+          [short]
+        end
+      end
+
+      def optional
+        !required
+      end
+
+      def summary
+        return "" unless help
+        help.split("\n").first
+      end
+
+      def usage_string(extended: false)
+        result = [aliases.join(", ")]
+        result << arg.upcase if arg
+        result << "(required)" if required and extended
+        result.join " "
+      end
+    end
+  end
+end

data/lib/bashly/settings.rb

@@ -0,0 +1,15 @@
+module Bashly
+  class Settings
+    class << self
+      attr_writer :source_dir, :target_dir
+
+      def source_dir
+        @source_dir ||= ENV['BASHLY_SOURCE_DIR'] || 'src'
+      end
+
+      def target_dir
+        @target_dir ||= ENV['BASHLY_TARGET_DIR'] || '.'
+      end
+    end
+  end
+end

data/lib/bashly/templates/bashly.yml

@@ -0,0 +1,39 @@
+name: cli
+help: Sample application
+version: 0.1.0
+
+commands:
+- name: download
+  short: d
+  help: Download a file
+
+  args:
+  - name: source
+    required: true
+    help: URL to download from
+  - name: target
+    help: "Target filename (default: same as source)"
+
+  flags:
+  - long: --force
+    short: -f
+    help: Overwrite existing files
+
+- name: upload
+  short: u
+  help: Upload a file
+  args:
+  - name: source
+    required: true
+    help: File to upload
+
+  flags:
+  - long: --user
+    short: -u
+    arg: user
+    help: Username to use for logging in
+    required: true
+  - long: --password
+    short: -p
+    arg: password
+    help: Password to use for logging in

data/lib/bashly/templates/minimal.yml

@@ -0,0 +1,16 @@
+name: download
+help: Sample minimal application without subcommands
+version: 0.1.0
+
+args:
+- name: source
+  required: true
+  help: URL to download from
+- name: target
+  help: "Target filename (default: same as source)"
+
+flags:
+- long: --force
+  short: -f
+  help: Overwrite existing files
+

data/lib/bashly/version.rb

@@ -0,0 +1,3 @@
+module Bashly
+  VERSION = "0.1.0"
+end

data/lib/bashly/views/argument/usage.erb

@@ -0,0 +1,4 @@
+# :argument.usage
+echo "  <%= name.upcase %>"
+echo "    <%= summary %>"
+echo

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

@@ -0,0 +1,25 @@
+# :command.command_filter
+<%- if commands.any? -%>
+action=$1
+
+case $action in
+-* )
+  ;;
+
+<%- commands.each do |command| -%>
+<%= command.aliases.join " | " %> )
+  shift
+  <%= command.name %>_parse_args "$@"
+  shift $#
+  ;;    
+
+<%- end -%>
+* )
+  <%= name %>_usage
+  exit 1
+  ;;
+
+esac
+<%- else -%>
+action=root
+<%- end -%>

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

@@ -0,0 +1,4 @@
+# :command.command_functions
+<%- commands.each do |command| -%>
+<%= command.render :function %>
+<%- end -%>

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

@@ -0,0 +1,3 @@
+echo "# this file is located in '<%= Settings.source_dir %>/root_command.sh'"
+echo "# you can edit it freely and regenerate (it will not be overwritten)"
+inspect_args

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

@@ -0,0 +1,4 @@
+echo "# this file is located in '<%= Settings.source_dir %>/<%= full_name.to_underscore %>_command.sh'"
+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/fixed_flags_filter.erb

@@ -0,0 +1,14 @@
+# :command.fixed_flag_filter
+case "$1" in
+--version | -v ) 
+  version_command
+  exit 1
+  ;;
+
+--help | -h ) 
+  long_usage=yes
+  <%= full_name.to_underscore %>_usage
+  exit 1
+  ;;
+
+esac

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

@@ -0,0 +1,4 @@
+# :command.function
+<%= full_name.to_underscore %>_command() {
+<%= load_user_file("#{full_name.to_underscore}_command.sh").indent 2 %>
+}

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

@@ -0,0 +1,6 @@
+# :command.initialize
+initialize() {
+  version="<%= version %>"
+  long_usage=''
+  set -e  
+}

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

@@ -0,0 +1,5 @@
+# :command.inspect_args
+inspect_args() {
+  echo args:
+  for k in "${!args[@]}"; do echo "- \${args[$k]}" = ${args[$k]}; done
+}

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

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+<%= render :root_command if commands.empty? %>
+<%= render :version_command %>
+<%= render :usage %>
+<%= render :inspect_args %>
+<%= render :command_functions %>
+<%= render :parse_args %>
+<%= render :initialize %>
+<%= render :run %>
+
+initialize
+run "$@"

data/lib/bashly/views/command/parse_args.erb

@@ -0,0 +1,12 @@
+# :command.parse_args
+parse_args() {
+<%= render(:fixed_flags_filter).indent 2 %>
+<%= render(:command_filter).indent 2 %>
+<%= render(:required_args_filter).indent 2 %>
+<%= render(:required_flags_filter).indent 2 %>
+<%= render(:parse_args_while).indent 2 %>
+}
+
+<%- commands.each do |command| %>
+<%= command.render 'parse_args_secondary' %>
+<%- end -%>

data/lib/bashly/views/command/parse_args_case.erb

@@ -0,0 +1,17 @@
+# :command.parse_args_case
+<%- if args.any? -%>
+<%- condition = "if" -%>
+<%- args.each do |arg| -%>
+<%= condition %> [[ ! ${args[<%= arg.name %>]} ]]; then
+  args[<%= arg.name %>]=$1
+  shift
+<%- condition = "elif" -%>
+<%- end -%>
+else
+  echo invalid argument: $key
+  exit 1
+fi
+<%- else -%>
+echo invalid argument: $key
+exit 1
+<%- end -%>

data/lib/bashly/views/command/parse_args_secondary.erb

@@ -0,0 +1,7 @@
+# :command.parse_args_secondary
+<%= name %>_parse_args() {
+<%= render(:fixed_flags_filter).indent 2 %>
+<%= render(:required_args_filter).indent 2 %>
+<%= render(:required_flags_filter).indent 2 %>
+<%= render(:parse_args_while).indent 2 %>
+}

data/lib/bashly/views/command/parse_args_while.erb

@@ -0,0 +1,20 @@
+# :command.parse_args_while
+while [[ $# -gt 0 ]]; do
+  key="$1"
+  case "$key" in
+  <%- flags.each do |flag| -%>
+<%= flag.render(:case).indent 2 %>
+
+  <%- end -%>
+
+  -* )
+    echo invalid option: $key
+    exit 1
+    ;;
+
+  * )
+<%= render(:parse_args_case).indent 4 %>
+    ;;
+
+  esac
+done

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

@@ -0,0 +1,12 @@
+# :command.required_args_filter
+<%- required_args.each do |arg| -%>
+if [[ $1 && $1 != -* ]]; then
+  args[<%= arg.name %>]=$1
+  shift
+else
+  echo missing required argument: <%= arg.name.upcase %>
+  echo Usage: <%= usage_string %>
+  exit 1
+fi
+
+<%- end %>

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

@@ -0,0 +1,7 @@
+# :command.required_flags_filter
+<%- required_flags.each do |flag| -%>
+if [[ <%= flag.aliases.map { |a| "$* != *#{a}*" }.join " && " %> ]]; then
+  echo "missing required flag: <%= flag.usage_string %>"
+  exit 1
+fi
+<%- end %>

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

@@ -0,0 +1,4 @@
+# :command.root_command
+root_command() {
+<%= load_user_file("root_command.sh").indent 2 %>
+}

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

@@ -0,0 +1,25 @@
+# :command.run
+run() {
+  declare -A args
+  parse_args "$@"
+
+  <%- condition = "if" -%>
+  <%- commands.each do |command| -%>
+  <%= condition %> [[ $action == "<%= command.name %>" ]]; then
+    if [[ ${args[--help]} ]]; then
+      long_usage=yes
+      <%= command.full_name.to_underscore %>_usage
+    else
+      <%= command.full_name.to_underscore %>_command
+    fi
+  <% condition = "elif" %>
+  <%- end -%>
+  <%= condition %> [[ ${args[--version]} ]]; then
+    version_command
+  elif [[ ${args[--help]} ]]; then
+    long_usage=yes
+    <%= name %>_usage
+  elif [[ $action == "root" ]]; then
+    root_command
+  fi
+}

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

@@ -0,0 +1,21 @@
+# :command.usage
+<%= full_name.to_underscore %>_usage() {
+  echo "<%= caption_string %>"
+  echo 
+  echo "Usage:"
+  echo "  <%= usage_string %>"
+  echo
+<%= render(:usage_commands).indent 2 if commands.any? %>
+
+  if [[ -n $long_usage ]]; then
+    echo "Options:"
+<%= render(:usage_fixed_flags).indent 4 %>
+<%= render(:usage_flags).indent 4 if flags.any? %>
+<%= render(:usage_args).indent 4 if args.any? %>
+
+  fi
+}
+
+<%- commands.each do |command| -%>
+<%= command.render 'usage' %>
+<%- end -%>

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

@@ -0,0 +1,6 @@
+# :command.usage_args
+echo "Arguments:"
+
+<%- args.each do |arg| -%>
+<%= arg.render(:usage) %>
+<%- end -%>

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

@@ -0,0 +1,7 @@
+# :command.usage_commands
+echo "Commands:"
+<%- maxlen = command_names.map(&:size).max -%>
+<%- commands.each do |command| -%>
+echo "  <%= command.name.ljust maxlen %>   <%= command.summary  %>"
+<%- end -%>
+echo

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

@@ -0,0 +1,7 @@
+# :command.usage_fixed_flags
+echo "  --help, -h"
+echo "    Show this help"
+echo
+echo "  --version"
+echo "    Show version number"
+echo

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

@@ -0,0 +1,4 @@
+# :command.usage_flags
+<%- flags.each do |flag| -%>
+<%= flag.render(:usage) %>
+<%- end -%>

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

@@ -0,0 +1,4 @@
+# :command.version_command
+version_command() {
+  echo $version
+}

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

@@ -0,0 +1,16 @@
+# :flag.case
+<%= aliases.join " | " %> )
+  <%- if arg -%>
+  if [[ $2 && $2 != -* ]]; then
+    args[<%= long %>]="$2"
+    shift
+    shift
+  else
+    echo <%= long %> requires an argument: <%= usage_string %>
+    exit 1
+  fi
+  <%- else -%>
+  args[<%= long %>]=1
+  shift
+  <%- end -%>
+  ;;

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

@@ -0,0 +1,4 @@
+# :flag.usage
+echo "  <%= usage_string extended: true %>"
+echo "    <%= summary %>"
+echo

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: bashly
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Danny Ben Shitrit
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-11-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colsole
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: mister_bin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: requires
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: Generate bash command line tools using YAML configuration
+email: db@dannyben.com
+executables:
+- bashly
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/bashly
+- lib/bashly.rb
+- lib/bashly/cli.rb
+- lib/bashly/commands/generate.rb
+- lib/bashly/commands/init.rb
+- lib/bashly/commands/preview.rb
+- lib/bashly/concerns/renderable.rb
+- lib/bashly/config.rb
+- lib/bashly/exceptions.rb
+- lib/bashly/extensions/array.rb
+- lib/bashly/extensions/string.rb
+- lib/bashly/models/argument.rb
+- lib/bashly/models/base.rb
+- lib/bashly/models/command.rb
+- lib/bashly/models/flag.rb
+- lib/bashly/settings.rb
+- lib/bashly/templates/bashly.yml
+- lib/bashly/templates/minimal.yml
+- lib/bashly/version.rb
+- lib/bashly/views/argument/usage.erb
+- lib/bashly/views/command/command_filter.erb
+- lib/bashly/views/command/command_functions.erb
+- lib/bashly/views/command/default_root_script.erb
+- lib/bashly/views/command/default_script.erb
+- lib/bashly/views/command/fixed_flags_filter.erb
+- lib/bashly/views/command/function.erb
+- lib/bashly/views/command/initialize.erb
+- lib/bashly/views/command/inspect_args.erb
+- lib/bashly/views/command/master_script.erb
+- lib/bashly/views/command/parse_args.erb
+- lib/bashly/views/command/parse_args_case.erb
+- lib/bashly/views/command/parse_args_secondary.erb
+- lib/bashly/views/command/parse_args_while.erb
+- lib/bashly/views/command/required_args_filter.erb
+- lib/bashly/views/command/required_flags_filter.erb
+- lib/bashly/views/command/root_command.erb
+- lib/bashly/views/command/run.erb
+- lib/bashly/views/command/usage.erb
+- lib/bashly/views/command/usage_args.erb
+- lib/bashly/views/command/usage_commands.erb
+- lib/bashly/views/command/usage_fixed_flags.erb
+- lib/bashly/views/command/usage_flags.erb
+- lib/bashly/views/command/version_command.erb
+- lib/bashly/views/flag/case.erb
+- lib/bashly/views/flag/usage.erb
+homepage: https://github.com/dannyben/bashly
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Bash Command Line Tool Generator
+test_files: []