Class: Thor::Argument

Inherits:
Object
  • Object
show all
Defined in:
lib/thor/parser/argument.rb

Overview

:nodoc:

Direct Known Subclasses

Option

Constant Summary collapse

VALID_TYPES = 
[:numeric, :hash, :array, :string]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, options = {}) ⇒ Argument

Returns a new instance of Argument.

Raises:

  • (ArgumentError) 


8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/thor/parser/argument.rb', line 8

def initialize(name, options = {})
  class_name = self.class.name.split("::").last

  type = options[:type]

  raise ArgumentError, "#{class_name} name can't be nil."                         if name.nil?
  raise ArgumentError, "Type :#{type} is not valid for #{class_name.downcase}s."  if type && !valid_type?(type)

  @name        = name.to_s
  @description = options[:desc]
  @required    = options.key?(:required) ? options[:required] : true
  @type        = (type || :string).to_sym
  @default     = options[:default]
  @banner      = options[:banner] || default_banner
  @enum        = options[:enum]

  validate! # Trigger specific validations
end

Instance Attribute Details

Returns the value of attribute banner.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def banner
  @banner
end

#default ⇒ Object (readonly)

Returns the value of attribute default.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def default
  @default
end

#description ⇒ Object (readonly)

Returns the value of attribute description.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def description
  @description
end

#enum ⇒ Object (readonly)

Returns the value of attribute enum.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def enum
  @enum
end

#name ⇒ Object (readonly) Also known as: human_name

Returns the value of attribute name.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def name
  @name
end

#required ⇒ Object (readonly)

Returns the value of attribute required.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def required
  @required
end

#type ⇒ Object (readonly)

Returns the value of attribute type.



5
6
7
 
# File 'lib/thor/parser/argument.rb', line 5

def type
  @type
end

Instance Method Details

#enum_to_s ⇒ Object 



52
53
54
55
56
57
58
 
# File 'lib/thor/parser/argument.rb', line 52

def enum_to_s
  if enum.respond_to? :join
    enum.join(", ")
  else
    "#{enum.first}..#{enum.last}"
  end
end

#print_default ⇒ Object 



27
28
29
30
31
32
33
 
# File 'lib/thor/parser/argument.rb', line 27

def print_default
  if @type == :array and @default.is_a?(Array)
    @default.map(&:dump).join(" ")
  else
    @default
  end
end

#required? ⇒ Boolean

Returns:

  • (Boolean) 


39
40
41
 
# File 'lib/thor/parser/argument.rb', line 39

def required?
  required
end

#show_default? ⇒ Boolean

Returns:

  • (Boolean) 


43
44
45
46
47
48
49
50
 
# File 'lib/thor/parser/argument.rb', line 43

def show_default?
  case default
  when Array, String, Hash
    !default.empty?
  else
    default
  end
end

#usage ⇒ Object 



35
36
37
 
# File 'lib/thor/parser/argument.rb', line 35

def usage
  required? ? banner : "[#{banner}]"
end