Mimics
Inactive cells
Active cells
Specs
Inactive cells (details)
kind = "IOpt CommandLine"
Active cells (details)
empty?()

nil

[ show source ]

method(
  options empty?)
execute()

Execute the actions by priority

[ show source ]

method(
  options sort each(o, o action perform(o args, iopt)))
include?(+options)

nil

[ show source ]

method(+options, 
  options all?(opt, @ options any?(o, opt ===(o option))))
initialize(iopt, argv, coerce: nil, argUntilNextOption: true, includeUnknownOption: true, stopAt: nil)

Parses the command line arguments given on argv using iopt to handle options. This method takes the following arguments: stopAt: When non nil, it must be a text, indicating when to stop processing arguments. You can use this to have your program ignore arguments before -- like many unix programs. argUntilNextOption: When true, option argument processing will stop when next option is seen. Suppose you have an option named --foo taking one required argument and an also have an option named --bar. If argUntilNextOption is false, parsing --foo --bar will result on a single action (--foo) taking one argument ('--bar'). If argUntilNextOption is true, the parsed command line would result in two actions, each having no arguments. If an argument looks like an option but that option has not been registered on the iopt object, then it would be treated just as any other argument. e.g. Parsing --foo --man would create just an action for --foo taking argument '--man' includeUnknownOption: When true, unknown options will be included in the programArguments list. coerce: a CommandLine Coerce object or false to avoid argument coercion. This object has the following cells available: argv: The original array of command line arguments. iopt: The IOpt object used to parse argv. options: A list of objects having cells: :option, :action and :args (the option arguments) unknownOptions: A list of elements from argv that look like options but arent. programArguments: A list of elements from argv that are neither an option nor par of an option arguments rest: A list arguments found after stopAt

[ show source ]

method(iopt, argv, coerce: nil, argUntilNextOption: true, includeUnknownOption: true, stopAt: nil, 
  @ iopt = iopt 
  @ argv = argv 
  @ options = list 
  @ unknownOptions = list 
  @ programArguments = list 
  @ rest = list 
  ary = argv 
  if(stopAt, 
    ary = argv takeWhile(a, case(a, stopAt, false, true)) 
    @ rest = argv [](ary length succ ..(-(1)))) 
  until(ary empty?, 
    if(handler = iopt iopt:get(ary first), 
      if(handler action 
        , 
        options <<(handler) 
        handler <=> = method(o, action <=>(o action)) 
        handler args = handler action consume(
            ary, handler, untilNextOption: argUntilNextOption, coerce: coerce) 
        ary = handler args remnant 
        handler args removeCell!(:remnant) 
        , 
        unknownOptions <<(ary first) 
        if(includeUnknownOption, programArguments <<(ary first)) 
        ary = ary rest 
        ), 
      programArguments <<(ary first) 
      ary = ary rest)) 
  )