## 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("--") }
    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("--") }
    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_raise(CommandlineError) { @p.parse(%w(--argsf hello)) }

    # single arg: string
    assert_nothing_raised { @p.opt "argss", "desc", :default => "foobar" }
    assert_nothing_raised { opts = @p.parse("--") }
    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("--") }
    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("--") }
    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: strings
    assert_nothing_raised { @p.opt "argms", "desc", :default => %w(hello world) }
    assert_nothing_raised { opts = @p.parse("--") }
    assert_equal %w(hello world), opts["argms"]
    assert_nothing_raised { opts = @p.parse(%w(--argms 3.4)) }
    assert_equal ["3.4"], opts["argms"]
    assert_nothing_raised { opts = @p.parse(%w(--argms goodbye)) }
    assert_equal ["goodbye"], opts["argms"]
  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 "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 "argms", "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"
    assert_raise(ArgumentError) { @p.opt "gra" }
    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_detects_running_out
    @p.opt :arg1 # auto: a
    @p.opt :arg2 # auto: r
    @p.opt :arg3 # auto: g
    assert_raises(ArgumentError) { @p.opt :arg4 }
    assert_nothing_raised { @p.opt :argf }
  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] <filenames>+",
      "where [options] are:"], @p.wrap(<<EOM, :width => 100)
Test is an awesome program that does something very, very important.

Usage:
  test [options] <filenames>+
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_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]
    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 }
    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 }
    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
end

end
end