trollop-ghetto 1.16.3

data/release-script.txt

@@ -0,0 +1,15 @@
+Just a few simple steps to make a new release.
+
+vi History.txt    # and describe changes
+git-rank-contributors -o -h >> www/index.html
+vi www/index.html # and integrate contributors
+## git add, git commit, etc
+vi lib/trollop.rb # and bump version number
+git commit -a -m "bump to..."
+git tag release-<releasename>
+rake gem
+gem push pkg/<gem name>
+git push
+git push --tags
+rake upload_docs
+rake upload_webpage

data/test/test_trollop.rb

@@ -0,0 +1,1096 @@
+## 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 unless the argument is optional
+  def test_argflags_demand_args
+    @p.opt "goodarg", "desc", :type => String
+    @p.opt "goodarg2", "desc", :type => String
+    @p.opt "goodarg3", "desc", :type => String, :allow_blank => true
+    
+    assert_nothing_raised { @p.parse(%w(--goodarg goat)) }
+    assert_raise(CommandlineError) { @p.parse(%w(--goodarg --goodarg2 goat)) }
+    assert_raise(CommandlineError) { @p.parse(%w(--goodarg)) }
+    assert_nothing_raised { @p.parse(%w(--goodarg3)) }
+  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] <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_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
+
+  def test_simple_interface_handles_help
+    ARGV.clear
+    ARGV.unshift "-h"
+    assert_raises(SystemExit) do
+      opts = ::Trollop::options do
+        opt :potato
+      end
+      raise "broken"
+    end
+  end
+
+  def test_simple_interface_handles_version
+    ARGV.clear
+    ARGV.unshift "-v"
+    assert_raises(SystemExit) do
+      opts = ::Trollop::options do
+        version "1.2"
+        opt :potato
+      end
+      raise "broken"
+    end
+  end
+
+  def test_simple_interface_handles_regular_usage
+    ARGV.clear
+    ARGV.unshift "--potato"
+    opts = nil
+    assert_nothing_raised do
+      opts = ::Trollop::options do
+        opt :potato
+      end
+    end
+    assert opts[:potato]
+  end
+
+  def test_simple_interface_handles_die
+    ARGV.clear
+    ARGV.unshift "--potato"
+    opts = ::Trollop::options do
+      opt :potato
+    end
+    assert_raises(SystemExit) { ::Trollop::die :potato, "is invalid" }
+  end
+end
+
+end
+end