Class: ArgParser::Argument Abstract

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

Overview

This class is abstract.

Abstract base class of all command-line argument types.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Attribute Details

#default ⇒ String 



38
39
40
 
# File 'lib/arg-parser/argument.rb', line 38

def default
  @default
end

#description ⇒ String 



26
27
28
 
# File 'lib/arg-parser/argument.rb', line 26

def description
  @description
end

#key ⇒ Symbol (readonly) 



23
24
25
 
# File 'lib/arg-parser/argument.rb', line 23

def key
  @key
end

#on_parse ⇒ Proc

An optional on_parse callback handler. The supplied block/Proc will be called after this argument has been parsed, with three arguments:

@param [String] The value from the command-line that was entered for
  this argument.
@param [Argument] The Argument sub-class object that represents the
  argument that was parsed.
@param [Hash] The results Hash containing the argument keys and their
  values parsed so far.



49
50
51
 
# File 'lib/arg-parser/argument.rb', line 49

def on_parse
  @on_parse
end

#required ⇒ Boolean Also known as: required? 



34
35
36
 
# File 'lib/arg-parser/argument.rb', line 34

def required
  @required
end

#short_key ⇒ Symbol 



30
31
32
 
# File 'lib/arg-parser/argument.rb', line 30

def short_key
  @short_key
end

#usage_break ⇒ String 



53
54
55
 
# File 'lib/arg-parser/argument.rb', line 53

def usage_break
  @usage_break
end

Class Method Details

.lookup(lookup_key) ⇒ Argument

Return a copy of a pre-defined argument for use in an argument definition.



99
100
101
102
103
104
105
 
# File 'lib/arg-parser/argument.rb', line 99

def self.lookup(lookup_key)
    key = self.to_key(lookup_key)
    unless arg = PredefinedArguments[key]
        raise ArgumentError, "No pre-defined argument has been registered under key '#{lookup_key}'"
    end
    arg.clone
end

.register(lookup_key, arg) ⇒ Object

Register a common argument for use in multiple argument definitions. The registered argument is a completely defined argument that can be added to any argument definition via Definition#predefined_arg.

See Also:



82
83
84
85
86
87
88
 
# File 'lib/arg-parser/argument.rb', line 82

def self.register(lookup_key, arg)
    key = self.to_key(lookup_key)
    if PredefinedArguments.has_key?(key)
        raise ArgumentError, "An argument has already been registered under key '#{lookup_key}'"
    end
    PredefinedArguments[key] = arg
end

.to_key(label) ⇒ Symbol

Converts an argument key specification into a valid key, by stripping leading dashes, converting remaining dashes to underscores, and lower- casing all text. This is required to ensure the key name will be a valid accessor name on the parse results.



63
64
65
66
 
# File 'lib/arg-parser/argument.rb', line 63

def self.to_key(label)
    k = label.to_s.gsub(/^-+/, '').gsub('-', '_')
    k.length > 1 ? k.downcase.intern : k.intern
end