thor 0.17.0 → 0.18.0

data/{CHANGELOG.rdoc → CHANGELOG.md}

@@ -1,4 +1,13 @@
-== 0.17.0, release 2013-01-24
+## 0.18.0, release 2013-03-26
+* Remove rake2thor
+* Only display colors if output medium supports colors
+* Pass parent_options to subcommands
+* Fix non-dash-prefixed aliases
+* Make error messages more helpful
+* Rename "task" to "command"
+* Add the method to allow for custom package name
+
+## 0.17.0, release 2013-01-24
 * Add better support for tasks that accept arbitrary additional arguments (e.g. things like `bundle exec`)
 * Add #stop_on_unknown_option!
 * Only strip from stdin.gets if it wasn't ended with EOF
@@ -6,26 +15,26 @@
 * Allow passing options as arguments after "--"
 * Autoload Thor::Group
 
-== 0.16.0, release 2012-08-14
+## 0.16.0, release 2012-08-14
 * Add enum to string arguments
 
-== 0.15.4, release 2012-06-29
+## 0.15.4, release 2012-06-29
 * Fix regression when destination root contains reserved regexp characters
 
-== 0.15.3, release 2012-06-18
+## 0.15.3, release 2012-06-18
 * Support strict_args_position! for backwards compatibility
 * Escape Dir glob characters in paths
 
-== 0.15.2, released 2012-05-07
+## 0.15.2, released 2012-05-07
 * Added print_in_columns
 * Exposed terminal_width as a public API
 
-== 0.15.1, release 2012-05-06
+## 0.15.1, release 2012-05-06
 * Fix Ruby 1.8 truncation bug with unicode chars
 * Fix shell delegate methods to pass their block
 * Don't output trailing spaces when printing the last column in a table
 
-== 0.15, released 2012-04-29
+## 0.15, released 2012-04-29
 * Alias method_options to options
 * Refactor say to allow multiple colors
 * Exposed error as a public API
@@ -37,8 +46,7 @@
 * Fix Errno::EPIPE when piping tasks to `head`
 * More friendly error messages
 
-== 0.14, released 2010-07-25
-
+## 0.14, released 2010-07-25
 * Added CreateLink class and #link_file method
 * Made Thor::Actions#run use system as default method for system calls
 * Allow use of private methods from superclass as tasks
@@ -49,8 +57,7 @@
 * Deprecated invoke() without arguments
 * Added :only and :except to check_unknown_options
 
-== 0.13, released 2010-02-03
-
+## 0.13, released 2010-02-03
 * Added :lazy_default which is only triggered if a switch is given
 * Added Thor::Shell::HTML
 * Added subcommands
@@ -58,8 +65,7 @@
 * Added check_unknown_options! in case you want error messages to be raised in valid switches
 * run(command) should return the results of command
 
-== 0.12, released 2010-01-02
-
+## 0.12, released 2010-01-02
 * Methods generated by attr_* are automatically not marked as tasks
 * inject_into_file does not add the same content twice, unless :force is set
 * Removed rr in favor to rspec mock framework
@@ -67,40 +73,31 @@
 * [#7] Do not force white color on status
 * [#8] Yield a block with the filename on directory
 
-== 0.11, released 2009-07-01
-
+## 0.11, released 2009-07-01
 * Added a rake compatibility layer. It allows you to use spec and rdoc tasks on
   Thor classes.
-
 * BACKWARDS INCOMPATIBLE: aliases are not generated automatically anymore
   since it may cause wrong behavior in the invocation system.
-
 * thor help now show information about any class/task. All those calls are
   possible:
 
-    thor help describe
-    thor help describe:amazing
-
+      thor help describe
+      thor help describe:amazing
   Or even with default namespaces:
 
-    thor help :spec
-
+      thor help :spec
 * Thor::Runner now invokes the default task if none is supplied:
 
-    thor describe # invokes the default task, usually help
-
+      thor describe # invokes the default task, usually help
 * Thor::Runner now works with mappings:
 
-    thor describe -h
-
+      thor describe -h
 * Added some documentation and code refactoring.
 
-== 0.9.8, released 2008-10-20
-
+## 0.9.8, released 2008-10-20
 * Fixed some tiny issues that were introduced lately.
 
-== 0.9.7, released 2008-10-13
-
+## 0.9.7, released 2008-10-13
 * Setting global method options on the initialize method works as expected:
   All other tasks will accept these global options in addition to their own.
 * Added 'group' notion to Thor task sets (class Thor); by default all tasks
@@ -108,12 +105,10 @@
   tasks - adding --all will show all tasks. You can also filter on a specific
   group using the --group option: thor -T --group advanced
 
-== 0.9.6, released 2008-09-13
-
+## 0.9.6, released 2008-09-13
 * Generic improvements
 
-== 0.9.5, released 2008-08-27
-
+## 0.9.5, released 2008-08-27
 * Improve Windows compatibility
 * Update (incorrect) README and task.thor sample file
 * Options hash is now frozen (once returned)
@@ -124,8 +119,7 @@
 * Don't write options for nil or false values. This allows, for example, turning color off when running specs.
 * Exit with the status of the spec command to help CI stuff out some.
 
-== 0.9.4, released 2008-08-13
-
+## 0.9.4, released 2008-08-13
 * Try to add Windows compatibility.
 * BACKWARDS INCOMPATIBLE: options hash is now accessed as a property in your class and is not passed as last argument anymore
 * Allow options at the beginning of the argument list as well as the end.

data/README.md

@@ -1,4 +1,8 @@
+[![Gem Version](https://badge.fury.io/rb/thor.png)](https://rubygems.org/gems/thor)
 [![Build Status](https://secure.travis-ci.org/wycats/thor.png?branch=master)](http://travis-ci.org/wycats/thor)
+[![Dependency Status](https://gemnasium.com/wycats/thor.png?travis)](https://gemnasium.com/wycats/thor)
+[![Code Climate](https://codeclimate.com/github/wycats/thor.png)](https://codeclimate.com/github/wycats/thor)
+[![Coverage Status](https://coveralls.io/repos/wycats/thor/badge.png?branch=master)](https://coveralls.io/r/wycats/thor)
 
 Thor
 ====
@@ -19,10 +23,13 @@ Installation
 
 Usage and documentation
 -----------------------
-Please see [the wiki](https://github.com/wycats/thor/wiki) for basic usage and other documentation on using Thor.
+Please see the [wiki][] for basic usage and other documentation on using Thor. You can also checkout the [official homepage][homepage].
+
+[wiki]: https://github.com/wycats/thor/wiki
+[homepage]: http://whatisthor.com/
 
 License
 -------
-Released under the MIT License.  See the [LICENSE][license] file for further details.
+Released under the MIT License.  See the [LICENSE][] file for further details.
 
-[license]: https://github.com/wycats/thor/blob/master/LICENSE.md
+[license]: LICENSE.md

data/lib/thor.rb

@@ -3,21 +3,32 @@ require 'thor/base'
 
 class Thor
   class << self
-    # Sets the default task when thor is executed without an explicit task to be called.
+    # Allows for custom "Command" package naming.
+    #
+    # === Parameters
+    # name<String>
+    # options<Hash>
+    #
+    def package_name(name, options={})
+      @package_name = name.nil? || name == '' ? nil : name
+    end
+
+    # Sets the default command when thor is executed without an explicit command to be called.
     #
     # ==== Parameters
-    # meth<Symbol>:: name of the default task
+    # meth<Symbol>:: name of the default command
     #
-    def default_task(meth=nil)
-      @default_task = case meth
+    def default_command(meth=nil)
+      @default_command = case meth
       when :none
         'help'
       when nil
-        @default_task || from_superclass(:default_task, 'help')
+        @default_command || from_superclass(:default_command, 'help')
       else
         meth.to_s
       end
     end
+    alias default_task default_command
 
     # Registers another Thor subclass as a command.
     #
@@ -36,7 +47,7 @@ class Thor
       end
     end
 
-    # Defines the usage and the description of the next task.
+    # Defines the usage and the description of the next command.
     #
     # ==== Parameters
     # usage<String>
@@ -45,29 +56,29 @@ class Thor
     #
     def desc(usage, description, options={})
       if options[:for]
-        task = find_and_refresh_task(options[:for])
-        task.usage = usage             if usage
-        task.description = description if description
+        command = find_and_refresh_command(options[:for])
+        command.usage = usage             if usage
+        command.description = description if description
       else
         @usage, @desc, @hide = usage, description, options[:hide] || false
       end
     end
 
-    # Defines the long description of the next task.
+    # Defines the long description of the next command.
     #
     # ==== Parameters
     # long description<String>
     #
     def long_desc(long_description, options={})
       if options[:for]
-        task = find_and_refresh_task(options[:for])
-        task.long_description = long_description if long_description
+        command = find_and_refresh_command(options[:for])
+        command.long_description = long_description if long_description
       else
         @long_desc = long_description
       end
     end
 
-    # Maps an input to a task. If you define:
+    # Maps an input to a command. If you define:
     #
     #   map "-T" => "list"
     #
@@ -75,10 +86,10 @@ class Thor
     #
     #   thor -T
     #
-    # Will invoke the list task.
+    # Will invoke the list command.
     #
     # ==== Parameters
-    # Hash[String|Array => Symbol]:: Maps the string or the strings in the array to the given task.
+    # Hash[String|Array => Symbol]:: Maps the string or the strings in the array to the given command.
     #
     def map(mappings=nil)
       @map ||= from_superclass(:map, {})
@@ -96,7 +107,7 @@ class Thor
       @map
     end
 
-    # Declares the options for the next task to be declared.
+    # Declares the options for the next command to be declared.
     #
     # ==== Parameters
     # Hash[Symbol => Object]:: The hash key is the name of the option and the value
@@ -112,15 +123,15 @@ class Thor
     alias options method_options
 
     # Adds an option to the set of method options. If :for is given as option,
-    # it allows you to change the options from a previous defined task.
+    # it allows you to change the options from a previous defined command.
     #
-    #   def previous_task
+    #   def previous_command
     #     # magic
     #   end
     #
-    #   method_option :foo => :bar, :for => :previous_task
+    #   method_option :foo => :bar, :for => :previous_command
     #
-    #   def next_task
+    #   def next_command
     #     # magic
     #   end
     #
@@ -139,38 +150,38 @@ class Thor
     #
     def method_option(name, options={})
       scope = if options[:for]
-        find_and_refresh_task(options[:for]).options
+        find_and_refresh_command(options[:for]).options
       else
         method_options
       end
 
       build_option(name, options, scope)
     end
-
     alias option method_option
 
-    # Prints help information for the given task.
+    # Prints help information for the given command.
     #
     # ==== Parameters
     # shell<Thor::Shell>
-    # task_name<String>
+    # command_name<String>
     #
-    def task_help(shell, task_name)
-      meth = normalize_task_name(task_name)
-      task = all_tasks[meth]
-      handle_no_task_error(meth) unless task
+    def command_help(shell, command_name)
+      meth = normalize_command_name(command_name)
+      command = all_commands[meth]
+      handle_no_command_error(meth) unless command
 
       shell.say "Usage:"
-      shell.say "  #{banner(task)}"
+      shell.say "  #{banner(command)}"
       shell.say
-      class_options_help(shell, nil => task.options.map { |_, o| o })
-      if task.long_description
+      class_options_help(shell, nil => command.options.map { |_, o| o })
+      if command.long_description
         shell.say "Description:"
-        shell.print_wrapped(task.long_description, :indent => 2)
+        shell.print_wrapped(command.long_description, :indent => 2)
       else
-        shell.say task.description
+        shell.say command.description
       end
     end
+    alias task_help command_help
 
     # Prints help information for this class.
     #
@@ -178,32 +189,39 @@ class Thor
     # shell<Thor::Shell>
     #
     def help(shell, subcommand = false)
-      list = printable_tasks(true, subcommand)
+      list = printable_commands(true, subcommand)
       Thor::Util.thor_classes_in(self).each do |klass|
-        list += klass.printable_tasks(false)
+        list += klass.printable_commands(false)
       end
       list.sort!{ |a,b| a[0] <=> b[0] }
 
-      shell.say "Tasks:"
+      if @package_name
+        shell.say "#{@package_name} commands:"
+      else
+        shell.say "Commands:"
+      end
+
       shell.print_table(list, :indent => 2, :truncate => true)
       shell.say
       class_options_help(shell)
     end
 
-    # Returns tasks ready to be printed.
-    def printable_tasks(all = true, subcommand = false)
-      (all ? all_tasks : tasks).map do |_, task|
-        next if task.hidden?
+    # Returns commands ready to be printed.
+    def printable_commands(all = true, subcommand = false)
+      (all ? all_commands : commands).map do |_, command|
+        next if command.hidden?
         item = []
-        item << banner(task, false, subcommand)
-        item << (task.description ? "# #{task.description.gsub(/\s+/m,' ')}" : "")
+        item << banner(command, false, subcommand)
+        item << (command.description ? "# #{command.description.gsub(/\s+/m,' ')}" : "")
         item
       end.compact
     end
+    alias printable_tasks printable_commands
 
     def subcommands
       @subcommands ||= from_superclass(:subcommands, [])
     end
+    alias subtasks subcommands
 
     def subcommand(subcommand, subcommand_class)
       self.subcommands << subcommand.to_s
@@ -211,9 +229,10 @@ class Thor
 
       define_method(subcommand) do |*args|
         args, opts = Thor::Arguments.split(args)
-        invoke subcommand_class, args, opts, :invoked_via_subcommand => true
+        invoke subcommand_class, args, opts, :invoked_via_subcommand => true, :class_options => options
       end
     end
+    alias subtask subcommand
 
     # Extend check unknown options to accept a hash of conditions.
     #
@@ -236,10 +255,10 @@ class Thor
       options = check_unknown_options
       return false unless options
 
-      task = config[:current_task]
-      return true unless task
+      command = config[:current_command]
+      return true unless command
 
-      name = task.name
+      name = command.name
 
       if subcommands.include?(name)
         false
@@ -253,16 +272,16 @@ class Thor
     end
 
     # Stop parsing of options as soon as an unknown option or a regular
-    # argument is encountered.  All remaining arguments are passed to the task.
-    # This is useful if you have a task that can receive arbitrary additional
+    # argument is encountered.  All remaining arguments are passed to the command.
+    # This is useful if you have a command that can receive arbitrary additional
     # options, and where those additional options should not be handled by
     # Thor.
     #
     # ==== Example
     #
-    # To better understand how this is useful, let's consider a task that calls
+    # To better understand how this is useful, let's consider a command that calls
     # an external command.  A user may want to pass arbitrary options and
-    # arguments to that command.  The task itself also accepts some options,
+    # arguments to that command.  The command itself also accepts some options,
     # which should be handled by Thor.
     #
     #   class_option "verbose",  :type => :boolean
@@ -288,161 +307,167 @@ class Thor
     #   --verbose foo
     #
     # ==== Parameters
-    # Symbol ...:: A list of tasks that should be affected.
-    def stop_on_unknown_option!(*task_names)
+    # Symbol ...:: A list of commands that should be affected.
+    def stop_on_unknown_option!(*command_names)
       @stop_on_unknown_option ||= Set.new
-      @stop_on_unknown_option.merge(task_names)
+      @stop_on_unknown_option.merge(command_names)
     end
 
-    def stop_on_unknown_option?(task) #:nodoc:
-      !!@stop_on_unknown_option && @stop_on_unknown_option.include?(task.name.to_sym)
+    def stop_on_unknown_option?(command) #:nodoc:
+      !!@stop_on_unknown_option && @stop_on_unknown_option.include?(command.name.to_sym)
     end
 
-    protected
-
-      # The method responsible for dispatching given the args.
-      def dispatch(meth, given_args, given_opts, config) #:nodoc:
-        # There is an edge case when dispatching from a subcommand.
-        # A problem occurs invoking the default task. This case occurs
-        # when arguments are passed and a default task is defined, and
-        # the first given_args does not match the default task.
-        # Thor use "help" by default so we skip that case.
-        # Note the call to retrieve_task_name. It's called with
-        # given_args.dup since that method calls args.shift. Then lookup
-        # the task normally. If the first item in given_args is not
-        # a task then use the default task. The given_args will be
-        # intact later since dup was used.
-        if config[:invoked_via_subcommand] && given_args.size >= 1 && default_task != "help" && given_args.first != default_task
-          meth ||= retrieve_task_name(given_args.dup)
-          task = all_tasks[normalize_task_name(meth)]
-          task ||= all_tasks[normalize_task_name(default_task)]
-        else
-          meth ||= retrieve_task_name(given_args)
-          task = all_tasks[normalize_task_name(meth)]
-        end
+  protected
+
+    # The method responsible for dispatching given the args.
+    def dispatch(meth, given_args, given_opts, config) #:nodoc:
+      # There is an edge case when dispatching from a subcommand.
+      # A problem occurs invoking the default command. This case occurs
+      # when arguments are passed and a default command is defined, and
+      # the first given_args does not match the default command.
+      # Thor use "help" by default so we skip that case.
+      # Note the call to retrieve_command_name. It's called with
+      # given_args.dup since that method calls args.shift. Then lookup
+      # the command normally. If the first item in given_args is not
+      # a command then use the default command. The given_args will be
+      # intact later since dup was used.
+      if config[:invoked_via_subcommand] && given_args.size >= 1 && default_command != "help" && given_args.first != default_command
+        meth ||= retrieve_command_name(given_args.dup)
+        command = all_commands[normalize_command_name(meth)]
+        command ||= all_commands[normalize_command_name(default_command)]
+      else
+        meth ||= retrieve_command_name(given_args)
+        command = all_commands[normalize_command_name(meth)]
+      end
 
-        if task
-          args, opts = Thor::Options.split(given_args)
-          if stop_on_unknown_option?(task) && !args.empty?
-            # given_args starts with a non-option, so we treat everything as
-            # ordinary arguments
-            args.concat opts
-            opts.clear
-          end
-        else
-          args, opts = given_args, nil
-          task = Thor::DynamicTask.new(meth)
+      if command
+        args, opts = Thor::Options.split(given_args)
+        if stop_on_unknown_option?(command) && !args.empty?
+          # given_args starts with a non-option, so we treat everything as
+          # ordinary arguments
+          args.concat opts
+          opts.clear
         end
-
-        opts = given_opts || opts || []
-        config.merge!(:current_task => task, :task_options => task.options)
-
-        instance = new(args, opts, config)
-        yield instance if block_given?
-        args = instance.args
-        trailing = args[Range.new(arguments.size, -1)]
-        instance.invoke_task(task, trailing || [])
+      else
+        args, opts = given_args, nil
+        command = Thor::DynamicCommand.new(meth)
       end
 
-      # The banner for this class. You can customize it if you are invoking the
-      # thor class by another ways which is not the Thor::Runner. It receives
-      # the task that is going to be invoked and a boolean which indicates if
-      # the namespace should be displayed as arguments.
-      #
-      def banner(task, namespace = nil, subcommand = false)
-        "#{basename} #{task.formatted_usage(self, $thor_runner, subcommand)}"
-      end
+      opts = given_opts || opts || []
+      config.merge!(:current_command => command, :command_options => command.options)
 
-      def baseclass #:nodoc:
-        Thor
-      end
+      instance = new(args, opts, config)
+      yield instance if block_given?
+      args = instance.args
+      trailing = args[Range.new(arguments.size, -1)]
+      instance.invoke_command(command, trailing || [])
+    end
 
-      def create_task(meth) #:nodoc:
-        if @usage && @desc
-          base_class = @hide ? Thor::HiddenTask : Thor::Task
-          tasks[meth] = base_class.new(meth, @desc, @long_desc, @usage, method_options)
-          @usage, @desc, @long_desc, @method_options, @hide = nil
-          true
-        elsif self.all_tasks[meth] || meth == "method_missing"
-          true
-        else
-          puts "[WARNING] Attempted to create task #{meth.inspect} without usage or description. " <<
-               "Call desc if you want this method to be available as task or declare it inside a " <<
-               "no_tasks{} block. Invoked from #{caller[1].inspect}."
-          false
-        end
-      end
+    # The banner for this class. You can customize it if you are invoking the
+    # thor class by another ways which is not the Thor::Runner. It receives
+    # the command that is going to be invoked and a boolean which indicates if
+    # the namespace should be displayed as arguments.
+    #
+    def banner(command, namespace = nil, subcommand = false)
+      "#{basename} #{command.formatted_usage(self, $thor_runner, subcommand)}"
+    end
 
-      def initialize_added #:nodoc:
-        class_options.merge!(method_options)
-        @method_options = nil
-      end
+    def baseclass #:nodoc:
+      Thor
+    end
 
-      # Retrieve the task name from given args.
-      def retrieve_task_name(args) #:nodoc:
-        meth = args.first.to_s unless args.empty?
-        if meth && (map[meth] || meth !~ /^\-/)
-          args.shift
-        else
-          nil
-        end
+    def create_command(meth) #:nodoc:
+      if @usage && @desc
+        base_class = @hide ? Thor::HiddenCommand : Thor::Command
+        commands[meth] = base_class.new(meth, @desc, @long_desc, @usage, method_options)
+        @usage, @desc, @long_desc, @method_options, @hide = nil
+        true
+      elsif self.all_commands[meth] || meth == "method_missing"
+        true
+      else
+        puts "[WARNING] Attempted to create command #{meth.inspect} without usage or description. " <<
+             "Call desc if you want this method to be available as command or declare it inside a " <<
+             "no_commands{} block. Invoked from #{caller[1].inspect}."
+        false
       end
+    end
+    alias create_task create_command
 
-      # receives a (possibly nil) task name and returns a name that is in
-      # the tasks hash. In addition to normalizing aliases, this logic
-      # will determine if a shortened command is an unambiguous substring of
-      # a task or alias.
-      #
-      # +normalize_task_name+ also converts names like +animal-prison+
-      # into +animal_prison+.
-      def normalize_task_name(meth) #:nodoc:
-        return default_task.to_s.gsub('-', '_') unless meth
-
-        possibilities = find_task_possibilities(meth)
-        if possibilities.size > 1
-          raise ArgumentError, "Ambiguous task #{meth} matches [#{possibilities.join(', ')}]"
-        elsif possibilities.size < 1
-          meth = meth || default_task
-        elsif map[meth]
-          meth = map[meth]
-        else
-          meth = possibilities.first
-        end
+    def initialize_added #:nodoc:
+      class_options.merge!(method_options)
+      @method_options = nil
+    end
 
-        meth.to_s.gsub('-','_') # treat foo-bar as foo_bar
+    # Retrieve the command name from given args.
+    def retrieve_command_name(args) #:nodoc:
+      meth = args.first.to_s unless args.empty?
+      if meth && (map[meth] || meth !~ /^\-/)
+        args.shift
+      else
+        nil
       end
-
-      # this is the logic that takes the task name passed in by the user
-      # and determines whether it is an unambiguous substrings of a task or
-      # alias name.
-      def find_task_possibilities(meth)
-        len = meth.to_s.length
-        possibilities = all_tasks.merge(map).keys.select { |n| meth == n[0, len] }.sort
-        unique_possibilities = possibilities.map { |k| map[k] || k }.uniq
-
-        if possibilities.include?(meth)
-          [meth]
-        elsif unique_possibilities.size == 1
-          unique_possibilities
-        else
-          possibilities
-        end
+    end
+    alias retrieve_task_name retrieve_command_name
+
+    # receives a (possibly nil) command name and returns a name that is in
+    # the commands hash. In addition to normalizing aliases, this logic
+    # will determine if a shortened command is an unambiguous substring of
+    # a command or alias.
+    #
+    # +normalize_command_name+ also converts names like +animal-prison+
+    # into +animal_prison+.
+    def normalize_command_name(meth) #:nodoc:
+      return default_command.to_s.gsub('-', '_') unless meth
+
+      possibilities = find_command_possibilities(meth)
+      if possibilities.size > 1
+        raise ArgumentError, "Ambiguous command #{meth} matches [#{possibilities.join(', ')}]"
+      elsif possibilities.size < 1
+        meth = meth || default_command
+      elsif map[meth]
+        meth = map[meth]
+      else
+        meth = possibilities.first
       end
 
-      def subcommand_help(cmd)
-        desc "help [COMMAND]", "Describe subcommands or one specific subcommand"
-        class_eval <<-RUBY
-          def help(task = nil, subcommand = true); super; end
-        RUBY
+      meth.to_s.gsub('-','_') # treat foo-bar as foo_bar
+    end
+    alias normalize_task_name normalize_command_name
+
+    # this is the logic that takes the command name passed in by the user
+    # and determines whether it is an unambiguous substrings of a command or
+    # alias name.
+    def find_command_possibilities(meth)
+      len = meth.to_s.length
+      possibilities = all_commands.merge(map).keys.select { |n| meth == n[0, len] }.sort
+      unique_possibilities = possibilities.map { |k| map[k] || k }.uniq
+
+      if possibilities.include?(meth)
+        [meth]
+      elsif unique_possibilities.size == 1
+        unique_possibilities
+      else
+        possibilities
       end
+    end
+    alias find_task_possibilities find_command_possibilities
+
+    def subcommand_help(cmd)
+      desc "help [COMMAND]", "Describe subcommands or one specific subcommand"
+      class_eval <<-RUBY
+        def help(command = nil, subcommand = true); super; end
+      RUBY
+    end
+    alias subtask_help subcommand_help
+
   end
 
   include Thor::Base
 
   map HELP_MAPPINGS => :help
 
-  desc "help [TASK]", "Describe available tasks or one specific task"
-  def help(task = nil, subcommand = false)
-    task ? self.class.task_help(shell, task) : self.class.help(shell, subcommand)
+  desc "help [COMMAND]", "Describe available commands or one specific command"
+  def help(command = nil, subcommand = false)
+    command ? self.class.command_help(shell, command) : self.class.help(shell, subcommand)
   end
 end