Class: CLASP::OptionSpecification

Inherits:
Object
  • Object
show all
Defined in:
lib/clasp/specifications.rb

Overview

A class that represents the specification for a command-line option

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, aliases, help, values_range, default_value, required, required_message, extras = nil) ⇒ OptionSpecification

Creates an OptionSpecification instance from the given name, aliases, help, values_range, and default_value

Signature

  • Parameters

    • name (String) The name, or long-form, of the option

    • aliases (Array) 0 or more strings specifying short-form or option-value aliases

    • help (String) The help string, which may be nil

    • values_range (Array) 0 or more strings specifying values supported by the option

    • default_value (String) The default value of the option, which will be used in the case where an option is specified without a value. May be nil

    • required (boolean) Whether the option is required. May be nil

    • required_message (::String) Message to be used when reporting that a required option is missing. May be nil in which case a message of the form “<option-name> not specified; use –help for usage”. If begins with the nul character (“0”), then is used in the place of the <option-name> and placed into the rest of the standard form message

    • extras An application-defined additional parameter. If nil, it is assigned an empty Hash



173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
 
# File 'lib/clasp/specifications.rb', line 173

def initialize(name, aliases, help, values_range, default_value, required, required_message, extras = nil)

	@name				=	name
	@aliases			=	(aliases || []).select { |a| a and not a.empty? }
	@help				=	help
	@values_range		=	values_range || []
	@default_value		=	default_value
	@required			=	required
	@required_message	=	nil
	@extras				=	extras || {}

	rm_name				=	nil

	if required_message

		if "\0" == required_message[0]

			rm_name		=	required_message[1..-1]
		end
	else

		rm_name			=	"'#{name}'"
	end

	if rm_name

		required_message	=	"#{rm_name} not specified; use --help for usage"
	end

	@required_message	=	required_message
end

Instance Attribute Details

#aliases ⇒ Object (readonly)

The option’s aliases array



208
209
210
 
# File 'lib/clasp/specifications.rb', line 208

def aliases
  @aliases
end

#default_value ⇒ Object (readonly)

The default value of the option



214
215
216
 
# File 'lib/clasp/specifications.rb', line 214

def default_value
  @default_value
end

#extras ⇒ Object (readonly)

The option’s extras



221
222
223
 
# File 'lib/clasp/specifications.rb', line 221

def extras
  @extras
end

#help ⇒ Object (readonly)

The option’s help string



210
211
212
 
# File 'lib/clasp/specifications.rb', line 210

def help
  @help
end

#name ⇒ Object (readonly)

The option’s name string



206
207
208
 
# File 'lib/clasp/specifications.rb', line 206

def name
  @name
end

#required_message ⇒ Object (readonly)

The message to be used when reporting that a required option is missing



219
220
221
 
# File 'lib/clasp/specifications.rb', line 219

def required_message
  @required_message
end

#values_range ⇒ Object (readonly)

The range of values supported by the option



212
213
214
 
# File 'lib/clasp/specifications.rb', line 212

def values_range
  @values_range
end

Instance Method Details

#==(rhs) ⇒ Object

Compares instance against another OptionSpecification or against a name (String)



254
255
256
257
258
259
260
261
262
263
264
265
266
267
 
# File 'lib/clasp/specifications.rb', line 254

def == rhs

	case rhs
	when self.class

		return self.eql? rhs
	when String

		return name == rhs
	else

		false
	end
end

#required? ⇒ Boolean

Indicates whether the option is required

Returns:

  • (Boolean) 


216
 
# File 'lib/clasp/specifications.rb', line 216

def required?; @required; end

#to_s ⇒ Object

String form of the option



224
225
226
227
 
# File 'lib/clasp/specifications.rb', line 224

def to_s

	"{#{name}; aliases=#{aliases.join(', ')}; values_range=[ #{values_range.join(', ')} ]; default_value='#{default_value}'; help='#{help}'; required?=#{required?}; extras=#{extras}}"
end