Class: Samovar::Nested

Inherits:
Object
  • Object
show all
Defined in:
lib/samovar/nested.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(key, commands, default: nil, required: false) ⇒ Nested

Returns a new instance of Nested.



23
24
25
26
27
28
29
30
31
 
# File 'lib/samovar/nested.rb', line 23

def initialize(key, commands, default: nil, required: false)
	@key = key
	@commands = commands
	
	# This is the default name [of a command], not the default command:
	@default = default
	
	@required = required
end

Instance Attribute Details

#commands ⇒ Object (readonly)

Returns the value of attribute commands.



34
35
36
 
# File 'lib/samovar/nested.rb', line 34

def commands
  @commands
end

#default ⇒ Object (readonly)

Returns the value of attribute default.



35
36
37
 
# File 'lib/samovar/nested.rb', line 35

def default
  @default
end

#key ⇒ Object (readonly)

Returns the value of attribute key.



33
34
35
 
# File 'lib/samovar/nested.rb', line 33

def key
  @key
end

#required ⇒ Object (readonly)

Returns the value of attribute required.



36
37
38
 
# File 'lib/samovar/nested.rb', line 36

def required
  @required
end

Instance Method Details

#parse(input, parent = nil, default = nil) ⇒ Object

Parameters:

  • default (Command) (defaults to: nil) —

    the default command if any.



63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/samovar/nested.rb', line 63

def parse(input, parent = nil, default = nil)
	if command = @commands[input.first]
		name = input.shift
		
		# puts "Instantiating #{command} with #{input}"
		command.new(input, name: name, parent: parent)
	elsif default
		return default
	elsif @default
		@commands[@default].new(input, name: @default, parent: parent)
	elsif @required
		raise MissingValueError.new(parent, self)
	end
end

#to_a ⇒ Object 



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/samovar/nested.rb', line 42

def to_a
	usage = [self.to_s]
	
	if @commands.size == 0
		usage << "No commands available."
	elsif @commands.size == 1
		usage << "Only #{@commands.first}."
	else
		usage << "One of: #{@commands.keys.join(', ')}."
	end
	
	if @default
		usage << "(default: #{@default})"
	elsif @required
		usage << "(required)"
	end
	
	return usage
end

#to_s ⇒ Object 



38
39
40
 
# File 'lib/samovar/nested.rb', line 38

def to_s
	"<#{@key}>"
end

#usage(rows) ⇒ Object 



78
79
80
81
82
83
84
 
# File 'lib/samovar/nested.rb', line 78

def usage(rows)
	rows << self
	
	@commands.each do |key, klass|
		klass.usage(rows, key)
	end
end