module OptionParser::Arguable

Extends command line arguments array (ARGV) to parse itself.

Public Class Methods

extend_object(obj) click to toggle source

Initializes instance variable.

Calls superclass method

# File lib/optparse.rb, line 2401
def self.extend_object(obj)
  super
  obj.instance_eval {@optparse = nil}
end

Public Instance Methods

getopts(*args, symbolize_names: false, **keywords) click to toggle source

Substitution of getopts is possible as follows. Also see OptionParser#getopts.

def getopts(*args)
  ($OPT = ARGV.getopts(*args)).each do |opt, val|
    eval "$OPT_#{opt.gsub(/[^A-Za-z0-9_]/, '_')} = val"
  end
rescue OptionParser::ParseError
end

# File lib/optparse.rb, line 2394
def getopts(*args, symbolize_names: false, **keywords)
  options.getopts(self, *args, symbolize_names: symbolize_names, **keywords)
end

options() { |optparse| ... } click to toggle source

Actual OptionParser object, automatically created if nonexistent.

If called with a block, yields the OptionParser object and returns the result of the block. If an OptionParser::ParseError exception occurs in the block, it is rescued, a error message printed to STDERR and nil returned.

# File lib/optparse.rb, line 2353
def options
  @optparse ||= OptionParser.new
  @optparse.default_argv = self
  block_given? or return @optparse
  begin
    yield @optparse
  rescue ParseError
    @optparse.warn $!
    nil
  end
end

options=(opt) click to toggle source

Sets OptionParser object, when opt is false or nil, methods OptionParser::Arguable#options and OptionParser::Arguable#options= are undefined. Thus, there is no ways to access the OptionParser object via the receiver object.

# File lib/optparse.rb, line 2336
def options=(opt)
  unless @optparse = opt
    class << self
      undef_method(:options)
      undef_method(:options=)
    end
  end
end

order!(**keywords, &blk) click to toggle source

Parses self destructively in order and returns self containing the rest arguments left unparsed.

# File lib/optparse.rb, line 2369
def order!(**keywords, &blk) options.order!(self, **keywords, &blk) end

parse!(**keywords) click to toggle source

Parses self destructively and returns self containing the rest arguments left unparsed.

# File lib/optparse.rb, line 2381
def parse!(**keywords) options.parse!(self, **keywords) end

permute!(**keywords) click to toggle source

Parses self destructively in permutation mode and returns self containing the rest arguments left unparsed.

# File lib/optparse.rb, line 2375
def permute!(**keywords) options.permute!(self, **keywords) end