class Thor::Task
def formatted_usage(klass, namespace=nil)
Returns the formatted usage by injecting given required arguments
def formatted_usage(klass, namespace=nil) namespace = klass.namespace if namespace.nil? # Add namespace formatted = if namespace "#{namespace.gsub(/^(default|thor:runner:)/,'')}:" else "" end # Add usage with required arguments formatted << if klass && !klass.arguments.empty? usage.to_s.gsub(/^#{name}/) do |match| match << " " << required_arguments(klass) end else usage.to_s end # Add required options formatted << " #{required_options}" # Strip and go! formatted.strip end
def initialize(name, description, usage, options=nil)
def initialize(name, description, usage, options=nil) super(name.to_s, description, usage, options || {}) end
def initialize_copy(other) #:nodoc:
def initialize_copy(other) #:nodoc: super(other) self.options = other.options.dup if other.options end
def parse_argument_error(instance, e, caller) #:nodoc:
def parse_argument_error(instance, e, caller) #:nodoc: method_name = /`#{Regexp.escape(name.split(':').last)}'/ if e.message =~ /wrong number of arguments/ && e.backtrace.first.to_s =~ method_name if instance.is_a?(Thor::Group) raise e, "'#{name}' was called incorrectly. Are you sure it has arity equals to 0?" else raise InvocationError, "'#{name}' was called incorrectly. Call as " << "'#{formatted_usage(instance.class)}'" end else raise e end end
def parse_no_method_error(instance, e) #:nodoc:
def parse_no_method_error(instance, e) #:nodoc: if e.message =~ /^undefined method `#{name}' for #{Regexp.escape(instance.to_s)}$/ raise UndefinedTaskError, "The #{instance.class.namespace} namespace " << "doesn't have a '#{name}' task" else raise e end end
def public_method?(instance) #:nodoc:
Given a target, checks if this class name is not a private/protected method.
def public_method?(instance) #:nodoc: collection = instance.private_methods + instance.protected_methods (collection & [name.to_s, name.to_sym]).empty? end
def required_arguments(klass)
def required_arguments(klass) klass.arguments.map{ |a| a.usage if a.required? }.compact.join(' ') end
def required_options
def required_options @required_options ||= options.map{ |_, o| o.usage if o.required? }.compact.sort.join(" ") end
def run(instance, args=[])
implementation to create custom tasks.
By default, a task invokes a method in the thor class. You can change this
def run(instance, args=[]) raise UndefinedTaskError, "the '#{name}' task of #{instance.class} is private" unless public_method?(instance) instance.send(name, *args) rescue ArgumentError => e raise e if instance.class.respond_to?(:debugging) && instance.class.debugging parse_argument_error(instance, e, caller) rescue NoMethodError => e raise e if instance.class.respond_to?(:debugging) && instance.class.debugging parse_no_method_error(instance, e) end