Class | Argvector |
In: |
lib/more/facets/argvector.rb
|
Parent: | Object |
Argvector provides a very simple means of parsing command line arguments.
Unlike other more complex libs this provides only the most basic and standard parsing functionality. In many cases that‘s all one really needs.
Usage is straight foward. Simply instantiate the class and query it for the particular "views" of the command line you want.
cargs = Argvector.new("-a foo -b=2") cargs.parameters #=> [['foo'],{'a'=>true,'b'=>'2'}] cargs.flags #=> ['a'] cargs.preoptions #=> {'a'=>true} cargs.preflags #=> ['a'] cargs.subcommand #=> ['foo',{'b'=>'2'}]
argv | [R] | |
arity | [R] | |
line | [R] |
Like parameters but without allowing for duplicate options.
# File lib/more/facets/argvector.rb, line 188 def parameters_without_duplicates opts = {} @options.each do |k,v| if Array===v opts[k] = v[0] else opts[k] = v end end return @operands, opts end
Same as flags but only returns flags in the preoptions.
# File lib/more/facets/argvector.rb, line 175 def preflags preopts, remainder = *parse_preoptions(argv) f = [] preopts.each do |k, v| if TrueClass===v or FalseClass===v # not that it's ever false f << k end end return f end
Returns a hash of options that occur before the first operand. This works well with subcommand to get the main command‘s options.
line = "--trace stamp --file VERSION" cargs = Argvector.new(line) opts = cargs.preoptions opts #=> {"trace"=>true}
# File lib/more/facets/argvector.rb, line 167 def preoptions preopts, remainder = *parse_preoptions(argv) return preopts end
Assumes the first operand is a "subcommand" and returns it and the argments following it as another Arguments object.
TODO: This probably should be called ‘subcommand’.
# File lib/more/facets/argvector.rb, line 151 def subcommand_with_arguments opts, args = *parse_preoptions(argv) cmd = args.shift subargs = self.class.new(args, @arity) return cmd, subargs end
Assumes the first operand is a "subcommand" and returns it and the argments following it as parameters.
# File lib/more/facets/argvector.rb, line 127 def subcommand_with_parameters opts, args = *parse_preoptions(argv) cmd = args.shift subargs = self.class.new(args, @arity) return [cmd, *subargs.parameters] end