taco_it 1.5.1 → 1.5.2

data/bin/taco

@@ -12,7 +12,7 @@ end
 require 'taco/commander/import'
 
 program :name, 'taco'
-program :version, '1.5.1'
+program :version, '1.5.2'
 program :description, 'simple command line issue tracking'
 
 command :init do |c|

data/lib/taco/commander/blank.rb

@@ -0,0 +1,8 @@
+
+module Blank
+  def self.included base
+    base.class_eval do
+      instance_methods.each { |m| undef_method m unless m =~ /^__|object_id/ }
+    end
+  end
+end

data/lib/taco/commander/command.rb

@@ -0,0 +1,226 @@
+
+require 'optparse'
+
+module Commander
+  class Command
+    
+    attr_accessor :name, :examples, :syntax, :description
+    attr_accessor :summary, :proxy_options, :options
+    
+    ##
+    # Options struct.
+
+    class Options
+      include Blank
+      
+      def initialize
+        @table = {}
+      end
+      
+      def __hash__
+        @table
+      end
+      
+      def method_missing meth, *args, &block
+        meth.to_s =~ /=$/ ? @table[meth.to_s.chop.to_sym] = args.first : @table[meth]
+      end
+      
+      def default defaults = {}
+        @table = defaults.merge! @table
+      end
+      
+      def inspect
+        "<Commander::Command::Options #{ __hash__.map { |k,v| "#{k}=#{v.inspect}" }.join(', ') }>"
+      end
+    end
+        
+    ##
+    # Initialize new command with specified _name_.
+    
+    def initialize name
+      @name, @examples, @when_called = name.to_s, [], []
+      @options, @proxy_options = [], []
+      @argument_validator = nil
+    end
+    
+    ##
+    # Add a usage example for this command.
+    #
+    # Usage examples are later displayed in help documentation
+    # created by the help formatters.
+    #
+    # === Examples
+    #    
+    #   command :something do |c|
+    #     c.example "Should do something", "my_command something"
+    #   end
+    #
+    
+    def example description, command 
+      @examples << [description, command]
+    end
+    
+    
+    def arguments proc
+      @argument_validator = proc
+    end
+    
+    ##
+    # Add an option.
+    #
+    # Options are parsed via OptionParser so view it
+    # for additional usage documentation. A block may optionally be
+    # passed to handle the option, otherwise the _options_ struct seen below 
+    # contains the results of this option. This handles common formats such as:
+    #
+    #   -h, --help          options.help           # => bool
+    #   --[no-]feature      options.feature        # => bool
+    #   --large-switch      options.large_switch   # => bool
+    #   --file FILE         options.file           # => file passed
+    #   --list WORDS        options.list           # => array
+    #   --date [DATE]       options.date           # => date or nil when optional argument not set
+    #
+    # === Examples
+    #    
+    #   command :something do |c|
+    #     c.option '--recursive', 'Do something recursively'
+    #     c.option '--file FILE', 'Specify a file'
+    #     c.option('--info', 'Display info') { puts "handle with block" }
+    #     c.option '--[no-]feature', 'With or without feature'
+    #     c.option '--list FILES', Array, 'List the files specified'
+    #   
+    #     c.when_called do |args, options|
+    #       do_something_recursively if options.recursive
+    #       do_something_with_file options.file if options.file
+    #     end 
+    #   end
+    #
+    # === Help Formatters
+    #
+    # This method also parses the arguments passed in order to determine
+    # which were switches, and which were descriptions for the
+    # option which can later be used within help formatters
+    # using option[:switches] and option[:description].
+    #
+    # === Input Parsing
+    #
+    # Since Commander utilizes OptionParser you can pre-parse and evaluate
+    # option arguments. Simply require 'optparse/time', or 'optparse/date', as these
+    # objects must respond to #parse.
+    #
+    #   c.option '--time TIME', Time
+    #   c.option '--date [DATE]', Date
+    #
+    
+    def option *args, &block
+      switches, description = Runner.separate_switches_from_description(*args)
+      proc = block || option_proc(switches)
+      @options << {
+        :args => args,
+        :proc => proc,
+        :switches => switches,
+        :description => description,
+      }
+    end
+    
+    ##
+    # Handle execution of command. The handler may be a class, 
+    # object, or block (see examples below).
+    #
+    # === Examples
+    #    
+    #   # Simple block handling
+    #   c.when_called do |args, options|
+    #      # do something
+    #   end 
+    #   
+    #   # Create inst of Something and pass args / options
+    #   c.when_called MyLib::Command::Something
+    #   
+    #   # Create inst of Something and use arbitrary method
+    #    c.when_called MyLib::Command::Something, :some_method
+    #   
+    #   # Pass an object to handle callback (requires method symbol)
+    #   c.when_called SomeObject, :some_method
+    #
+    
+    def when_called *args, &block
+      raise ArgumentError, 'must pass an object, class, or block.' if args.empty? and !block
+      @when_called = block ? [block] : args
+    end
+    alias :action :when_called
+    
+    ##
+    # Run the command with _args_.
+    #
+    # * parses options, call option blocks
+    # * invokes when_called proc
+    #
+    
+    def run *args
+      call parse_options_and_call_procs(*args)
+    end
+    
+    #:stopdoc:
+    
+    ##
+    # Parses options and calls associated procs, 
+    # returning the arguments remaining.
+    
+    def parse_options_and_call_procs *args
+      return args if args.empty?
+      @options.inject OptionParser.new do |opts, option| 
+        opts.on(*option[:args], &option[:proc])
+        opts
+      end.parse! args
+    end
+    
+    ##
+    # Call the commands when_called block with _args_.
+    
+    def call args = []
+      object = @when_called.shift
+      meth = @when_called.shift || :call
+      options = proxy_option_struct
+      
+      if @argument_validator
+        raise ArgumentError.new("Unexpected arguments: #{args.join(' ')}") unless @argument_validator.call(args)
+      elsif args.size > 0
+        raise ArgumentError.new("Unexpected arguments: #{args.join(' ')}")
+      end
+      
+      case object
+      when Proc  ; object.call(args, options)
+      when Class ; meth != :call ? object.new.send(meth, args, options) : object.new(args, options)
+      else         object.send(meth, args, options) if object
+      end 
+    end
+    
+    ##
+    # Creates an Options instance populated with the option values
+    # collected by the #option_proc.
+    
+    def proxy_option_struct
+      proxy_options.inject Options.new do |options, (option, value)|
+        # options that are present will evaluate to true
+        value = true if value.nil?
+        options.__send__ :"#{option}=", value
+        options
+      end
+    end
+    
+    ##
+    # Option proxy proc used when a block is not explicitly passed
+    # via the #option method. This allows commander to auto-populate
+    # and work with option values.
+    
+    def option_proc switches
+      lambda { |value| proxy_options << [Runner.switch_to_sym(switches.last), value] } 
+    end
+    
+    def inspect 
+      "<Commander::Command:#{name}>"
+    end
+    
+  end
+end

data/lib/taco/commander/core_ext/array.rb

@@ -0,0 +1,26 @@
+
+class Array
+
+  ##
+  # Split _string_ into an array. Used in
+  # conjunction with Highline's #ask, or #ask_for_array
+  # methods, which must respond to #parse.
+  #
+  # This method allows escaping of whitespace. For example
+  # the arguments foo bar\ baz will become ['foo', 'bar baz']
+  #
+  # === Example
+  #
+  #   # ask invokes Array#parse
+  #   list = ask 'Favorite cookies:', Array
+  #
+  #   # or use ask_for_CLASS
+  #   list = ask_for_array 'Favorite cookies: '
+  #
+
+  def self.parse string
+    # Using reverse + lookahead to work around Ruby 1.8's lack of lookbehind
+    string.reverse.split(/\s(?!\\)/).reverse.map { |s| s.reverse.gsub('\\ ', ' ') }
+  end
+
+end

data/lib/taco/commander/core_ext/object.rb

@@ -0,0 +1,11 @@
+
+class Object
+
+  ##
+  # Return the current binding.
+  
+  def get_binding
+    binding
+  end
+
+end

data/lib/taco/commander/core_ext.rb

@@ -0,0 +1,3 @@
+
+require 'taco/commander/core_ext/array'
+require 'taco/commander/core_ext/object'

data/lib/taco/commander/delegates.rb

@@ -0,0 +1,13 @@
+
+module Commander
+  module Delegates
+    %w( add_command command program run! global_option 
+        commands alias_command default_command ).each do |meth|
+      eval <<-END, binding, __FILE__, __LINE__
+        def #{meth} *args, &block
+          ::Commander::Runner.instance.#{meth} *args, &block
+        end
+      END
+    end
+  end
+end

data/lib/taco/commander/help_formatters/base.rb

@@ -0,0 +1,18 @@
+
+module Commander
+  
+  ##
+  # = Help Formatter
+  #
+  # Commander's help formatters control the output when
+  # either the help command, or --help switch are called.
+  # The default formatter is Commander::HelpFormatter::Terminal.
+  
+  module HelpFormatter
+    class Base 
+      def initialize runner; @runner = runner  end
+      def render; 'Implement global help here' end
+      def render_command command; "Implement help for #{command.name} here" end
+    end
+  end
+end

data/lib/taco/commander/help_formatters/terminal/command_help.erb

@@ -0,0 +1,35 @@
+
+  <%= $terminal.color "NAME", :bold %>:
+
+    <%= @name %>
+<% if @syntax -%>
+
+  <%= $terminal.color "SYNOPSIS", :bold %>:
+
+    <%= @syntax -%>
+
+<% end -%>
+
+  <%= $terminal.color "DESCRIPTION", :bold %>:
+
+    <%= Commander::HelpFormatter.indent 4, (@description || @summary || 'No description.') -%>
+
+<% unless @examples.empty? -%>
+
+  <%= $terminal.color "EXAMPLES", :bold %>:
+	<% for description, command in @examples -%>
+
+    # <%= description %>
+    <%= command %>
+	<% end -%>
+<% end -%>
+<% unless @options.empty? -%>
+
+  <%= $terminal.color "OPTIONS", :bold %>:
+	<% for option in @options -%>
+
+    <%= option[:switches].join ', ' %> 
+        <%= option[:description] %>
+	<% end -%>
+<% end -%>
+

data/lib/taco/commander/help_formatters/terminal/help.erb

@@ -0,0 +1,36 @@
+  <%= $terminal.color "NAME", :bold %>:
+
+    <%= program :name %>
+
+  <%= $terminal.color "DESCRIPTION", :bold %>:
+
+    <%= Commander::HelpFormatter.indent 4, program(:description) %>
+
+  <%= $terminal.color "COMMANDS", :bold %>:
+<% for name, command in @commands.sort -%>
+	<% unless alias? name %>
+    <%= "%-20s %s" % [command.name, command.summary || command.description] -%>
+	<% end -%>
+<% end %>
+<% unless @aliases.empty? %>
+  <%= $terminal.color "ALIASES", :bold %>:
+  <% for alias_name, args in @aliases.sort %>
+    <%= "%-20s %s %s" % [alias_name, command(alias_name).name, args.join(' ')] -%>
+  <% end %>
+<% end %>
+<% unless @options.empty? -%>
+  <%= $terminal.color "GLOBAL OPTIONS", :bold %>:
+	<% for option in @options -%>
+
+    <%= option[:switches].join ', ' %> 
+        <%= option[:description] %>
+	<% end -%>
+<% end -%>
+<% if program :help -%>
+  <% for title, body in program(:help) %>
+  <%= $terminal.color title.to_s.upcase, :bold %>:
+
+    <%= body %>
+  <% end -%>
+<% end -%>
+

data/lib/taco/commander/help_formatters/terminal.rb

@@ -0,0 +1,20 @@
+
+require 'erb'
+
+module Commander
+  module HelpFormatter
+    class Terminal < Base
+      def render
+        template(:help).result @runner.get_binding
+      end
+      
+      def render_command command
+        template(:command_help).result command.get_binding
+      end
+      
+      def template name
+        ERB.new(File.read(File.join(File.dirname(__FILE__), 'terminal', "#{name}.erb")), nil, '-')
+      end
+    end
+  end
+end

data/lib/taco/commander/help_formatters/terminal_compact/command_help.erb

@@ -0,0 +1,27 @@
+
+  <%= @name %>
+<% if @syntax -%>
+
+  Usage: <%= @syntax %>
+<% end -%>
+<% if @description || @summary -%>
+
+  <%= @description || @summary %>
+<% end -%>
+<% unless @examples.empty? -%>
+
+  Examples:
+	<% for description, command in @examples -%>
+
+    # <%= description %>
+    <%= command %>
+	<% end -%>
+<% end -%>
+<% unless @options.empty? -%>
+
+  Options:
+<% for option in @options -%>
+    <%= "%-20s %s" % [option[:switches].join(', '), option[:description]] %> 
+<% end -%>
+<% end -%>
+

data/lib/taco/commander/help_formatters/terminal_compact/help.erb

@@ -0,0 +1,29 @@
+  <%= program :name %>
+
+  <%= program :description %>
+
+  Commands:
+<% for name, command in @commands.sort -%>
+<% unless alias? name -%>
+    <%= "%-20s %s" % [command.name, command.summary || command.description] %>
+<% end -%>
+<% end -%>
+<% unless @aliases.empty? %>
+  Aliases:
+<% for alias_name, args in @aliases.sort -%>
+    <%= "%-20s %s %s" % [alias_name, command(alias_name).name, args.join(' ')] %>
+<% end -%>
+<% end %>
+<% unless @options.empty? -%>
+  Global Options:
+<% for option in @options -%>
+    <%= "%-20s %s" % [option[:switches].join(', '), option[:description]] -%> 
+<% end -%>
+<% end -%>
+<% if program :help -%>
+  <% for title, body in program(:help) %>
+  <%= title %>:
+    <%= body %>
+  <% end %>
+<% end -%>
+

data/lib/taco/commander/help_formatters/terminal_compact.rb

@@ -0,0 +1,12 @@
+
+require 'erb'
+
+module Commander
+  module HelpFormatter
+    class TerminalCompact < Terminal
+      def template name
+        ERB.new(File.read(File.join(File.dirname(__FILE__), 'terminal_compact', "#{name}.erb")), nil, '-')
+      end
+    end
+  end
+end

data/lib/taco/commander/help_formatters.rb

@@ -0,0 +1,13 @@
+
+module Commander
+  module HelpFormatter
+    autoload :Base, 'taco/commander/help_formatters/base'
+    autoload :Terminal, 'taco/commander/help_formatters/terminal'
+    autoload :TerminalCompact, 'taco/commander/help_formatters/terminal_compact'
+
+    module_function
+    def indent amount, text
+      text.gsub("\n", "\n" + (' ' * amount))
+    end
+  end
+end

data/lib/taco/commander/import.rb

@@ -0,0 +1,8 @@
+
+require 'taco/commander'
+require 'taco/commander/delegates'
+
+include Commander::Delegates
+
+$terminal.wrap_at = HighLine::SystemExtensions.terminal_size.first - 5 rescue 80 if $stdin.tty?
+at_exit { run! }

data/lib/taco/commander/platform.rb

@@ -0,0 +1,8 @@
+
+module Commander
+  module Platform
+    def self.jruby?
+      defined?(RUBY_ENGINE) && (RUBY_ENGINE == 'jruby')
+    end
+  end
+end

data/lib/taco/commander/runner.rb

@@ -0,0 +1,405 @@
+
+require 'optparse'
+
+module Commander
+  class Runner
+    
+    #--
+    # Exceptions
+    #++
+
+    class CommandError < StandardError; end
+    class InvalidCommandError < CommandError; end
+    
+    ##
+    # Array of commands.
+    
+    attr_reader :commands
+    
+    ##
+    # Global options.
+    
+    attr_reader :options
+    
+    ##
+    # Hash of help formatter aliases.
+    
+    attr_reader :help_formatter_aliases
+
+    ##
+    # Initialize a new command runner. Optionally
+    # supplying _args_ for mocking, or arbitrary usage.
+    
+    def initialize args = ARGV
+      @args, @commands, @aliases, @options = args, {}, {}, []
+      @help_formatter_aliases = help_formatter_alias_defaults
+      @program = program_defaults
+      create_default_commands
+    end
+    
+    ##
+    # Return singleton Runner instance.
+    
+    def self.instance
+      @singleton ||= new
+    end
+    
+    ##
+    # Run command parsing and execution process.
+    
+    def run!
+      trace = false
+      require_program :version, :description
+      trap('INT') { abort program(:int_message) } if program(:int_message)
+      trap('INT') { program(:int_block).call } if program(:int_block)
+      global_option('-h', '--help', 'Display help documentation') do
+        args = @args - %w[-h --help]
+        command(:help).run(*args)
+        return
+      end
+      global_option('-v', '--version', 'Display version information') { say version; return } 
+      global_option('-t', '--trace', 'Display backtrace when an error occurs') { trace = true }
+      parse_global_options
+      remove_global_options options, @args
+      unless trace
+        begin
+          run_active_command
+        rescue InvalidCommandError => e
+          abort "Error: Invalid command. See 'taco --help' for more information."
+        rescue Exception => e
+          abort "Error: #{e.to_s}"
+        end
+      else
+        run_active_command
+      end
+    end
+    
+    ##
+    # Return program version.
+    
+    def version
+      '%s %s' % [program(:name), program(:version)]
+    end
+    
+    ##
+    # Assign program information.
+    #
+    # === Examples
+    #    
+    #   # Set data
+    #   program :name, 'Commander'
+    #   program :version, Commander::VERSION
+    #   program :description, 'Commander utility program.'
+    #   program :help, 'Copyright', '2008 TJ Holowaychuk'
+    #   program :help, 'Anything', 'You want'
+    #   program :int_message 'Bye bye!'
+    #   program :help_formatter, :compact
+    #   program :help_formatter, Commander::HelpFormatter::TerminalCompact
+    #   
+    #   # Get data
+    #   program :name # => 'Commander'
+    #
+    # === Keys
+    #
+    #   :version         (required) Program version triple, ex: '0.0.1'
+    #   :description     (required) Program description
+    #   :name            Program name, defaults to basename of executable
+    #   :help_formatter  Defaults to Commander::HelpFormatter::Terminal
+    #   :help            Allows addition of arbitrary global help blocks
+    #   :int_message     Message to display when interrupted (CTRL + C)
+    #
+    
+    def program key, *args, &block
+      if key == :help and !args.empty?
+        @program[:help] ||= {}
+        @program[:help][args.first] = args.at(1)
+      elsif key == :help_formatter && !args.empty?
+        @program[key] = (@help_formatter_aliases[args.first] || args.first)
+      elsif block
+        @program[key] = block
+      else
+        unless args.empty?
+          @program[key] = (args.count == 1 && args[0]) || args
+        end
+        @program[key]
+      end
+    end
+    
+    ##
+    # Creates and yields a command instance when a block is passed.
+    # Otherwise attempts to return the command, raising InvalidCommandError when
+    # it does not exist.
+    #
+    # === Examples
+    #    
+    #   command :my_command do |c|
+    #     c.when_called do |args|
+    #       # Code
+    #     end
+    #   end
+    #
+    
+    def command name, &block
+      yield add_command(Commander::Command.new(name)) if block
+      @commands[name.to_s]
+    end
+    
+    ##
+    # Add a global option; follows the same syntax as Command#option
+    # This would be used for switches such as --version, --trace, etc.
+    
+    def global_option *args, &block
+      switches, description = Runner.separate_switches_from_description *args
+      @options << {
+        :args => args,
+        :proc => block,
+        :switches => switches,
+        :description => description,
+      }
+    end
+    
+    ##
+    # Alias command _name_ with _alias_name_. Optionally _args_ may be passed
+    # as if they were being passed straight to the original command via the command-line.
+    
+    def alias_command alias_name, name, *args
+      @commands[alias_name.to_s] = command name
+      @aliases[alias_name.to_s] = args
+    end
+    
+    ##
+    # Default command _name_ to be used when no other
+    # command is found in the arguments.
+    
+    def default_command name
+      @default_command = name
+    end
+    
+    ##
+    # Add a command object to this runner.
+    
+    def add_command command
+      @commands[command.name] = command
+    end
+    
+    ##
+    # Check if command _name_ is an alias.
+    
+    def alias? name
+      @aliases.include? name.to_s
+    end
+    
+    ##
+    # Check if a command _name_ exists.
+    
+    def command_exists? name
+      @commands[name.to_s]
+    end
+    
+    #:stopdoc:
+    
+    ##
+    # Get active command within arguments passed to this runner.
+    
+    def active_command
+      @__active_command ||= command(command_name_from_args)
+    end
+    
+    ##
+    # Attempts to locate a command name from within the arguments.
+    # Supports multi-word commands, using the largest possible match.
+    
+    def command_name_from_args
+      @__command_name_from_args ||= (valid_command_names_from(*@args.dup).sort.last || @default_command)
+    end
+    
+    ##
+    # Returns array of valid command names found within _args_.
+    
+    def valid_command_names_from *args
+      arg_string = args.delete_if { |value| value =~ /^-/ }.join ' '
+      commands.keys.find_all { |name| name if /^#{name}\b/.match arg_string }
+    end
+    
+    ##
+    # Help formatter instance.
+    
+    def help_formatter
+      @__help_formatter ||= program(:help_formatter).new self
+    end
+    
+    ##
+    # Return arguments without the command name.
+    
+    def args_without_command_name
+      removed = []
+      parts = command_name_from_args.split rescue []
+      @args.dup.delete_if do |arg|
+        removed << arg if parts.include?(arg) and not removed.include?(arg)
+      end
+    end
+    
+    ##
+    # Returns hash of help formatter alias defaults.
+    
+    def help_formatter_alias_defaults
+      return :compact => HelpFormatter::TerminalCompact
+    end
+    
+    ##
+    # Returns hash of program defaults.
+    
+    def program_defaults
+      return :help_formatter => HelpFormatter::Terminal, 
+             :name => File.basename($0)
+    end
+    
+    ##
+    # Creates default commands such as 'help' which is 
+    # essentially the same as using the --help switch.
+    
+    def create_default_commands
+      command :help do |c|
+        c.syntax = 'commander help [command]'
+        c.description = 'Display global or [command] help documentation.'
+        c.example 'Display global help', 'command help'
+        c.example "Display help for 'foo'", 'command help foo'
+        c.when_called do |args, options|
+          if args.empty?
+            say help_formatter.render 
+          else
+            command = command args.join(' ')
+            begin
+              require_valid_command command
+            rescue InvalidCommandError => e
+              abort "#{e}. Use --help for more information"
+            end
+            say help_formatter.render_command(command)
+          end
+        end
+      end
+    end
+    
+    ##
+    # Raises InvalidCommandError when a _command_ is not found.
+    
+    def require_valid_command command = active_command
+      raise InvalidCommandError, 'invalid command', caller if command.nil?
+    end
+    
+    ##
+    # Removes global _options_ from _args_. This prevents an invalid
+    # option error from occurring when options are parsed
+    # again for the command.
+    
+    def remove_global_options options, args
+      # TODO: refactor with flipflop, please TJ ! have time to refactor me !
+      options.each do |option|
+        switches = option[:switches].dup
+        next if switches.empty?
+
+        if switchHasArg = switches.any? { |s| s =~ /[ =]/ }
+          switches.map! { |s| s[0, s.index('=') || s.index(' ') || s.length] }
+        end
+
+        past_switch, arg_removed = false, false
+        args.delete_if do |arg|
+          if switches.any? { |s| arg[0, s.length] == s }
+            arg_removed = !switchHasArg
+            past_switch = true
+          elsif past_switch && !arg_removed && arg !~ /^-/
+            arg_removed = true
+          else
+            arg_removed = true
+            false
+          end
+        end
+      end
+    end
+            
+    ##
+    # Parse global command options.
+    
+    def parse_global_options
+
+      parser = options.inject(OptionParser.new) do |options, option|
+        options.on *option[:args], &global_option_proc(option[:switches], &option[:proc])
+      end
+
+      options = @args.dup
+      begin
+        parser.parse!(options)
+      rescue OptionParser::InvalidOption => e
+        # Remove the offending args and retry.
+        options = options.reject { |o| e.args.include?(o) }
+        retry
+      end
+    end
+    
+    ##
+    # Returns a proc allowing for commands to inherit global options.
+    # This functionality works whether a block is present for the global
+    # option or not, so simple switches such as --verbose can be used
+    # without a block, and used throughout all commands.
+    
+    def global_option_proc switches, &block
+      lambda do |value|
+        unless active_command.nil?
+          active_command.proxy_options << [Runner.switch_to_sym(switches.last), value]
+        end
+        yield value if block and !value.nil?
+      end
+    end
+    
+    ##
+    # Raises a CommandError when the program any of the _keys_ are not present, or empty.
+        
+    def require_program *keys
+      keys.each do |key|
+        raise CommandError, "program #{key} required" if program(key).nil? or program(key).empty?
+      end
+    end
+    
+    ##
+    # Return switches and description separated from the _args_ passed.
+
+    def self.separate_switches_from_description *args
+      switches = args.find_all { |arg| arg.to_s =~ /^-/ } 
+      description = args.last unless !args.last.is_a? String or args.last.match(/^-/)
+      return switches, description
+    end
+    
+    ##
+    # Attempts to generate a method name symbol from +switch+.
+    # For example:
+    # 
+    #   -h                 # => :h
+    #   --trace            # => :trace
+    #   --some-switch      # => :some_switch
+    #   --[no-]feature     # => :feature
+    #   --file FILE        # => :file
+    #   --list of,things   # => :list
+    #
+    
+    def self.switch_to_sym switch
+      switch.scan(/[\-\]](\w+)/).join('_').to_sym rescue nil
+    end
+    
+    ##
+    # Run the active command.
+    
+    def run_active_command
+      require_valid_command
+      if alias? command_name_from_args
+        active_command.run *(@aliases[command_name_from_args.to_s] + args_without_command_name)
+      else
+        active_command.run *args_without_command_name
+      end      
+    end
+     
+    def say *args #:nodoc: 
+      $terminal.say *args
+    end
+
+  end
+end

data/lib/taco/commander/version.rb

@@ -0,0 +1,3 @@
+module Commander
+  VERSION = '4.1.4'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: taco_it
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.5.2
   prerelease: 
 platform: ruby
 authors:
@@ -35,18 +35,36 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/taco.rb
 - lib/taco/change.rb
 - lib/taco/cli.rb
+- lib/taco/commander/blank.rb
+- lib/taco/commander/command.rb
+- lib/taco/commander/core_ext/array.rb
+- lib/taco/commander/core_ext/object.rb
+- lib/taco/commander/core_ext.rb
+- lib/taco/commander/delegates.rb
+- lib/taco/commander/help_formatters/base.rb
+- lib/taco/commander/help_formatters/terminal/command_help.erb
+- lib/taco/commander/help_formatters/terminal/help.erb
+- lib/taco/commander/help_formatters/terminal.rb
+- lib/taco/commander/help_formatters/terminal_compact/command_help.erb
+- lib/taco/commander/help_formatters/terminal_compact/help.erb
+- lib/taco/commander/help_formatters/terminal_compact.rb
+- lib/taco/commander/help_formatters.rb
+- lib/taco/commander/import.rb
+- lib/taco/commander/platform.rb
+- lib/taco/commander/runner.rb
+- lib/taco/commander/version.rb
 - lib/taco/commander.rb
+- lib/taco/defaults/index.html.erb
+- lib/taco/defaults/taco_profile
+- lib/taco/defaults/tacorc
 - lib/taco/issue.rb
 - lib/taco/schema.rb
 - lib/taco/taco.rb
 - lib/taco/taco_profile.rb
 - lib/taco/tacorc.rb
-- lib/taco/defaults/index.html.erb
-- lib/taco/defaults/taco_profile
-- lib/taco/defaults/tacorc
+- lib/taco.rb
 - bin/taco
 homepage: http://github.com/mikepartelow/taco
 licenses: []