## test/test_trollop.rb -- unit tests for trollop ## Author:: William Morgan (mailto: wmorgan-trollop@masanjin.net) ## Copyright:: Copyright 2007 William Morgan ## License:: GNU GPL version 2 require 'test/unit' require 'stringio' require 'trollop' module Trollop module Test class Trollop < ::Test::Unit::TestCase def setup @p = Parser.new end def test_unknown_arguments assert_raise(CommandlineError) { @p.parse(%w(--arg)) } @p.opt "arg" assert_nothing_raised { @p.parse(%w(--arg)) } assert_raise(CommandlineError) { @p.parse(%w(--arg2)) } end def test_syntax_check @p.opt "arg" assert_nothing_raised { @p.parse(%w(--arg)) } assert_nothing_raised { @p.parse(%w(arg)) } assert_raise(CommandlineError) { @p.parse(%w(---arg)) } assert_raise(CommandlineError) { @p.parse(%w(-arg)) } end def test_required_flags_are_required @p.opt "arg", "desc", :required => true @p.opt "arg2", "desc", :required => false @p.opt "arg3", "desc", :required => false assert_nothing_raised { @p.parse(%w(--arg)) } assert_nothing_raised { @p.parse(%w(--arg --arg2)) } assert_raise(CommandlineError) { @p.parse(%w(--arg2)) } assert_raise(CommandlineError) { @p.parse(%w(--arg2 --arg3)) } end ## flags that take an argument error unless given one def test_argflags_demand_args @p.opt "goodarg", "desc", :type => String @p.opt "goodarg2", "desc", :type => String assert_nothing_raised { @p.parse(%w(--goodarg goat)) } assert_raise(CommandlineError) { @p.parse(%w(--goodarg --goodarg2 goat)) } assert_raise(CommandlineError) { @p.parse(%w(--goodarg)) } end ## flags that don't take arguments ignore them def test_arglessflags_refuse_args @p.opt "goodarg" @p.opt "goodarg2" assert_nothing_raised { @p.parse(%w(--goodarg)) } assert_nothing_raised { @p.parse(%w(--goodarg --goodarg2)) } opts = @p.parse %w(--goodarg a) assert_equal true, opts["goodarg"] assert_equal ["a"], @p.leftovers end ## flags that require args of a specific type refuse args of other ## types def test_typed_args_refuse_args_of_other_types assert_nothing_raised { @p.opt "goodarg", "desc", :type => :int } assert_raise(ArgumentError) { @p.opt "badarg", "desc", :type => :asdf } assert_nothing_raised { @p.parse(%w(--goodarg 3)) } assert_raise(CommandlineError) { @p.parse(%w(--goodarg 4.2)) } assert_raise(CommandlineError) { @p.parse(%w(--goodarg hello)) } end ## type is correctly derived from :default def test_type_correctly_derived_from_default assert_raise(ArgumentError) { @p.opt "badarg", "desc", :default => [] } opts = nil # single arg: int assert_nothing_raised { @p.opt "argsi", "desc", :default => 0 } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal 0, opts["argsi"] assert_nothing_raised { opts = @p.parse(%w(--argsi 4)) } assert_equal 4, opts["argsi"] assert_raise(CommandlineError) { @p.parse(%w(--argsi 4.2)) } assert_raise(CommandlineError) { @p.parse(%w(--argsi hello)) } # single arg: float assert_nothing_raised { @p.opt "argsf", "desc", :default => 3.14 } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal 3.14, opts["argsf"] assert_nothing_raised { opts = @p.parse(%w(--argsf 2.41)) } assert_equal 2.41, opts["argsf"] assert_nothing_raised { opts = @p.parse(%w(--argsf 2)) } assert_equal 2, opts["argsf"] assert_nothing_raised { opts = @p.parse(%w(--argsf 1.0e-2)) } assert_equal 1.0e-2, opts["argsf"] assert_raise(CommandlineError) { @p.parse(%w(--argsf hello)) } # single arg: date date = Date.today assert_nothing_raised { @p.opt "argsd", "desc", :default => date } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal Date.today, opts["argsd"] assert_nothing_raised { opts = @p.parse(['--argsd', 'Jan 4, 2007']) } assert_equal Date.civil(2007, 1, 4), opts["argsd"] assert_raise(CommandlineError) { @p.parse(%w(--argsd hello)) } # single arg: string assert_nothing_raised { @p.opt "argss", "desc", :default => "foobar" } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal "foobar", opts["argss"] assert_nothing_raised { opts = @p.parse(%w(--argss 2.41)) } assert_equal "2.41", opts["argss"] assert_nothing_raised { opts = @p.parse(%w(--argss hello)) } assert_equal "hello", opts["argss"] # multi args: ints assert_nothing_raised { @p.opt "argmi", "desc", :default => [3, 5] } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal [3, 5], opts["argmi"] assert_nothing_raised { opts = @p.parse(%w(--argmi 4)) } assert_equal [4], opts["argmi"] assert_raise(CommandlineError) { @p.parse(%w(--argmi 4.2)) } assert_raise(CommandlineError) { @p.parse(%w(--argmi hello)) } # multi args: floats assert_nothing_raised { @p.opt "argmf", "desc", :default => [3.34, 5.21] } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal [3.34, 5.21], opts["argmf"] assert_nothing_raised { opts = @p.parse(%w(--argmf 2)) } assert_equal [2], opts["argmf"] assert_nothing_raised { opts = @p.parse(%w(--argmf 4.0)) } assert_equal [4.0], opts["argmf"] assert_raise(CommandlineError) { @p.parse(%w(--argmf hello)) } # multi args: dates dates = [Date.today, Date.civil(2007, 1, 4)] assert_nothing_raised { @p.opt "argmd", "desc", :default => dates } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal dates, opts["argmd"] assert_nothing_raised { opts = @p.parse(['--argmd', 'Jan 4, 2007']) } assert_equal [Date.civil(2007, 1, 4)], opts["argmd"] assert_raise(CommandlineError) { @p.parse(%w(--argmd hello)) } # multi args: strings assert_nothing_raised { @p.opt "argmst", "desc", :default => %w(hello world) } assert_nothing_raised { opts = @p.parse(%w(--)) } assert_equal %w(hello world), opts["argmst"] assert_nothing_raised { opts = @p.parse(%w(--argmst 3.4)) } assert_equal ["3.4"], opts["argmst"] assert_nothing_raised { opts = @p.parse(%w(--argmst goodbye)) } assert_equal ["goodbye"], opts["argmst"] end ## :type and :default must match if both are specified def test_type_and_default_must_match assert_raise(ArgumentError) { @p.opt "badarg", "desc", :type => :int, :default => "hello" } assert_raise(ArgumentError) { @p.opt "badarg2", "desc", :type => :String, :default => 4 } assert_raise(ArgumentError) { @p.opt "badarg2", "desc", :type => :String, :default => ["hi"] } assert_raise(ArgumentError) { @p.opt "badarg2", "desc", :type => :ints, :default => [3.14] } assert_nothing_raised { @p.opt "argsi", "desc", :type => :int, :default => 4 } assert_nothing_raised { @p.opt "argsf", "desc", :type => :float, :default => 3.14 } assert_nothing_raised { @p.opt "argsd", "desc", :type => :date, :default => Date.today } assert_nothing_raised { @p.opt "argss", "desc", :type => :string, :default => "yo" } assert_nothing_raised { @p.opt "argmi", "desc", :type => :ints, :default => [4] } assert_nothing_raised { @p.opt "argmf", "desc", :type => :floats, :default => [3.14] } assert_nothing_raised { @p.opt "argmd", "desc", :type => :dates, :default => [Date.today] } assert_nothing_raised { @p.opt "argmst", "desc", :type => :strings, :default => ["yo"] } end def test_long_detects_bad_names assert_nothing_raised { @p.opt "goodarg", "desc", :long => "none" } assert_nothing_raised { @p.opt "goodarg2", "desc", :long => "--two" } assert_raise(ArgumentError) { @p.opt "badarg", "desc", :long => "" } assert_raise(ArgumentError) { @p.opt "badarg2", "desc", :long => "--" } assert_raise(ArgumentError) { @p.opt "badarg3", "desc", :long => "-one" } assert_raise(ArgumentError) { @p.opt "badarg4", "desc", :long => "---toomany" } end def test_short_detects_bad_names assert_nothing_raised { @p.opt "goodarg", "desc", :short => "a" } assert_nothing_raised { @p.opt "goodarg2", "desc", :short => "-b" } assert_raise(ArgumentError) { @p.opt "badarg", "desc", :short => "" } assert_raise(ArgumentError) { @p.opt "badarg2", "desc", :short => "-ab" } assert_raise(ArgumentError) { @p.opt "badarg3", "desc", :short => "--t" } end def test_short_names_created_automatically @p.opt "arg" @p.opt "arg2" @p.opt "arg3" opts = @p.parse %w(-a -g) assert_equal true, opts["arg"] assert_equal false, opts["arg2"] assert_equal true, opts["arg3"] end def test_short_autocreation_skips_dashes_and_numbers @p.opt :arg # auto: a @p.opt :arg_potato # auto: r @p.opt :arg_muffin # auto: g assert_nothing_raised { @p.opt :arg_daisy } # auto: d (not _)! assert_nothing_raised { @p.opt :arg_r2d2f } # auto: f (not 2)! opts = @p.parse %w(-f -d) assert_equal true, opts[:arg_daisy] assert_equal true, opts[:arg_r2d2f] assert_equal false, opts[:arg] assert_equal false, opts[:arg_potato] assert_equal false, opts[:arg_muffin] end def test_short_autocreation_is_ok_with_running_out_of_chars @p.opt :arg1 # auto: a @p.opt :arg2 # auto: r @p.opt :arg3 # auto: g @p.opt :arg4 # auto: uh oh! assert_nothing_raised { @p.parse [] } end def test_short_can_be_nothing assert_nothing_raised do @p.opt "arg", "desc", :short => :none @p.parse [] end sio = StringIO.new "w" @p.educate sio assert sio.string =~ /--arg:\s+desc/ assert_raise(CommandlineError) { @p.parse %w(-a) } end ## two args can't have the same name def test_conflicting_names_are_detected assert_nothing_raised { @p.opt "goodarg" } assert_raise(ArgumentError) { @p.opt "goodarg" } end ## two args can't have the same :long def test_conflicting_longs_detected assert_nothing_raised { @p.opt "goodarg", "desc", :long => "--goodarg" } assert_raise(ArgumentError) { @p.opt "badarg", "desc", :long => "--goodarg" } end ## two args can't have the same :short def test_conflicting_shorts_detected assert_nothing_raised { @p.opt "goodarg", "desc", :short => "-g" } assert_raise(ArgumentError) { @p.opt "badarg", "desc", :short => "-g" } end def test_flag_defaults @p.opt "defaultfalse", "desc" @p.opt "defaulttrue", "desc", :default => true opts = @p.parse [] assert_equal false, opts["defaultfalse"] assert_equal true, opts["defaulttrue"] opts = @p.parse %w(--defaultfalse --defaulttrue) assert_equal true, opts["defaultfalse"] assert_equal false, opts["defaulttrue"] end def test_special_flags_work @p.version "asdf fdas" assert_raise(VersionNeeded) { @p.parse(%w(-v)) } assert_raise(HelpNeeded) { @p.parse(%w(-h)) } end def test_short_options_combine @p.opt :arg1, "desc", :short => "a" @p.opt :arg2, "desc", :short => "b" @p.opt :arg3, "desc", :short => "c", :type => :int opts = nil assert_nothing_raised { opts = @p.parse %w(-a -b) } assert_equal true, opts[:arg1] assert_equal true, opts[:arg2] assert_equal nil, opts[:arg3] assert_nothing_raised { opts = @p.parse %w(-ab) } assert_equal true, opts[:arg1] assert_equal true, opts[:arg2] assert_equal nil, opts[:arg3] assert_nothing_raised { opts = @p.parse %w(-ac 4 -b) } assert_equal true, opts[:arg1] assert_equal true, opts[:arg2] assert_equal 4, opts[:arg3] assert_raises(CommandlineError) { @p.parse %w(-cab 4) } assert_raises(CommandlineError) { @p.parse %w(-cba 4) } end def test_version_only_appears_if_set @p.opt "arg" assert_raise(CommandlineError) { @p.parse %w(-v) } @p.version "trollop 1.2.3.4" assert_raise(VersionNeeded) { @p.parse %w(-v) } end def test_doubledash_ends_option_processing @p.opt :arg1, "desc", :short => "a", :default => 0 @p.opt :arg2, "desc", :short => "b", :default => 0 opts = nil assert_nothing_raised { opts = @p.parse %w(-- -a 3 -b 2) } assert_equal opts[:arg1], 0 assert_equal opts[:arg2], 0 assert_equal %w(-a 3 -b 2), @p.leftovers assert_nothing_raised { opts = @p.parse %w(-a 3 -- -b 2) } assert_equal opts[:arg1], 3 assert_equal opts[:arg2], 0 assert_equal %w(-b 2), @p.leftovers assert_nothing_raised { opts = @p.parse %w(-a 3 -b 2 --) } assert_equal opts[:arg1], 3 assert_equal opts[:arg2], 2 assert_equal %w(), @p.leftovers end def test_wrap assert_equal [""], @p.wrap("") assert_equal ["a"], @p.wrap("a") assert_equal ["one two", "three"], @p.wrap("one two three", :width => 8) assert_equal ["one two three"], @p.wrap("one two three", :width => 80) assert_equal ["one", "two", "three"], @p.wrap("one two three", :width => 3) assert_equal ["onetwothree"], @p.wrap("onetwothree", :width => 3) assert_equal [ "Test is an awesome program that does something very, very important.", "", "Usage:", " test [options] +", "where [options] are:"], @p.wrap(< 100) Test is an awesome program that does something very, very important. Usage: test [options] + where [options] are: EOM end def test_floating_point_formatting @p.opt :arg, "desc", :type => :float, :short => "f" opts = nil assert_nothing_raised { opts = @p.parse %w(-f 1) } assert_equal 1.0, opts[:arg] assert_nothing_raised { opts = @p.parse %w(-f 1.0) } assert_equal 1.0, opts[:arg] assert_nothing_raised { opts = @p.parse %w(-f 0.1) } assert_equal 0.1, opts[:arg] assert_nothing_raised { opts = @p.parse %w(-f .1) } assert_equal 0.1, opts[:arg] assert_nothing_raised { opts = @p.parse %w(-f .99999999999999999999) } assert_equal 1.0, opts[:arg] assert_nothing_raised { opts = @p.parse %w(-f -1) } assert_equal(-1.0, opts[:arg]) assert_nothing_raised { opts = @p.parse %w(-f -1.0) } assert_equal(-1.0, opts[:arg]) assert_nothing_raised { opts = @p.parse %w(-f -0.1) } assert_equal(-0.1, opts[:arg]) assert_nothing_raised { opts = @p.parse %w(-f -.1) } assert_equal(-0.1, opts[:arg]) assert_raises(CommandlineError) { @p.parse %w(-f a) } assert_raises(CommandlineError) { @p.parse %w(-f 1a) } assert_raises(CommandlineError) { @p.parse %w(-f 1.a) } assert_raises(CommandlineError) { @p.parse %w(-f a.1) } assert_raises(CommandlineError) { @p.parse %w(-f 1.0.0) } assert_raises(CommandlineError) { @p.parse %w(-f .) } assert_raises(CommandlineError) { @p.parse %w(-f -.) } end def test_date_formatting @p.opt :arg, "desc", :type => :date, :short => 'd' opts = nil assert_nothing_raised { opts = @p.parse(['-d', 'Jan 4, 2007']) } assert_equal Date.civil(2007, 1, 4), opts[:arg] begin require 'chronic' assert_nothing_raised { opts = @p.parse(['-d', 'today']) } assert_equal Date.today, opts[:arg] rescue LoadError # chronic is not available end end def test_short_options_cant_be_numeric assert_raises(ArgumentError) { @p.opt :arg, "desc", :short => "-1" } @p.opt :a1b, "desc" @p.opt :a2b, "desc" assert_not_equal "2", @p.specs[:a2b][:short] end def test_short_options_can_be_weird assert_nothing_raised { @p.opt :arg1, "desc", :short => "#" } assert_nothing_raised { @p.opt :arg2, "desc", :short => "." } assert_raises(ArgumentError) { @p.opt :arg3, "desc", :short => "-" } end def test_options_cant_be_set_multiple_times_if_not_specified @p.opt :arg, "desc", :short => "-x" assert_nothing_raised { @p.parse %w(-x) } assert_raises(CommandlineError) { @p.parse %w(-x -x) } assert_raises(CommandlineError) { @p.parse %w(-xx) } end def test_options_can_be_set_multiple_times_if_specified assert_nothing_raised do @p.opt :arg, "desc", :short => "-x", :multi => true end assert_nothing_raised { @p.parse %w(-x) } assert_nothing_raised { @p.parse %w(-x -x) } assert_nothing_raised { @p.parse %w(-xx) } end def test_short_options_with_multiple_options opts = nil assert_nothing_raised do @p.opt :xarg, "desc", :short => "-x", :type => String, :multi => true end assert_nothing_raised { opts = @p.parse %w(-x a -x b) } assert_equal %w(a b), opts[:xarg] assert_equal [], @p.leftovers end def short_options_with_multiple_options_does_not_affect_flags_type opts = nil assert_nothing_raised do @p.opt :xarg, "desc", :short => "-x", :type => :flag, :multi => true end assert_nothing_raised { opts = @p.parse %w(-x a) } assert_equal true, opts[:xarg] assert_equal %w(a), @p.leftovers assert_nothing_raised { opts = @p.parse %w(-x a -x b) } assert_equal true, opts[:xarg] assert_equal %w(a b), @p.leftovers assert_nothing_raised { opts = @p.parse %w(-xx a -x b) } assert_equal true, opts[:xarg] assert_equal %w(a b), @p.leftovers end def test_short_options_with_multiple_arguments opts = nil @p.opt :xarg, "desc", :type => :ints assert_nothing_raised { opts = @p.parse %w(-x 3 4 0) } assert_equal [3, 4, 0], opts[:xarg] assert_equal [], @p.leftovers @p.opt :yarg, "desc", :type => :floats assert_nothing_raised { opts = @p.parse %w(-y 3.14 4.21 0.66) } assert_equal [3.14, 4.21, 0.66], opts[:yarg] assert_equal [], @p.leftovers @p.opt :zarg, "desc", :type => :strings assert_nothing_raised { opts = @p.parse %w(-z a b c) } assert_equal %w(a b c), opts[:zarg] assert_equal [], @p.leftovers end def test_short_options_with_multiple_options_and_arguments opts = nil @p.opt :xarg, "desc", :type => :ints, :multi => true assert_nothing_raised { opts = @p.parse %w(-x 3 4 5 -x 6 7) } assert_equal [[3, 4, 5], [6, 7]], opts[:xarg] assert_equal [], @p.leftovers @p.opt :yarg, "desc", :type => :floats, :multi => true assert_nothing_raised { opts = @p.parse %w(-y 3.14 4.21 5.66 -y 6.99 7.01) } assert_equal [[3.14, 4.21, 5.66], [6.99, 7.01]], opts[:yarg] assert_equal [], @p.leftovers @p.opt :zarg, "desc", :type => :strings, :multi => true assert_nothing_raised { opts = @p.parse %w(-z a b c -z d e) } assert_equal [%w(a b c), %w(d e)], opts[:zarg] assert_equal [], @p.leftovers end def test_combined_short_options_with_multiple_arguments @p.opt :arg1, "desc", :short => "a" @p.opt :arg2, "desc", :short => "b" @p.opt :arg3, "desc", :short => "c", :type => :ints @p.opt :arg4, "desc", :short => "d", :type => :floats opts = nil assert_nothing_raised { opts = @p.parse %w(-abc 4 6 9) } assert_equal true, opts[:arg1] assert_equal true, opts[:arg2] assert_equal [4, 6, 9], opts[:arg3] assert_nothing_raised { opts = @p.parse %w(-ac 4 6 9 -bd 3.14 2.41) } assert_equal true, opts[:arg1] assert_equal true, opts[:arg2] assert_equal [4, 6, 9], opts[:arg3] assert_equal [3.14, 2.41], opts[:arg4] assert_raises(CommandlineError) { opts = @p.parse %w(-abcd 3.14 2.41) } end def test_long_options_with_multiple_options @p.opt :xarg, "desc", :type => String, :multi => true opts = nil assert_nothing_raised { opts = @p.parse %w(--xarg=a --xarg=b) } assert_equal %w(a b), opts[:xarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--xarg a --xarg b) } assert_equal %w(a b), opts[:xarg] assert_equal [], @p.leftovers end def test_long_options_with_multiple_arguments opts = nil @p.opt :xarg, "desc", :type => :ints assert_nothing_raised { opts = @p.parse %w(--xarg 3 2 5) } assert_equal [3, 2, 5], opts[:xarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--xarg=3) } assert_equal [3], opts[:xarg] assert_equal [], @p.leftovers @p.opt :yarg, "desc", :type => :floats assert_nothing_raised { opts = @p.parse %w(--yarg 3.14 2.41 5.66) } assert_equal [3.14, 2.41, 5.66], opts[:yarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--yarg=3.14) } assert_equal [3.14], opts[:yarg] assert_equal [], @p.leftovers @p.opt :zarg, "desc", :type => :strings assert_nothing_raised { opts = @p.parse %w(--zarg a b c) } assert_equal %w(a b c), opts[:zarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--zarg=a) } assert_equal %w(a), opts[:zarg] assert_equal [], @p.leftovers end def test_long_options_with_multiple_options_and_arguments opts = nil @p.opt :xarg, "desc", :type => :ints, :multi => true assert_nothing_raised { opts = @p.parse %w(--xarg 3 2 5 --xarg 2 1) } assert_equal [[3, 2, 5], [2, 1]], opts[:xarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--xarg=3 --xarg=2) } assert_equal [[3], [2]], opts[:xarg] assert_equal [], @p.leftovers @p.opt :yarg, "desc", :type => :floats, :multi => true assert_nothing_raised { opts = @p.parse %w(--yarg 3.14 2.72 5 --yarg 2.41 1.41) } assert_equal [[3.14, 2.72, 5], [2.41, 1.41]], opts[:yarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--yarg=3.14 --yarg=2.41) } assert_equal [[3.14], [2.41]], opts[:yarg] assert_equal [], @p.leftovers @p.opt :zarg, "desc", :type => :strings, :multi => true assert_nothing_raised { opts = @p.parse %w(--zarg a b c --zarg d e) } assert_equal [%w(a b c), %w(d e)], opts[:zarg] assert_equal [], @p.leftovers assert_nothing_raised { opts = @p.parse %w(--zarg=a --zarg=d) } assert_equal [%w(a), %w(d)], opts[:zarg] assert_equal [], @p.leftovers end def test_long_options_also_take_equals @p.opt :arg, "desc", :long => "arg", :type => String, :default => "hello" opts = nil assert_nothing_raised { opts = @p.parse %w() } assert_equal "hello", opts[:arg] assert_nothing_raised { opts = @p.parse %w(--arg goat) } assert_equal "goat", opts[:arg] assert_nothing_raised { opts = @p.parse %w(--arg=goat) } assert_equal "goat", opts[:arg] ## actually, this next one is valid. empty string for --arg, and goat as a ## leftover. ## assert_raises(CommandlineError) { opts = @p.parse %w(--arg= goat) } end def test_auto_generated_long_names_convert_underscores_to_hyphens @p.opt :hello_there assert_equal "hello-there", @p.specs[:hello_there][:long] end def test_arguments_passed_through_block @goat = 3 boat = 4 Parser.new(@goat) do |goat| boat = goat end assert_equal @goat, boat end def test_help_has_default_banner @p = Parser.new sio = StringIO.new "w" @p.parse [] @p.educate sio help = sio.string.split "\n" assert help[0] =~ /options/i assert_equal 2, help.length # options, then -h @p = Parser.new @p.version "my version" sio = StringIO.new "w" @p.parse [] @p.educate sio help = sio.string.split "\n" assert help[0] =~ /my version/i assert_equal 4, help.length # version, options, -h, -v @p = Parser.new @p.banner "my own banner" sio = StringIO.new "w" @p.parse [] @p.educate sio help = sio.string.split "\n" assert help[0] =~ /my own banner/i assert_equal 2, help.length # banner, -h end def test_help_preserves_positions @p.opt :zzz, "zzz" @p.opt :aaa, "aaa" sio = StringIO.new "w" @p.educate sio help = sio.string.split "\n" assert help[1] =~ /zzz/ assert help[2] =~ /aaa/ end def test_version_and_help_short_args_can_be_overridden @p.opt :verbose, "desc", :short => "-v" @p.opt :hello, "desc", :short => "-h" @p.version "version" assert_nothing_raised { @p.parse(%w(-v)) } assert_raises(VersionNeeded) { @p.parse(%w(--version)) } assert_nothing_raised { @p.parse(%w(-h)) } assert_raises(HelpNeeded) { @p.parse(%w(--help)) } end def test_version_and_help_long_args_can_be_overridden @p.opt :asdf, "desc", :long => "help" @p.opt :asdf2, "desc2", :long => "version" assert_nothing_raised { @p.parse %w() } assert_nothing_raised { @p.parse %w(--help) } assert_nothing_raised { @p.parse %w(--version) } assert_nothing_raised { @p.parse %w(-h) } assert_nothing_raised { @p.parse %w(-v) } end def test_version_and_help_override_errors @p.opt :asdf, "desc", :type => String @p.version "version" assert_nothing_raised { @p.parse %w(--asdf goat) } assert_raises(CommandlineError) { @p.parse %w(--asdf) } assert_raises(HelpNeeded) { @p.parse %w(--asdf --help) } assert_raises(VersionNeeded) { @p.parse %w(--asdf --version) } end def test_conflicts @p.opt :one assert_raises(ArgumentError) { @p.conflicts :one, :two } @p.opt :two assert_nothing_raised { @p.conflicts :one, :two } assert_nothing_raised { @p.parse %w(--one) } assert_nothing_raised { @p.parse %w(--two) } assert_raises(CommandlineError) { opts = @p.parse %w(--one --two) } @p.opt :hello @p.opt :yellow @p.opt :mellow @p.opt :jello @p.conflicts :hello, :yellow, :mellow, :jello assert_raises(CommandlineError) { opts = @p.parse %w(--hello --yellow --mellow --jello) } assert_raises(CommandlineError) { opts = @p.parse %w(--hello --mellow --jello) } assert_raises(CommandlineError) { opts = @p.parse %w(--hello --jello) } assert_nothing_raised { opts = @p.parse %w(--hello) } assert_nothing_raised { opts = @p.parse %w(--jello) } assert_nothing_raised { opts = @p.parse %w(--yellow) } assert_nothing_raised { opts = @p.parse %w(--mellow) } assert_nothing_raised { opts = @p.parse %w(--mellow --one) } assert_nothing_raised { opts = @p.parse %w(--mellow --two) } assert_raises(CommandlineError) { opts = @p.parse %w(--mellow --two --jello) } assert_raises(CommandlineError) { opts = @p.parse %w(--one --mellow --two --jello) } end def test_conflict_error_messages @p.opt :one @p.opt "two" @p.conflicts :one, "two" begin @p.parse %w(--one --two) flunk "no error thrown" rescue CommandlineError => e assert_match(/--one/, e.message) assert_match(/--two/, e.message) end end def test_depends @p.opt :one assert_raises(ArgumentError) { @p.depends :one, :two } @p.opt :two assert_nothing_raised { @p.depends :one, :two } assert_nothing_raised { opts = @p.parse %w(--one --two) } assert_raises(CommandlineError) { @p.parse %w(--one) } assert_raises(CommandlineError) { @p.parse %w(--two) } @p.opt :hello @p.opt :yellow @p.opt :mellow @p.opt :jello @p.depends :hello, :yellow, :mellow, :jello assert_nothing_raised { opts = @p.parse %w(--hello --yellow --mellow --jello) } assert_raises(CommandlineError) { opts = @p.parse %w(--hello --mellow --jello) } assert_raises(CommandlineError) { opts = @p.parse %w(--hello --jello) } assert_raises(CommandlineError) { opts = @p.parse %w(--hello) } assert_raises(CommandlineError) { opts = @p.parse %w(--mellow) } assert_nothing_raised { opts = @p.parse %w(--hello --yellow --mellow --jello --one --two) } assert_nothing_raised { opts = @p.parse %w(--hello --yellow --mellow --jello --one --two a b c) } assert_raises(CommandlineError) { opts = @p.parse %w(--mellow --two --jello --one) } end def test_depend_error_messages @p.opt :one @p.opt "two" @p.depends :one, "two" assert_nothing_raised { @p.parse %w(--one --two) } begin @p.parse %w(--one) flunk "no error thrown" rescue CommandlineError => e assert_match(/--one/, e.message) assert_match(/--two/, e.message) end begin @p.parse %w(--two) flunk "no error thrown" rescue CommandlineError => e assert_match(/--one/, e.message) assert_match(/--two/, e.message) end end ## courtesy neill zero def test_two_required_one_missing_accuses_correctly @p.opt "arg1", "desc1", :required => true @p.opt "arg2", "desc2", :required => true begin @p.parse(%w(--arg1)) flunk "should have failed on a missing req" rescue CommandlineError => e assert e.message =~ /arg2/, "didn't mention arg2 in the error msg: #{e.message}" end begin @p.parse(%w(--arg2)) flunk "should have failed on a missing req" rescue CommandlineError => e assert e.message =~ /arg1/, "didn't mention arg1 in the error msg: #{e.message}" end assert_nothing_raised { @p.parse(%w(--arg1 --arg2)) } end def test_stopwords_mixed @p.opt "arg1", :default => false @p.opt "arg2", :default => false @p.stop_on %w(happy sad) opts = @p.parse %w(--arg1 happy --arg2) assert_equal true, opts["arg1"] assert_equal false, opts["arg2"] ## restart parsing @p.leftovers.shift opts = @p.parse @p.leftovers assert_equal false, opts["arg1"] assert_equal true, opts["arg2"] end def test_stopwords_no_stopwords @p.opt "arg1", :default => false @p.opt "arg2", :default => false @p.stop_on %w(happy sad) opts = @p.parse %w(--arg1 --arg2) assert_equal true, opts["arg1"] assert_equal true, opts["arg2"] ## restart parsing @p.leftovers.shift opts = @p.parse @p.leftovers assert_equal false, opts["arg1"] assert_equal false, opts["arg2"] end def test_stopwords_multiple_stopwords @p.opt "arg1", :default => false @p.opt "arg2", :default => false @p.stop_on %w(happy sad) opts = @p.parse %w(happy sad --arg1 --arg2) assert_equal false, opts["arg1"] assert_equal false, opts["arg2"] ## restart parsing @p.leftovers.shift opts = @p.parse @p.leftovers assert_equal false, opts["arg1"] assert_equal false, opts["arg2"] ## restart parsing again @p.leftovers.shift opts = @p.parse @p.leftovers assert_equal true, opts["arg1"] assert_equal true, opts["arg2"] end def test_stopwords_with_short_args @p.opt :global_option, "This is a global option", :short => "-g" @p.stop_on %w(sub-command-1 sub-command-2) global_opts = @p.parse %w(-g sub-command-1 -c) cmd = @p.leftovers.shift @q = Parser.new @q.opt :cmd_option, "This is an option only for the subcommand", :short => "-c" cmd_opts = @q.parse @p.leftovers assert_equal true, global_opts[:global_option] assert_nil global_opts[:cmd_option] assert_equal true, cmd_opts[:cmd_option] assert_nil cmd_opts[:global_option] assert_equal cmd, "sub-command-1" assert_equal @q.leftovers, [] end def assert_parses_correctly(parser, commandline, expected_opts, expected_leftovers) opts = parser.parse commandline assert_equal expected_opts, opts assert_equal expected_leftovers, parser.leftovers end def test_unknown_subcommand @p.opt :global_flag, "Global flag", :short => "-g", :type => :flag @p.opt :global_param, "Global parameter", :short => "-p", :default => 5 @p.stop_on_unknown expected_opts = { :global_flag => true, :help => false, :global_param => 5, :global_flag_given => true } expected_leftovers = [ "my_subcommand", "-c" ] assert_parses_correctly @p, %w(--global-flag my_subcommand -c), \ expected_opts, expected_leftovers assert_parses_correctly @p, %w(-g my_subcommand -c), \ expected_opts, expected_leftovers expected_opts = { :global_flag => false, :help => false, :global_param => 5, :global_param_given => true } expected_leftovers = [ "my_subcommand", "-c" ] assert_parses_correctly @p, %w(-p 5 my_subcommand -c), \ expected_opts, expected_leftovers assert_parses_correctly @p, %w(--global-param 5 my_subcommand -c), \ expected_opts, expected_leftovers end def test_alternate_args args = %w(-a -b -c) opts = ::Trollop.options(args) do opt :alpher, "Ralph Alpher", :short => "-a" opt :bethe, "Hans Bethe", :short => "-b" opt :gamow, "George Gamow", :short => "-c" end physicists_with_humor = [:alpher, :bethe, :gamow] physicists_with_humor.each do |physicist| assert_equal true, opts[physicist] end end def test_io_arg_type @p.opt :arg, "desc", :type => :io @p.opt :arg2, "desc", :type => IO @p.opt :arg3, "desc", :default => $stdout opts = nil assert_nothing_raised { opts = @p.parse() } assert_equal $stdout, opts[:arg3] assert_nothing_raised { opts = @p.parse %w(--arg /dev/null) } assert_kind_of File, opts[:arg] assert_equal "/dev/null", opts[:arg].path #TODO: move to mocks #assert_nothing_raised { opts = @p.parse %w(--arg2 http://google.com/) } #assert_kind_of StringIO, opts[:arg2] assert_nothing_raised { opts = @p.parse %w(--arg3 stdin) } assert_equal $stdin, opts[:arg3] assert_raises(CommandlineError) { opts = @p.parse %w(--arg /fdasfasef/fessafef/asdfasdfa/fesasf) } end def test_openstruct_style_access @p.opt "arg1", "desc", :type => :int @p.opt :arg2, "desc", :type => :int opts = @p.parse(%w(--arg1 3 --arg2 4)) assert_nothing_raised { opts.arg1 } assert_nothing_raised { opts.arg2 } assert_equal 3, opts.arg1 assert_equal 4, opts.arg2 end def test_multi_args_autobox_defaults @p.opt :arg1, "desc", :default => "hello", :multi => true @p.opt :arg2, "desc", :default => ["hello"], :multi => true opts = @p.parse assert_equal ["hello"], opts[:arg1] assert_equal ["hello"], opts[:arg2] opts = @p.parse %w(--arg1 hello) assert_equal ["hello"], opts[:arg1] assert_equal ["hello"], opts[:arg2] opts = @p.parse %w(--arg1 hello --arg1 there) assert_equal ["hello", "there"], opts[:arg1] end def test_ambigious_multi_plus_array_default_resolved_as_specified_by_documentation @p.opt :arg1, "desc", :default => ["potato"], :multi => true @p.opt :arg2, "desc", :default => ["potato"], :multi => true, :type => :strings @p.opt :arg3, "desc", :default => ["potato"] @p.opt :arg4, "desc", :default => ["potato", "rhubarb"], :short => :none, :multi => true ## arg1 should be multi-occurring but not multi-valued opts = @p.parse %w(--arg1 one two) assert_equal ["one"], opts[:arg1] assert_equal ["two"], @p.leftovers opts = @p.parse %w(--arg1 one --arg1 two) assert_equal ["one", "two"], opts[:arg1] assert_equal [], @p.leftovers ## arg2 should be multi-valued and multi-occurring opts = @p.parse %w(--arg2 one two) assert_equal [["one", "two"]], opts[:arg2] assert_equal [], @p.leftovers ## arg3 should be multi-valued but not multi-occurring opts = @p.parse %w(--arg3 one two) assert_equal ["one", "two"], opts[:arg3] assert_equal [], @p.leftovers ## arg4 should be multi-valued but not multi-occurring opts = @p.parse %w() assert_equal ["potato", "rhubarb"], opts[:arg4] end def test_given_keys @p.opt :arg1 @p.opt :arg2 opts = @p.parse %w(--arg1) assert opts[:arg1_given] assert !opts[:arg2_given] opts = @p.parse %w(--arg2) assert !opts[:arg1_given] assert opts[:arg2_given] opts = @p.parse [] assert !opts[:arg1_given] assert !opts[:arg2_given] opts = @p.parse %w(--arg1 --arg2) assert opts[:arg1_given] assert opts[:arg2_given] end def test_default_shorts_assigned_only_after_user_shorts @p.opt :aab, "aaa" # should be assigned to -b @p.opt :ccd, "bbb" # should be assigned to -d @p.opt :user1, "user1", :short => 'a' @p.opt :user2, "user2", :short => 'c' opts = @p.parse %w(-a -b) assert opts[:user1] assert !opts[:user2] assert opts[:aab] assert !opts[:ccd] opts = @p.parse %w(-c -d) assert !opts[:user1] assert opts[:user2] assert !opts[:aab] assert opts[:ccd] end def test_accepts_arguments_with_spaces @p.opt :arg1, "arg", :type => String @p.opt :arg2, "arg2", :type => String opts = @p.parse ["--arg1", "hello there", "--arg2=hello there"] assert_equal "hello there", opts[:arg1] assert_equal "hello there", opts[:arg2] assert_equal 0, @p.leftovers.size end def test_multi_args_default_to_empty_array @p.opt :arg1, "arg", :multi => true opts = @p.parse [] assert_equal [], opts[:arg1] end end end end