RubyGems - benry-cmdopt - Versions diffs - 1.1.0 → 2.0.0 - Mend

benry-cmdopt 1.1.0 → 2.0.0

Files changed (15) hide show

data/test/cmdopt_test.rb CHANGED Viewed

@@ -1,973 +1,1612 @@
 # -*- coding: utf-8 -*-
-require 'minitest/spec'
-require 'minitest/autorun'
-require 'minitest/ok'
+require 'oktest'
 require 'benry/cmdopt'
-def new_sample_schema()
-  sc = Benry::Cmdopt::Schema.new
-  sc.add(:help   , "-h, --help"            , "show help message.")
-  sc.add(:version, "--version"             , "print version")
-  sc.add(:file   , "-f, --file=<FILE>"     , "filename")
-  sc.add(:indent , "-i, --indent[=<WIDTH>]", "enable indent", type: Integer)
-  sc.add(:mode   , "-m, --mode=<MODE>"     , "mode", enum: ['verbose', 'quiet'])
-  sc.add(:libpath, "-I, --path=<PATH>"     , "library path (multiple ok)") do |optdef, key, val|
-    File.directory?(val)  or raise "directory not exist."
-    arr = optdef[key] || []
-    arr << val
-    arr
+Oktest.scope do
+  def new_sample_schema()
+    sc = Benry::CmdOpt::Schema.new
+    sc.add(:help   , "-h, --help"            , "show help message.")
+    sc.add(:version, "--version"             , "print version")
+    sc.add(:file   , "-f, --file=<FILE>"     , "filename")
+    sc.add(:indent , "-i, --indent[=<WIDTH>]", "enable indent", type: Integer)
+    sc.add(:mode   , "-m, --mode=<MODE>"     , "mode", enum: ['verbose', 'quiet'])
+    sc.add(:libpath, "-I, --path=<PATH>"     , "library path (multiple ok)") do |optdef, key, val|
+      File.directory?(val)  or raise "Directory not exist."
+      arr = optdef[key] || []
+      arr << val
+      arr
+    end
+    sc
   end
-  sc
-end
-class Benry::Cmdopt::Schema::Test < MiniTest::Test
+  topic Benry::CmdOpt::Schema do
-  describe "#parse()" do
+    topic '#parse()' do
-    before do
-      @schema = Benry::Cmdopt::Schema.new
-    end
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+      end
-    it "[!qw0ac] parses command option definition string." do
-      sc = @schema
-      tuple = sc.__send__(:parse_optdef, "-h, --help")
-      ok {tuple} == ['h', 'help', nil, false]
-      tuple = sc.__send__(:parse_optdef, "-h")
-      ok {tuple} == ['h', nil, nil, false]
-      tuple = sc.__send__(:parse_optdef, "--help")
-      ok {tuple} == [nil, 'help', nil, false]
-    end
+      spec "[!qw0ac] parses command option definition string." do
+        sc = @schema
+        tuple = sc.__send__(:parse_optdef, "-h, --help")
+        ok {tuple} == ['h', 'help', nil, nil]
+        tuple = sc.__send__(:parse_optdef, "-h")
+        ok {tuple} == ['h', nil, nil, nil]
+        tuple = sc.__send__(:parse_optdef, "--help")
+        ok {tuple} == [nil, 'help', nil, nil]
+      end
-    it "[!ae733] parses command option definition which has a required param." do
-      sc = @schema
-      tuple = sc.__send__(:parse_optdef, "-f, --file=<FILE>")
-      ok {tuple} == ['f', 'file', '<FILE>', false]
-      tuple = sc.__send__(:parse_optdef, "-f <FILE>")
-      ok {tuple} == ['f', nil, '<FILE>', false]
-      tuple = sc.__send__(:parse_optdef, "--file=<FILE>")
-      ok {tuple} == [nil, 'file', '<FILE>', false]
-    end
+      spec "[!ae733] parses command option definition which has a required param." do
+        sc = @schema
+        tuple = sc.__send__(:parse_optdef, "-f, --file=<FILE>")
+        ok {tuple} == ['f', 'file', '<FILE>', true]
+        tuple = sc.__send__(:parse_optdef, "-f <FILE>")
+        ok {tuple} == ['f', nil, '<FILE>', true]
+        tuple = sc.__send__(:parse_optdef, "--file=<FILE>")
+        ok {tuple} == [nil, 'file', '<FILE>', true]
+      end
+      spec "[!4h05c] parses command option definition which has an optional param." do
+        sc = @schema
+        tuple = sc.__send__(:parse_optdef, "-i, --indent[=<WIDTH>]")
+        ok {tuple} == ['i', 'indent', '<WIDTH>', false]
+        tuple = sc.__send__(:parse_optdef, "-i[<WIDTH>]")
+        ok {tuple} == ['i', nil, '<WIDTH>', false]
+        tuple = sc.__send__(:parse_optdef, "--indent[=<WIDTH>]")
+        ok {tuple} == [nil, 'indent', '<WIDTH>', false]
+      end
+      spec "[!b7jo3] raises SchemaError when command option definition is invalid." do
+        sc = @schema
+        pr = proc {
+          tuple = sc.__send__(:parse_optdef, "-i, --indent <WIDTH>")
+        }
+        ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                       "-i, --indent <WIDTH>: Invalid option definition (use '=--indent' instead of ' --indent').")
+      end
-    it "[!4h05c] parses command option definition which has an optional param." do
-      sc = @schema
-      tuple = sc.__send__(:parse_optdef, "-i, --indent[=<WIDTH>]")
-      ok {tuple} == ['i', 'indent', '<WIDTH>', true]
-      tuple = sc.__send__(:parse_optdef, "-i[<WIDTH>]")
-      ok {tuple} == ['i', nil, '<WIDTH>', true]
-      tuple = sc.__send__(:parse_optdef, "--indent[=<WIDTH>]")
-      ok {tuple} == [nil, 'indent', '<WIDTH>', true]
     end
-    it "[!b7jo3] raises SchemaError when command option definition is invalid." do
-      sc = @schema
-      pr = proc {
-        tuple = sc.__send__(:parse_optdef, "-i, --indent <WIDTH>")
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     "-i, --indent <WIDTH>: invalid option definition (use '=--indent' instead of ' --indent').")
+    topic '#dup()' do
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+        @schema.add(:help   , "-h" , "print help")
+      end
+      spec "[!lxb0o] copies self object." do
+        this  = @schema
+        other = @schema.dup()
+        #
+        this_items  = this.instance_variable_get(:@items)
+        other_items = other.instance_variable_get(:@items)
+        ok {this_items} != nil
+        ok {other_items} != nil
+        ok {other_items} == this_items
+        ok {other_items.object_id} != this_items.object_id
+        #
+        this.add(:silent, "-s", "silent")
+        other.add(:quiet, "-q", "quiet")
+        ok {this.option_help()}  == ("  -h       : print help\n" +
+                                     "  -s       : silent\n")
+        ok {other.option_help()} == ("  -h       : print help\n" +
+                                     "  -q       : quiet\n")
+      end
     end
-  end
+    topic '#copy_from()' do
+      before do
+        @schema1 = Benry::CmdOpt::Schema.new
+        @schema1.add(:help, "-h" , "print help")
+        @schema2 = Benry::CmdOpt::Schema.new
+        @schema2.add(:version, "-v" , "print version")
+        @schema2.add(:debug  , "-D" , "debug mode")
+      end
+      spec "[!6six3] copy schema items from others." do
+        @schema1.copy_from(@schema2)
+        tuples = @schema1.each.collect {|x| [x.key, x.optdef, x.desc] }
+        ok {tuples} == [
+          [:help   , "-h", "print help"],
+          [:version, "-v", "print version"],
+          [:debug  , "-D", "debug mode"],
+        ]
+      end
+      spec "[!vt88s] copy schema items except items specified by 'except:' kwarg." do
+        @schema1.copy_from(@schema2, except: [:debug])
+        tuples = @schema1.each.collect {|x| [x.key, x.optdef, x.desc] }
+        ok {tuples} == [
+          [:help,    "-h", "print help"],
+          [:version, "-v", "print version"],
+        ]
+      end
-  describe "#add()" do
-    before do
-      @schema = Benry::Cmdopt::Schema.new
-    end
-    it "[!7hi2d] takes command option definition string." do
-      sc = @schema
-      sc.add(:indent, "-i, --indent=<WIDTH>", "print help")
-      items = sc.instance_eval { @items }
-      ok {items.length} == 1
-      ok {items[0]}.is_a?(Benry::Cmdopt::SchemaItem)
-      ok {items[0].key} == :indent
-      ok {items[0].short} == 'i'
-      ok {items[0].long} == 'indent'
-      ok {items[0].param} == '<WIDTH>'
-      ok {items[0].optional} == false
-      ok {items[0].type} == nil
-      ok {items[0].pattern} == nil
-      ok {items[0].enum} == nil
-      ok {items[0].callback} == nil
-    end
-    it "[!p9924] option key is omittable only when long option specified." do
-      sc = @schema
-      sc.add(nil, "-m, --max-num=<N>", nil)
-      items = sc.instance_eval { @items }
-      ok {items[0].key} == :max_num
-    end
-    it "[!jtp7z] raises SchemaError when key is nil and no long option." do
-      sc = @schema
-      pr = proc { sc.add(nil, "-i <N>", nil) }
-      msg = "add(nil, \"-i <N>\"): long option required when option key (1st arg) not specified."
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError, msg)
-    end
-    it "[!97sn0] raises SchemaError when ',' is missing between short and long options." do
-      sc = @schema
-      pr = proc { sc.add(:exec, '-x --exec=ARG', "exec") }
-      msg = "add(:exec, \"-x --exec=ARG\"): missing ',' between short option and long options."
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError, msg)
-    end
-    it "[!yht0v] keeps command option definitions." do
-      sc = @schema
-      sc.add(:indent, "-i, --indent[=<WIDTH>]", "indent width",
-                      type: Integer, pattern: /\A\d+\z/, enum: ['2', '4', '8']) {|v| v.to_i }
-      items = sc.instance_eval { @items }
-      ok {items.length} == 1
-      ok {items[0]}.is_a?(Benry::Cmdopt::SchemaItem)
-      ok {items[0].key} == :indent
-      ok {items[0].short} == 'i'
-      ok {items[0].long} == 'indent'
-      ok {items[0].param} == '<WIDTH>'
-      ok {items[0].optional} == true
-      ok {items[0].type} == Integer
-      ok {items[0].pattern} == /\A\d+\z/
-      ok {items[0].enum} == ['2', '4', '8']
-      ok {items[0].callback}.is_a?(Proc)
-      ok {items[0].callback.arity} == 1
-    end
-    it "[!rhhji] raises SchemaError when key is not a Symbol." do
-      sc = @schema
-      pr = proc {
-        sc.add("-i, --indent[=<WIDTH>]", "indent width", nil)
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     'add("-i, --indent[=<WIDTH>]"): 1st arg should be a Symbol as an option key.')
-    end
-    it "[!vq6eq] raises SchemaError when help message is missing." do
-      sc = @schema
-      pr = proc {
-        begin
-          sc.add(:indent, "-i, --indent[=<WIDTH>]", type: Array)   # Ruby 2
-        rescue ArgumentError
-          sc.add(:indent, "-i, --indent[=<WIDTH>]", {type: Array}) # Ruby 3
-        end
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     'add(:indent, "-i, --indent[=<WIDTH>]"): help message required as 3rd argument.')
-    end
-    it "[!7xmr5] raises SchemaError when type is not registered." do
-      sc = @schema
-      pr = proc {
-        sc.add(:indent, "-i, --indent[=<WIDTH>]", "indent width", type: Array)
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     "Array: unregistered type.")
-    end
-    it "[!s2aaj] raises SchemaError when option has no params but type specified." do
-      sc = @schema
-      pr = proc {
-        sc.add(:indent, "-i, --indent", "indent width", type: Integer)
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     "Integer: type specified in spite of option has no params.")
-    end
-    it "[!bi2fh] raises SchemaError when pattern is not a regexp." do
-      sc = @schema
-      pr = proc {
-        sc.add(:indent, "-x, --indent[=<WIDTH>]", "indent width", pattern: '\A\d+\z')
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     '"\\\\A\\\\d+\\\\z": regexp expected.')
-    end
-    it "[!01fmt] raises SchmeaError when option has no params but pattern specified." do
-      sc = @schema
-      pr = proc {
-        sc.add(:indent, "-i, --indent", "indent width", pattern: /\A\d+\z/)
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     '/\A\d+\z/: pattern specified in spite of option has no params.')
-    end
-    it "[!melyd] raises SchmeaError when enum is not a Array nor Set." do
-      sc = @schema
-      sc.add(:indent, "-i <N>", "indent width", enum: ["2", "4", "8"])
-      sc.add(:indent, "-i <N>", "indent width", enum: Set.new(["2", "4", "8"]))
-      pr = proc {
-        sc.add(:indent, "-i <N>", "indent width", enum: "2,4,8")
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     '"2,4,8": array or set expected.')
-    end
-    it "[!xqed8] raises SchemaError when enum specified for no param option." do
-      sc = @schema
-      pr = proc {
-        sc.add(:indent, "-i", "enable indent", enum: [2, 4, 8])
-      }
-      ok {pr}.raise?(Benry::Cmdopt::SchemaError,
-                     "[2, 4, 8]: enum specified in spite of option has no params.")
     end
-  end
+    topic '#add()' do
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+      end
+      spec "[!7hi2d] takes command option definition string." do
+        sc = @schema
+        sc.add(:indent, "-i, --indent=<WIDTH>", "print help")
+        items = sc.instance_eval { @items }
+        ok {items.length} == 1
+        ok {items[0]}.is_a?(Benry::CmdOpt::SchemaItem)
+        ok {items[0].key} == :indent
+        ok {items[0].short} == 'i'
+        ok {items[0].long} == 'indent'
+        ok {items[0].param} == '<WIDTH>'
+        ok {items[0].required?} == true
+        ok {items[0].type} == nil
+        ok {items[0].rexp} == nil
+        ok {items[0].enum} == nil
+        ok {items[0].callback} == nil
+      end
+      spec "[!p9924] option key is omittable only when long option specified." do
+        sc = @schema
+        sc.add(nil, "-m, --max-num=<N>", nil)
+        items = sc.instance_eval { @items }
+        ok {items[0].key} == :max_num
+      end
+      spec "[!jtp7z] raises SchemaError when key is nil and no long option." do
+        sc = @schema
+        pr = proc { sc.add(nil, "-i <N>", nil) }
+        msg = "add(nil, \"-i <N>\"): Long option required when option key (1st arg) not specified."
+        ok {pr}.raise?(Benry::CmdOpt::SchemaError, msg)
+      end
+      spec "[!rpl98] when long option is 'foo-bar' then key name is ':foo_bar'." do
+        sc = @schema
+        sc.add(nil, "--foo-bar", nil)
+        items = sc.instance_eval { @items }
+        ok {items[0].key} == :foo_bar
+      end
+      spec "[!97sn0] raises SchemaError when ',' is missing between short and long options." do
+        sc = @schema
+        pr = proc { sc.add(:exec, '-x --exec=ARG', "exec") }
+        msg = "add(:exec, \"-x --exec=ARG\"): Missing ',' between short option and long options."
+        ok {pr}.raise?(Benry::CmdOpt::SchemaError, msg)
+      end
+      spec "[!yht0v] keeps command option definitions." do
+        sc = @schema
+        sc.add(:indent, "-i, --indent[=<WIDTH>]", "indent width",
+                        range: (1..2), value: 8, detail: "(description)", tag: :ab,
+                        type: Integer, rexp: /\A\d+\z/, enum: [2, 4, 8]) {|v| v.to_i }
+        items = sc.instance_eval { @items }
+        ok {items.length} == 1
+        ok {items[0]}.is_a?(Benry::CmdOpt::SchemaItem)
+        ok {items[0].key} == :indent
+        ok {items[0].short} == 'i'
+        ok {items[0].long} == 'indent'
+        ok {items[0].param} == '<WIDTH>'
+        ok {items[0].required?} == false
+        ok {items[0].type} == Integer
+        ok {items[0].rexp} == /\A\d+\z/
+        ok {items[0].enum} == [2, 4, 8]
+        ok {items[0].range} == (1..2)
+        ok {items[0].detail} == "(description)"
+        ok {items[0].value} == 8
+        ok {items[0].tag} == :ab
+        ok {items[0].callback}.is_a?(Proc)
+        ok {items[0].callback.arity} == 1
+      end
+      spec "[!kuhf9] type, rexp, enum, and range are can be passed as positional args as well as keyword args." do
+        sc = @schema
+        sc.add(:key, "--optdef=xx", "desc", Integer, /\A\d+\z/, [2,4,8], (2..8))
+        item = sc.each.first
+        ok {item.type} == Integer
+        ok {item.rexp} == /\A\d+\z/
+        ok {item.enum} == [2,4,8]
+        ok {item.range} == (2..8)
+      end
+      spec "[!e3emy] raises error when positional arg is not one of class, regexp, array, nor range." do
+        sc = @schema
+        pr = proc { sc.add(:key, "--optdef=xx", "desc", "value") }
+        ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                       '"value": Expected one of class, regexp, array or range, but got String.')
+      end
+      spec "[!rhhji] raises SchemaError when key is not a Symbol." do
+        sc = @schema
+        pr = proc {
+          sc.add("-i, --indent[=<WIDTH>]", "indent width", nil)
+        }
+        ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                       'add("-i, --indent[=<WIDTH>]", "indent width"): The first arg should be a Symbol as an option key.')
+      end
+      spec "[!vq6eq] raises SchemaError when help message is missing." do
+        sc = @schema
+        pr = proc {
+          begin
+            sc.add(:indent, "-i, --indent[=<WIDTH>]", type: Array)   # Ruby 2
+          rescue ArgumentError
+            sc.add(:indent, "-i, --indent[=<WIDTH>]", {type: Array}) # Ruby 3
+          end
+        }
+        ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                       'add(:indent, "-i, --indent[=<WIDTH>]"): Help message required as 3rd argument.')
+      end
-  describe '#option_help()' do
-    before do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help   , "-h, --help"            , "show help message.")
-      sc.add(:version, "    --version"         , "print version")
-      sc.add(:file   , "-f, --file=<FILE>"     , "filename")
-      sc.add(:indent , "-i, --indent[=<WIDTH>]", "enable indent", type: Integer)
-      sc.add(:debug  , "-d, --debug"           , nil)
-      @schema = sc
     end
-    it "[!0aq0i] can take integer as width." do
-      help = @schema.option_help(41)
-      ok {help} == <<END
+    topic '#option_help()' do
+      before do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help   , "-h, --help"            , "show help message.")
+        sc.add(:version, "    --version"         , "print version")
+        sc.add(:file   , "-f, --file=<FILE>"     , "filename")
+        sc.add(:indent , "-i, --indent[=<WIDTH>]", "enable indent", type: Integer)
+        sc.add(:debug  , "-d, --debug"           , nil)
+        @schema = sc
+      end
+      spec "[!0aq0i] can take integer as width." do
+        helpmsg = @schema.option_help(41)
+        ok {helpmsg} == <<END
   -h, --help                                : show help message.
       --version                             : print version
   -f, --file=<FILE>                         : filename
   -i, --indent[=<WIDTH>]                    : enable indent
 END
-      s = help.each_line.first.split(':')[0]
-      ok {s.length} == 41+3
-    end
+        s = helpmsg.each_line.first.split(':')[0]
+        ok {s.length} == 41+3
+      end
-    it "[!pcsah] can take format string." do
-      help = @schema.option_help("%-42s: %s")
-      ok {help} == <<END
+      spec "[!pcsah] can take format string." do
+        helpmsg = @schema.option_help("%-42s: %s")
+        ok {helpmsg} == <<END
 -h, --help                                : show help message.
     --version                             : print version
 -f, --file=<FILE>                         : filename
 -i, --indent[=<WIDTH>]                    : enable indent
 END
-      s = help.each_line.first.split(':')[0]
-      ok {s.length} == 42+0
-    end
+        s = helpmsg.each_line.first.split(':')[0]
+        ok {s.length} == 42+0
+      end
-    it "[!dndpd] detects option width automatically when nothing specified." do
-      help = @schema.option_help()
-      ok {help} == <<END
+      spec "[!dndpd] detects option width automatically when nothing specified." do
+        helpmsg = @schema.option_help()
+        ok {helpmsg} == <<END
   -h, --help             : show help message.
       --version          : print version
   -f, --file=<FILE>      : filename
   -i, --indent[=<WIDTH>] : enable indent
 END
-      s = help.each_line.to_a.last.split(':')[0]
-      ok {s.length} == 25
-    end
+        s = helpmsg.each_line.to_a.last.split(':')[0]
+        ok {s.length} == 25
+      end
-    it "[!v7z4x] skips option help if help message is not specified." do
-      help = @schema.option_help()
-      ok {help} !~ /debug/
-    end
+      spec "[!v7z4x] skips option help if help message is not specified." do
+        helpmsg = @schema.option_help()
+        ok {helpmsg} !~ /debug/
+      end
-    it "[!to1th] includes all option help when `all` is true." do
-      help = @schema.option_help(nil, all: true)
-      ok {help} =~ /debug/
-      ok {help} == <<END
+      spec "[!to1th] includes all option help when `all` is true." do
+        helpmsg = @schema.option_help(nil, all: true)
+        ok {helpmsg} =~ /debug/
+        ok {helpmsg} == <<END
   -h, --help             : show help message.
       --version          : print version
   -f, --file=<FILE>      : filename
   -i, --indent[=<WIDTH>] : enable indent
   -d, --debug            :
 END
-    end
+      end
-    it "[!848rm] supports multi-lines help message." do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:mode, "-m, --mode=<MODE>", <<END)
-output mode
+      spec "[!848rm] supports multi-lines help message." do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:mode, "-m, --mode=<MODE>", "output mode",
+                      detail: <<"END")
   v, verbose: print many output
   q, quiet:   print litte output
   c, compact: print summary output
 END
-      actual = sc.option_help()
-      expected = <<END
+        actual = sc.option_help()
+        expected = <<END
   -m, --mode=<MODE>    : output mode
                            v, verbose: print many output
                            q, quiet:   print litte output
                            c, compact: print summary output
 END
-      ok {actual} == expected
+        ok {actual} == expected
+      end
+      spec "[!a4qe4] option should not be hidden if description is empty string." do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:debug , "-D", nil)       # hidden
+        sc.add(:_trace, "-T", "trace")   # hidden
+        sc.add(:what  , "-W", "")        # NOT hidden!
+        ok {sc.option_help()} == <<END
+  -W             :
+END
+      end
     end
-  end
+    topic '#_default_format()' do
-  describe '#_default_format()' do
+      before do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help   , "-h, --help"            , "show help message.")
+        sc.add(:version, "    --version"         , "print version")
+        sc.add(:file   , "-f, --file=<FILE>"     , "filename")
+        sc.add(:indent , "-i, --indent[=<WIDTH>]", "enable indent", type: Integer)
+        sc.add(:debug  , "-d, --debug"           , nil)
+        @schema = sc
+      end
-    before do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help   , "-h, --help"            , "show help message.")
-      sc.add(:version, "    --version"         , "print version")
-      sc.add(:file   , "-f, --file=<FILE>"     , "filename")
-      sc.add(:indent , "-i, --indent[=<WIDTH>]", "enable indent", type: Integer)
-      sc.add(:debug  , "-d, --debug"           , nil)
-      @schema = sc
-    end
+      spec "[!kkh9t] returns format string." do
+        ret = @schema.__send__(:_default_format)
+        ok {ret} == "  %-22s : %s"
+      end
-    it "[!kkh9t] returns format string." do
-      ret = @schema.__send__(:_default_format)
-      ok {ret} == "  %-22s : %s"
-    end
+      spec "[!hr45y] detects preffered option width." do
+        ret = @schema.__send__(:_default_format, 10, 20)
+        ok {ret} == "  %-20s : %s"
+        ret = @schema.__send__(:_default_format, 30, 40)
+        ok {ret} == "  %-30s : %s"
+        ret = @schema.__send__(:_default_format, 10, 40)
+        ok {ret} == "  %-22s : %s"
+      end
-    it "[!hr45y] detects preffered option width." do
-      ret = @schema.__send__(:_default_format, 10, 20)
-      ok {ret} == "  %-20s : %s"
-      ret = @schema.__send__(:_default_format, 30, 40)
-      ok {ret} == "  %-30s : %s"
-      ret = @schema.__send__(:_default_format, 10, 40)
-      ok {ret} == "  %-22s : %s"
-    end
+      spec "[!bmr7d] changes min_with according to options." do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help   , '-h', "help")
+        sc.add(:version, '-v', "version")
+        ok {sc.__send__(:_default_format, nil, 40)} == "  %-8s : %s"
+        #
+        sc.add(:file   , '-f <FILE>', "filename")
+        ok {sc.__send__(:_default_format, nil, 40)} == "  %-14s : %s"
+        #
+        sc.add(:force  , '--force', "forcedly")
+        ok {sc.__send__(:_default_format, nil, 40)} == "  %-14s : %s"
+        #
+        sc.add(:mode   , '-m, --mode=<MODE>', "verbose/quiet")
+        ok {sc.__send__(:_default_format, nil, 40)} == "  %-20s : %s"
+      end
-    it "[!bmr7d] changes min_with according to options." do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help   , '-h', "help")
-      sc.add(:version, '-v', "version")
-      ok {sc.__send__(:_default_format, nil, 40)} == "  %-8s : %s"
-      #
-      sc.add(:file   , '-f <FILE>', "filename")
-      ok {sc.__send__(:_default_format, nil, 40)} == "  %-14s : %s"
-      #
-      sc.add(:force  , '--force', "forcedly")
-      ok {sc.__send__(:_default_format, nil, 40)} == "  %-14s : %s"
-      #
-      sc.add(:mode   , '-m, --mode=<MODE>', "verbose/quiet")
-      ok {sc.__send__(:_default_format, nil, 40)} == "  %-20s : %s"
     end
-  end
+    topic '#_preferred_option_width()' do
-  describe '#_preferred_option_width()' do
+      spec "[!kl91t] shorten option help min width when only single options which take no arg." do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help   , '-h', "help")
+        sc.add(:version, '-v', "version")
+        ok {sc.__send__(:_preferred_option_width)} == 8
+      end
-    it "[!kl91t] shorten option help min width when only single options which take no arg." do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help   , '-h', "help")
-      sc.add(:version, '-v', "version")
-      ok {sc.__send__(:_preferred_option_width)} == 8
-    end
+      spec "[!0koqb] widen option help min width when any option takes an arg." do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help   , '-h', "help")
+        sc.add(:indent , '-i[<N>]', "indent")
+        ok {sc.__send__(:_preferred_option_width)} == 14
+      end
-    it "[!0koqb] widen option help min width when any option takes an arg." do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help   , '-h', "help")
-      sc.add(:indent , '-i[<N>]', "indent")
-      ok {sc.__send__(:_preferred_option_width)} == 14
-    end
+      spec "[!kl91t] widen option help min width when long option exists." do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help   , '-h', "help")
+        sc.add(:version, '-v, --version', "version")
+        ok {sc.__send__(:_preferred_option_width)} == 14
+        #
+        sc.add(:file, '--file=<FILE>', "filename")
+        ok {sc.__send__(:_preferred_option_width)} == 20
+      end
-    it "[!kl91t] widen option help min width when long option exists." do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help   , '-h', "help")
-      sc.add(:version, '-v, --version', "version")
-      ok {sc.__send__(:_preferred_option_width)} == 14
-      #
-      sc.add(:file, '--file=<FILE>', "filename")
-      ok {sc.__send__(:_preferred_option_width)} == 20
     end
-  end
+    topic '#to_s()' do
-  describe '#each_option_help()' do
+      spec "[!rrapd] '#to_s' is an alias to '#option_help()'." do
+        schema = Benry::CmdOpt::Schema.new
+        schema.add(:help   , "-h, --help"        , "show help message")
+        schema.add(:version, "    --version"     , "print version")
+        ok {schema.to_s} == schema.option_help()
+      end
-    before do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:help, "-h, --help", "show help message")
-      sc.add(:version, "    --version", "print version")
-      @schema = sc
     end
-    it "[!4b911] yields each optin definition str and help message." do
-      sc = @schema
-      arr = []
-      sc.each_option_help do |opt, help|
-        arr << [opt, help]
+    topic '#each_option_and_desc()' do
+      before do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:help, "-h, --help", "show help message")
+        sc.add(:version, "    --version", "print version")
+        sc.add(:debug  , "-d, --debug"  , nil)            # hidden
+        sc.add(:_DEBUG , "-D, --DEBUG"  , "debug mode")   # hidden
+        @schema = sc
+      end
+      spec "[!4b911] yields each optin definition str and help message." do
+        pairs = []
+        @schema.each_option_and_desc {|opt, desc| pairs << [opt, desc] }
+        ok {pairs} == [
+          ["-h, --help"    , "show help message"],  # not hiddden
+          ["    --version" , "print version"],      # not hidden
+        ]
+      end
+      spec "[!cl8zy] when 'all' flag is false, not yield hidden items." do
+        pairs = []
+        @schema.each_option_and_desc(all: false) {|opt, desc| pairs << [opt, desc] }
+        ok {pairs} == [
+          ["-h, --help"    , "show help message"],  # not hiddden
+          ["    --version" , "print version"],      # not hidden
+        ]
+      end
+      spec "[!tc4bk] when 'all' flag is true, yields even hidden items." do
+        pairs = []
+        @schema.each_option_and_desc(all: true) {|opt, desc| pairs << [opt, desc] }
+        ok {pairs} == [
+          ["-h, --help"    , "show help message"],  # not hiddden
+          ["    --version" , "print version"],      # not hidden
+          ["-d, --debug"   , nil],                  # hidden
+          ["-D, --DEBUG"   , "debug mode"],         # hidden
+        ]
+      end
+      spec "[!03sux] returns enumerator object if block not given." do
+        ## when 'all: true'
+        xs = @schema.each_option_and_desc(all: true)
+        ok {xs}.is_a?(Enumerator)
+        ok {xs.collect {|x, _| x }} == ["-h, --help", "    --version", "-d, --debug", "-D, --DEBUG"]
+        ## when 'all: false'
+        xs = @schema.each_option_and_desc(all: false)
+        ok {xs}.is_a?(Enumerator)
+        ok {xs.collect {|x, _| x }} == ["-h, --help", "    --version"]
+      end
+      spec "[!zbxyv] returns self." do
+        ret = @schema.each_option_and_desc { nil }
+        ok {ret}.same? @schema
       end
-      ok {arr} == [
-        ["-h, --help", "show help message"],
-        ["    --version", "print version"],
-      ]
-    end
-    it "[!zbxyv] returns self." do
-      sc = @schema
-      ret = sc.each_option_help { nil }
-      ok {ret}.same? sc
     end
-  end
+    topic '#each()' do
-  describe '#find_short_option()' do
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+        @schema.add(:help   , "-h, --help"   , "help message")
+        @schema.add(:version, "    --version", "print version")
+      end
+      spec "[!y4k1c] yields each option item." do
+        items = []
+        @schema.each {|x| items << x }
+        ok {items.length} == 2
+        ok {items[0]}.is_a?(Benry::CmdOpt::SchemaItem)
+        ok {items[1]}.is_a?(Benry::CmdOpt::SchemaItem)
+        ok {items[0].key} == :help
+        ok {items[1].key} == :version
+        keys = @schema.each.collect {|x| x.key }
+        ok {keys} == [:help, :version]
+      end
-    before do
-      @schema = new_sample_schema()
     end
-    it "[!b4js1] returns option definition matched to short name." do
-      x = @schema.find_short_option('h')
-      ok {x.key} == :help
-      x = @schema.find_short_option('f')
-      ok {x.key} == :file
-      x = @schema.find_short_option('i')
-      ok {x.key} == :indent
+    topic '#empty?()' do
+      spec "[!um8am] returns false if any item exists, else returns true." do
+        schema = Benry::CmdOpt::Schema.new
+        ok {schema.empty?()} == true
+        schema.add(:help   , "-h, --help"   , "help message")
+        ok {schema.empty?()} == false
+      end
+      spec "[!icvm1] ignores hidden items if 'all: false' kwarg specified." do
+        schema = Benry::CmdOpt::Schema.new
+        schema.add(:debug , "-D", nil)
+        schema.add(:_trace, "-T", "trace")
+        ok {schema.empty?()} == false
+        ok {schema.empty?(all: true)} == false
+        ok {schema.empty?(all: false)} == true
+      end
     end
-    it "[!s4d1y] returns nil when nothing found." do
-      ok {@schema.find_short_option('v')} == nil
+    topic '#get()' do
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+        @schema.add(:help   , "-h, --help"   , "help message")
+        @schema.add(:version, "    --version", "print version")
+      end
+      spec "[!3wjfp] finds option item object by key." do
+        item = @schema.get(:help)
+        ok {item.key} == :help
+        item = @schema.get(:version)
+        ok {item.key} == :version
+      end
+      spec "[!0spll] returns nil if key not found." do
+        ok {@schema.get(:debug)} == nil
+      end
     end
-  end
+    topic '#delete()' do
-  describe '#find_long_option()' do
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+        @schema.add(:help   , "-h, --help"   , "help message")
+        @schema.add(:version, "    --version", "print version")
+      end
+      spec "[!l86rb] deletes option item corresponding to key." do
+        keys = @schema.each.collect {|x| x.key }
+        ok {keys} == [:help, :version]
+        @schema.delete(:help)
+        keys = @schema.each.collect {|x| x.key }
+        ok {keys} == [:version]
+      end
+      spec "[!rq0aa] returns deleted item." do
+        item = @schema.delete(:version)
+        ok {item} != nil
+        ok {item.key} == :version
+      end
-    before do
-      @schema = new_sample_schema()
     end
-    it "[!atmf9] returns option definition matched to long name." do
-      x = @schema.find_long_option('help')
-      ok {x.key} == :help
-      x = @schema.find_long_option('file')
-      ok {x.key} == :file
-      x = @schema.find_long_option('indent')
-      ok {x.key} == :indent
+    topic '#find_short_option()' do
+      before do
+        @schema = new_sample_schema()
+      end
+      spec "[!b4js1] returns option definition matched to short name." do
+        x = @schema.find_short_option('h')
+        ok {x.key} == :help
+        x = @schema.find_short_option('f')
+        ok {x.key} == :file
+        x = @schema.find_short_option('i')
+        ok {x.key} == :indent
+      end
+      spec "[!s4d1y] returns nil when nothing found." do
+        ok {@schema.find_short_option('v')} == nil
+      end
     end
-    it "[!6haoo] returns nil when nothing found." do
-      ok {@schema.find_long_option('lib')} == nil
+    topic '#find_long_option()' do
+      before do
+        @schema = new_sample_schema()
+      end
+      spec "[!atmf9] returns option definition matched to long name." do
+        x = @schema.find_long_option('help')
+        ok {x.key} == :help
+        x = @schema.find_long_option('file')
+        ok {x.key} == :file
+        x = @schema.find_long_option('indent')
+        ok {x.key} == :indent
+      end
+      spec "[!6haoo] returns nil when nothing found." do
+        ok {@schema.find_long_option('lib')} == nil
+      end
     end
   end
-end
+  topic Benry::CmdOpt::SchemaItem do
+    ITEMS = [
+      Benry::CmdOpt::SchemaItem.new(:help, "-h, --help", "help msg",
+                                    "h", "help", nil, nil),
+      Benry::CmdOpt::SchemaItem.new(:file, "-f, --file=<file>", "filename",
+                                    "f", "file", "<file>", true),
+      Benry::CmdOpt::SchemaItem.new(:indent, "-i, --indent[=<N>]", "indent width",
+                                    "i", "indent", "<N>", false),
+    ]
-class Benry::Cmdopt::SchemaItem::Test < MiniTest::Test
+    topic '#initialize()' do
-  describe '#validate_and_convert()' do
+      before do
+        @schema = Benry::CmdOpt::Schema.new
+      end
-    def new_item(key, optstr, short, long, param, help,
-                 optional: nil, type: nil, pattern: nil, enum: nil, &callback)
-      return Benry::Cmdopt::SchemaItem.new(key, optstr, short, long, param, help,
-                 optional: optional, type: type, pattern: pattern, enum: enum, &callback)
-    end
+      spec "[!nn4cp] freezes enum object." do
+        item = Benry::CmdOpt::SchemaItem.new(:foo, "--foo", "desc", nil, "foo", "<val>",
+                                             true, enum: ["x", "y", "z"])
+        ok {item.enum} == ["x", "y", "z"]
+        ok {item.enum}.frozen?
+      end
-    it "[!h0s0o] raises RuntimeError when value not matched to pattern." do
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", "indent width", pattern: /\A\d+\z/)
-      optdict = {}
-      pr = proc { x.validate_and_convert("abc", optdict) }
-      ok {pr}.raise?(RuntimeError, "pattern unmatched.")
-    end
+      case_when "[!wy2iv] when 'type:' specified..." do
-    it "[!5jrdf] raises RuntimeError when value not in enum." do
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", "indent width", enum: ['2', '4', '8'])
-      optdict = {}
-      pr = proc { x.validate_and_convert("10", optdict) }
-      ok {pr}.raise?(RuntimeError, "expected one of 2/4/8.")
-    end
+        spec "[!7xmr5] raises SchemaError when type is not registered." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i, --indent[=<WIDTH>]", "indent width", type: Array)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "Array: Unregistered type.")
+        end
-    it "[!j4fuz] calls type-specific callback when type specified." do
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", "indent width", type: Integer)
-      optdict = {}
-      pr = proc { x.validate_and_convert("abc", optdict) }
-      ok {pr}.raise?(RuntimeError, "integer expected.")
-    end
+        spec "[!s2aaj] raises SchemaError when option has no params but type specified." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i, --indent", "indent width", type: Integer)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "Integer: Type specified in spite of option has no params.")
+        end
-    it "[!jn9z3] calls callback when callback specified." do
-      called = false
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", "indent width") {|va|
-        called = true
-      }
-      optdict = {}
-      x.validate_and_convert("abc", optdict)
-      ok {called} == true
-    end
+        spec "[!sz8x2] not raise error when no params but value specified." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i, --indent", "indent width", type: Integer, value: 0)
+          }
+          ok {pr}.NOT.raise?(Exception)
+        end
-    it "[!iqalh] calls callback with different number of args according to arity." do
-      args1 = nil
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", nil) {|val|
-        args1 = val
-      }
-      optdict = {}
-      x.validate_and_convert("123", optdict)
-      ok {args1} == "123"
-      #
-      args2 = nil
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", nil) {|optdict, key, val|
-        args2 = [optdict, key, val]
-      }
-      optdict = {}
-      x.validate_and_convert("123", optdict)
-      ok {args2} == [optdict, :indent, "123"]
-    end
+        spec "[!70ogf] not raise error when no params but TrueClass specified." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i, --indent", "indent width", type: TrueClass)
+          }
+          ok {pr}.NOT.raise?(Exception)
+        end
-    it "[!x066l] returns new value." do
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", nil, type: Integer)
-      ok {x.validate_and_convert("123", {})} == 123
-      #
-      x = new_item(:indent, "", "i", "indent", "<WIDTH>", nil, type: Integer) {|val|
-        val * 2
-      }
-      ok {x.validate_and_convert("123", {})} == 246
-    end
+      end
-  end
+      case_when "[!6y8s2] when 'rexp:' specified..." do
-end
+        spec "[!bi2fh] raises SchemaError when pattern is not a regexp." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-x, --indent[=<WIDTH>]", "indent width", rexp: '\A\d+\z')
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         '"\\\\A\\\\d+\\\\z": Regexp pattern expected.')
+        end
+        spec "[!01fmt] raises SchmeaError when option has no params but pattern specified." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i, --indent", "indent width", rexp: /\A\d+\z/)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         '/\A\d+\z/: Regexp pattern specified in spite of option has no params.')
+        end
+      end
-class Benry::Cmdopt::Parser::Test < MiniTest::Test
+      case_when "[!5nrvq] when 'enum:' specified..." do
+        spec "[!melyd] raises SchemaError when enum is not an Array nor Set." do
+          sc = @schema
+          sc.add(:indent, "-i <N>", "indent width", enum: ["2", "4", "8"])
+          sc.add(:indent, "-i <N>", "indent width", enum: Set.new(["2", "4", "8"]))
+          pr = proc {
+            sc.add(:indent, "-i <N>", "indent width", enum: "2,4,8")
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         '"2,4,8": Array or set expected.')
+        end
+        spec "[!xqed8] raises SchemaError when enum specified for no param option." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i", "enable indent", enum: [2, 4, 8])
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "[2, 4, 8]: Enum specified in spite of option has no params.")
+        end
-  describe '#parse_options()' do
+        spec "[!zuthh] raises SchemaError when enum element value is not instance of type class." do
+          sc = @schema
+          pr = proc {
+            sc.add(:indent, "-i <N>", "enable indent", type: Integer, enum: ['2', '4', '8'])
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         '["2", "4", "8"]: Enum element value should be instance of Integer, but "2" is not.')
+        end
-    before do
-      @parser = Benry::Cmdopt::Parser.new(new_sample_schema())
-    end
+      end
-    it "[!3wmsy] returns command option values as a dict." do
-      argv = ["-h", "--version"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true, version: true}
-    end
+      case_when "[!hk4nw] when 'range:' specified..." do
-    it "[!uh7j8] parses long options." do
-      argv = ["--help", "--file=foo.png", "--indent=10"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true, file: "foo.png", indent: 10}
-    end
+        spec "[!z20ky] raises SchemaError when range is not a Range object." do
+          pr = proc {
+            @schema.add(:indent, "-i <N>", "indent", type: Integer, range: [1,8])
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "[1, 8]: Range object expected.")
+        end
-    it "[!nwnjc] parses short options." do
-      argv = ["-h", "-f", "foo.png", "-i10"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true, file: "foo.png", indent: 10}
-    end
+        spec "[!gp025] raises SchemaError when range specified with `type: TrueClass`." do
+          pr = proc {
+            @schema.add(:indent, "-i <N>", "indent", type: TrueClass, range: 0..1)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "0..1: Range is not available with `type: TrueClass`.")
+        end
-    it "[!y04um] skips rest options when '--' found in argv." do
-      argv = ["-h", "--", "-f", "foo.png", "-i10"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true}
-      ok {argv} == ["-f", "foo.png", "-i10"]
-    end
+        spec "[!7njd5] range beginning/end value should be expected type." do
+          pr = proc {
+            @schema.add(:indent, "-i <N>", "indent", range: (1..8))
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "1..8: Range value should be String, but not.")
+          pr = proc {
+            @schema.add(:indent, "-i <N>", "indent", type: Date, range: (1..8))
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "1..8: Range value should be Date, but not.")
+        end
+        spec "[!uymig] range object can be endless." do
+          begin
+            range1 = eval "(1..)"    # Ruby >= 2.6
+            range2 = eval "(..3)"    # Ruby >= 2.6
+          rescue SyntaxError
+            range1 = nil             # Ruby < 2.6
+            range2 = nil             # Ruby < 2.6
+          end
+          if range1
+            pr = proc {
+              @schema.add(:indent1, "-i <N>", "indent", type: Integer, range: range1)
+              @schema.add(:indent2, "-j <N>", "indent", type: Integer, range: range2)
+            }
+            pr.call
+            ok {pr}.NOT.raise?(Exception)
+          end
+        end
-    it "[!qpuxh] handles only OptionError when block given." do
-      errmsg = nil
-      errcls = nil
-      @parser.parse(["-ix"]) {|err|
-        errmsg = err.message
-        errcls = err.class
-      }
-      ok {errmsg} == "-ix: integer expected."
-      ok {errcls} == Benry::Cmdopt::OptionError
-      #
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:file, "--file=<FILE>", "file") do |val|
-        File.open(val) {|f| f.read }
       end
-      parser = Benry::Cmdopt::Parser.new(sc)
-      pr = proc { parser.parse(["--file=/foo/bar/baz.png"]) }
-      ok {pr}.raise?(Errno::ENOENT, /No such file or directory/)
-    end
-    it "[!dhpw1] returns nil when OptionError handled." do
-      ret = @parser.parse(["-dx"]) {|err| 1 }
-      ok {ret} == nil
-    end
+      case_when "[!a0g52] when 'value:' specified..." do
-  end
+        spec "[!435t6] raises SchemaError when 'value:' is specified on argument-required option." do
+          sc = @schema
+          pr = proc {
+            sc.add(:flag, "--flag=<on|off>", "flag", type: TrueClass, value: true)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "true: 'value:' is meaningless when option has required argument (hint: change to optional argument instead).")
+        end
+        spec "[!6vwqv] raises SchemaError when type is TrueClass but value is not true nor false." do
+          sc = @schema
+          pr = proc {
+            sc.add(:flag, "--flag[=<on|off>]", "flag", type: TrueClass, value: 0)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "0: Value should be true or false when `type: TrueClass` specified.")
+        end
-  describe '#parse_long_option()' do
+        spec "[!c6i2o] raises SchemaError when value is not a kind of type." do
+          sc = @schema
+          pr = proc {
+            sc.add(:flag, "--flag[=<on|off>]", "flag", type: Integer, value: false)
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "Type mismatched between `type: Integer` and `value: false`.")
+        end
-    before do
-      @parser = Benry::Cmdopt::Parser.new(new_sample_schema())
-    end
+        spec "[!lnhp6] not raise error when type is not specified." do
+          sc = @schema
+          pr = proc {
+            sc.add(:flag, "--flag[=<on|off>]", "flag", value: false)
+          }
+          ok {pr}.NOT.raise?(Exception)
+        end
-    it "[!3i994] raises OptionError when invalid long option format." do
-      argv = ["--f/o/o"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--f/o/o: invalid long option.")
-    end
+        spec "[!6xb8o] value should be included in enum values." do
+          sc = @schema
+          pr = proc {
+            sc.add(:lang, "--lang[=<en|fr|it>]", "language", enum: ["en", "fr", "it"], value: "ja")
+          }
+          ok {pr}.raise?(Benry::CmdOpt::SchemaError,
+                         "ja: Value should be included in enum values, but not.")
+        end
-    it "[!er7h4] raises OptionError when unknown long option." do
-      argv = ["--foo"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--foo: unknown long option.")
-    end
+      end
-    it "[!2jd9w] raises OptionError when no arguments specified for arg required long option." do
-      argv = ["--file"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--file: argument required.")
     end
-    it "[!qyq8n] raises optionError when an argument specified for no arg long option." do
-      argv = ["--version=1.0.0"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--version=1.0.0: unexpected argument.")
-    end
-    it "[!o596x] validates argument value." do
-      argv = ["--indent=abc"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--indent=abc: integer expected.")
-      #
-      argv = ["--path=/foo/bar"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--path=/foo/bar: directory not exist.")
+    topic '#required?' do
+      spec "[!svxny] returns nil if option takes no arguments." do
+        item, _, _ = ITEMS
+        ok {item.required?} == nil
+      end
+      spec "[!togcx] returns true if argument is required." do
+        _, item, _ = ITEMS
+        ok {item.required?} == true
+      end
+      spec "[!uwbgc] returns false if argument is optional." do
+        _, _, item = ITEMS
+        ok {item.required?} == false
+      end
     end
-  end
+    topic '#arg_requireness()' do
-  describe '#parse_short_option()' do
+      spec "[!kmo28] returns :none if option takes no arguments." do
+        item, _, _ = ITEMS
+        ok {item.arg_requireness()} == :none
+      end
-    before do
-      @parser = Benry::Cmdopt::Parser.new(new_sample_schema())
-    end
+      spec "[!s8gxl] returns :required if argument is required." do
+        _, item, _ = ITEMS
+        ok {item.arg_requireness()} == :required
+      end
-    it "[!4eh49] raises OptionError when unknown short option specified." do
-      argv = ["-hxf", "foo.png"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "-x: unknown option.")
-    end
+      spec "[!owpba] returns :optional if argument is optional." do
+        _, _, item = ITEMS
+        ok {item.arg_requireness()} == :optional
+      end
-    it "[!utdbf] raises OptionError when argument required but not specified." do
-      argv = ["-hf"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "-f: argument required.")
     end
-    it "[!f63hf] short option arg can be specified without space separator." do
-      argv = ["-hfabc.png", "xx"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true, file: "abc.png"}
-      ok {argv} == ["xx"]
-    end
-    it "[!yjq6b] optional arg should be specified without space separator." do
-      argv = ["-hi123", "xx"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true, indent: 123}
-      ok {argv} == ['xx']
-    end
+    topic '#hidden?()' do
-    it "[!wape4] otpional arg can be omit." do
-      argv = ["-hi", "xx"]
-      d = @parser.parse(argv)
-      ok {d} == {help: true, indent: true}
-      ok {argv} == ['xx']
-    end
+      spec "[!h0uxs] returns true if desc is nil." do
+        desc = nil
+        item = Benry::CmdOpt::SchemaItem.new(:debug, "-D", desc, "D", nil, nil, nil)
+        ok {item.hidden?} == true
+      end
+      spec "[!su00g] returns true if key starts with '_'." do
+        desc = "debug mode"
+        item = Benry::CmdOpt::SchemaItem.new(:_debug, "-D", desc, "D", nil, nil, nil)
+        ok {item.hidden?} == true
+      end
+      spec "[!28vzx] returns false if else." do
+        desc = "debug mode"
+        item = Benry::CmdOpt::SchemaItem.new(:debug, "-D", desc, "D", nil, nil, nil)
+        ok {item.hidden?} == false
+      end
-    it "[!yu0kc] validates short option argument." do
-      argv = ["-iaaa"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "-iaaa: integer expected.")
-      #
-      argv = ["-I", "/foo/bar"]
-      pr = proc { @parser.parse(argv) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "-I /foo/bar: directory not exist.")
     end
-  end
+    topic '#validate_and_convert()' do
+      def new_item(key, optstr, desc, short, long, param, required,
+                   type: nil, rexp: nil, enum: nil, range: nil, value: nil, &callback)
+        return Benry::CmdOpt::SchemaItem.new(key, optstr, desc, short, long, param, required,
+                   type: type, rexp: rexp, enum: enum, range: range, value: value, &callback)
+      end
+      spec "[!h0s0o] raises RuntimeError when value not matched to pattern." do
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false, rexp: /\A\d+\z/)
+        optdict = {}
+        pr = proc { x.validate_and_convert("abc", optdict) }
+        ok {pr}.raise?(RuntimeError, "Pattern unmatched.")
+      end
+      spec "[!5jrdf] raises RuntimeError when value not in enum." do
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false, enum: ['2', '4', '8'])
+        optdict = {}
+        pr = proc { x.validate_and_convert("10", optdict) }
+        ok {pr}.raise?(RuntimeError, "Expected one of 2/4/8.")
+      end
+      spec "[!5falp] raise RuntimeError when value not in range." do
+        x = new_item(:indent, "-i[=<N>]", "indent", "i", nil, "<N>", false,
+                     type: Integer, range: 2..8)
+        optdict = {}
+        pr = proc { x.validate_and_convert("1", optdict) }
+        ok {pr}.raise?(RuntimeError, "Too small (min: 2)")
+        pr = proc { x.validate_and_convert("9", optdict) }
+        ok {pr}.raise?(RuntimeError, "Too large (max: 8)")
+        ## when min==0
+        x = new_item(:indent, "-i[=<N>]", "indent", "i", nil, "<N>", false,
+                     type: Integer, range: 0..8)
+        optdict = {}
+        pr = proc { x.validate_and_convert("-1", optdict) }
+        ok {pr}.raise?(RuntimeError, "Positive value (>= 0) expected.")
+        ## when min==1
+        x = new_item(:indent, "-i[=<N>]", "indent", "i", nil, "<N>", false,
+                     type: Integer, range: 1..8)
+        optdict = {}
+        pr = proc { x.validate_and_convert("0", optdict) }
+        ok {pr}.raise?(RuntimeError, "Positive value (>= 1) expected.")
+      end
+      spec "[!a0rej] supports endless range." do
+        begin
+          range1 = eval "(2..)"     # Ruby >= 2.6
+          range2 = eval "(..8)"
+        rescue SyntaxError
+          range1 = nil              # Ruby < 2.6
+          range2 = nil
+        end
+        if range1
+          x = new_item(:indent, "-i[=<N>]", "indent", "i", nil, "<N>", false,
+                       type: Integer, range: range1)
+          optdict = {}
+          pr = proc { x.validate_and_convert("1", optdict) }
+          ok {pr}.raise?(RuntimeError, "Too small (min: 2)")
+          pr = proc { x.validate_and_convert("9", optdict) }
+          ok {pr}.NOT.raise?(RuntimeError)
+        end
+        if range2
+          x = new_item(:indent, "-i[=<N>]", "indent", "i", nil, "<N>", false,
+                       type: Integer, range: range2)
+          optdict = {}
+          pr = proc { x.validate_and_convert("1", optdict) }
+          ok {pr}.NOT.raise?(RuntimeError)
+          pr = proc { x.validate_and_convert("9", optdict) }
+          ok {pr}.raise?(RuntimeError, "Too large (max: 8)")
+        end
+      end
+      spec "[!j4fuz] calls type-specific callback when type specified." do
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false, type: Integer)
+        optdict = {}
+        pr = proc { x.validate_and_convert("abc", optdict) }
+        ok {pr}.raise?(RuntimeError, "Integer expected.")
+      end
+      spec "[!jn9z3] calls callback when callback specified." do
+        called = false
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false) {|va|
+          called = true
+        }
+        optdict = {}
+        x.validate_and_convert("abc", optdict)
+        ok {called} == true
+      end
+      spec "[!iqalh] calls callback with different number of args according to arity." do
+        args1 = nil
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false) {|val|
+          args1 = val
+        }
+        optdict = {}
+        x.validate_and_convert("123", optdict)
+        ok {args1} == "123"
+        #
+        args2 = nil
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false) {|optdict, key, val|
+          args2 = [optdict, key, val]
+        }
+        optdict = {}
+        x.validate_and_convert("123", optdict)
+        ok {args2} == [optdict, :indent, "123"]
+      end
-  describe '#new_options_dict()' do
+      spec "[!x066l] returns new value." do
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false, type: Integer)
+        ok {x.validate_and_convert("123", {})} == 123
+        #
+        x = new_item(:indent, "", "indent width", "i", "indent", "<WIDTH>", false, type: Integer) {|val|
+          val * 2
+        }
+        ok {x.validate_and_convert("123", {})} == 246
+      end
+      spec "[!eafem] returns default value (if specified) instead of true value." do
+        x1 = new_item(:flag, "", "desc", "f", "flag", nil, false, value: nil)
+        ok {x1.validate_and_convert(true, {})} == true
+        x2 = new_item(:flag, "", "desc", "f", "flag", nil, false, value: "blabla")
+        ok {x2.validate_and_convert(true, {})} == "blabla"
+        x3 = new_item(:flag, "", "desc", "f", "flag", nil, false, value: false)
+        ok {x3.validate_and_convert(true, {})} == false
+      end
-    it "[!vm6h0] returns new hash object." do
-      parser = Benry::Cmdopt::Parser.new(new_sample_schema())
-      ret = parser.__send__(:new_options_dict)
-      ok {ret}.is_a?(Hash)
-      ok {ret} == {}
     end
   end
-end
+  topic Benry::CmdOpt::Parser do
-class Benry::Cmdopt::Test < MiniTest::Test
+    topic '#parse_options()' do
+      before do
+        @parser = Benry::CmdOpt::Parser.new(new_sample_schema())
+      end
-  describe 'PARAM_TYPES[Integer]' do
+      spec "[!3wmsy] returns command option values as a dict." do
+        argv = ["-h", "--version"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, version: true}
+      end
-    before do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:indent, "-i, --indent[=<N>]", "indent width", type: Integer)
-      @parser = Benry::Cmdopt::Parser.new(sc)
-    end
+      spec "[!uh7j8] parses long options." do
+        argv = ["--help", "--file=foo.png", "--indent=10"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, file: "foo.png", indent: 10}
+      end
-    it "[!6t8cs] converts value into integer." do
-      d = @parser.parse(['-i20'])
-      ok {d[:indent]} == 20
-      #
-      d = @parser.parse(['--indent=12'])
-      ok {d[:indent]} == 12
-    end
+      spec "[!nwnjc] parses short options." do
+        argv = ["-h", "-f", "foo.png", "-i10"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, file: "foo.png", indent: 10}
+      end
+      spec "[!5s5b6] treats '-' as an argument, not an option." do
+        argv = ["-h", "-", "xxx", "yyy"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true}
+        ok {argv} == ["-", "xxx", "yyy"]
+      end
+      spec "[!q8356] parses options even after arguments when `all: true`." do
+        argv = ["-h", "arg1", "-f", "foo.png", "arg2", "-i10", "arg3"]
+        d = @parser.parse(argv, all: true)
+        ok {d} == {help: true, file: "foo.png", indent: 10}
+        ok {argv} == ["arg1", "arg2", "arg3"]
+        #
+        argv = ["-h", "arg1", "-f", "foo.png", "arg2", "-i10", "arg3"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, file: "foo.png", indent: 10}
+        ok {argv} == ["arg1", "arg2", "arg3"]
+      end
+      spec "[!ryra3] doesn't parse options after arguments when `all: false`." do
+        argv = ["-h", "arg1", "-f", "foo.png", "arg2", "-i10", "arg3"]
+        d = @parser.parse(argv, all: false)
+        ok {d} == {help: true}
+        ok {argv} == ["arg1", "-f", "foo.png", "arg2", "-i10", "arg3"]
+      end
+      spec "[!y04um] skips rest options when '--' found in argv." do
+        argv = ["-h", "--", "-f", "foo.png", "-i10"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true}
+        ok {argv} == ["-f", "foo.png", "-i10"]
+      end
+      spec "[!qpuxh] handles only OptionError when block given." do
+        errmsg = nil
+        errcls = nil
+        @parser.parse(["-ix"]) {|err|
+          errmsg = err.message
+          errcls = err.class
+        }
+        ok {errmsg} == "-ix: Integer expected."
+        ok {errcls} == Benry::CmdOpt::OptionError
+        #
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:file, "--file=<FILE>", "file") do |val|
+          File.open(val) {|f| f.read }
+        end
+        parser = Benry::CmdOpt::Parser.new(sc)
+        pr = proc { parser.parse(["--file=/foo/bar/baz.png"]) }
+        ok {pr}.raise?(Errno::ENOENT, /No such file or directory/)
+      end
+      spec "[!dhpw1] returns nil when OptionError handled." do
+        ret = @parser.parse(["-dx"]) {|err| 1 }
+        ok {ret} == nil
+      end
-    it "[!nzwc9] raises error when failed to convert value into integer." do
-      pr = proc { @parser.parse(['-i2.1']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "-i2.1: integer expected.")
-      #
-      pr = proc { @parser.parse(['--indent=2.2']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--indent=2.2: integer expected.")
     end
-  end
+    topic '#parse_long_option()' do
+      before do
+        @parser = Benry::CmdOpt::Parser.new(new_sample_schema())
+      end
+      spec "[!3i994] raises OptionError when invalid long option format." do
+        argv = ["--f/o/o"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--f/o/o: Invalid long option.")
+      end
+      spec "[!1ab42] invokes error handler method when unknown long option." do
+        def @parser.handle_unknown_long_option(optstr, name, val)
+          (@_called_ ||= []) << [optstr, name, val]
+        end
+        ret = @parser.parse(["--xx=XX", "--yy=YY", "--zz"])
+        ok {ret} == {}
+        ok {@parser.instance_variable_get('@_called_')} == [
+          ["--xx=XX", "xx", "XX"],
+          ["--yy=YY", "yy", "YY"],
+          ["--zz"   , "zz", nil],
+        ]
+      end
+      spec "[!er7h4] default behavior is to raise OptionError when unknown long option." do
+        argv = ["--foo"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--foo: Unknown long option.")
+      end
+      spec "[!2jd9w] raises OptionError when no arguments specified for arg required long option." do
+        argv = ["--file"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--file: Argument required.")
+      end
+      spec "[!qyq8n] raises optionError when an argument specified for no arg long option." do
+        argv = ["--version=1.0.0"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--version=1.0.0: Unexpected argument.")
+      end
-  describe 'PARAM_TYPES[Float]' do
+      spec "[!o596x] validates argument value." do
+        argv = ["--indent=abc"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--indent=abc: Integer expected.")
+        #
+        argv = ["--path=/foo/bar"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--path=/foo/bar: Directory not exist.")
+      end
-    before do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:ratio, "-r, --ratio=<RATIO>", "ratio", type: Float)
-      @parser = Benry::Cmdopt::Parser.new(sc)
     end
-    it "[!gggy6] converts value into float." do
-      d = @parser.parse(['-r', '1.25'])
-      ok {d[:ratio]} == 1.25
-      #
-      d = @parser.parse(['--ratio=1.25'])
-      ok {d[:ratio]} == 1.25
+    topic '#parse_short_option()' do
+      before do
+        @parser = Benry::CmdOpt::Parser.new(new_sample_schema())
+      end
+      spec "[!4eh49] raises OptionError when unknown short option specified." do
+        argv = ["-hxf", "foo.png"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "-x: Unknown option.")
+      end
+      spec "[!utdbf] raises OptionError when argument required but not specified." do
+        argv = ["-hf"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "-f: Argument required.")
+      end
+      spec "[!f63hf] short option arg can be specified without space separator." do
+        argv = ["-hfabc.png", "xx"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, file: "abc.png"}
+        ok {argv} == ["xx"]
+      end
+      spec "[!yjq6b] optional arg should be specified without space separator." do
+        argv = ["-hi123", "xx"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, indent: 123}
+        ok {argv} == ['xx']
+      end
+      spec "[!wape4] otpional arg can be omit." do
+        argv = ["-hi", "xx"]
+        d = @parser.parse(argv)
+        ok {d} == {help: true, indent: true}
+        ok {argv} == ['xx']
+      end
+      spec "[!yu0kc] validates short option argument." do
+        argv = ["-iaaa"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "-iaaa: Integer expected.")
+        #
+        argv = ["-I", "/foo/bar"]
+        pr = proc { @parser.parse(argv) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "-I /foo/bar: Directory not exist.")
+      end
     end
-    it "[!t4elj] raises error when faield to convert value into float." do
-      pr = proc { @parser.parse(['-r', 'abc']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "-r abc: float expected.")
-      #
-      pr = proc { @parser.parse(['--ratio=abc']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError, "--ratio=abc: float expected.")
+    topic '#new_options_dict()' do
+      spec "[!vm6h0] returns new hash object." do
+        parser = Benry::CmdOpt::Parser.new(new_sample_schema())
+        ret = parser.__send__(:new_options_dict)
+        ok {ret}.is_a?(Hash)
+        ok {ret} == {}
+      end
     end
-  end
+    topic '#handle_unknown_long_option()' do
+      spec "[!0q78a] raises OptionError." do
+        parser = Benry::CmdOpt::Parser.new(new_sample_schema())
+        pr = proc {
+          parser.__send__(:handle_unknown_long_option, "--xx=XX", "xx", "XX")
+        }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--xx=XX: Unknown long option.")
+      end
-  describe 'PARAM_TYPES[TrueClass]' do
-    before do
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:border  , "-b, --border[=<on|off>]", "enable border", type: TrueClass)
-      @parser = Benry::Cmdopt::Parser.new(sc)
-    end
-    it "[!47kx4] converts 'true'/'on'/'yes' into true." do
-      d = @parser.parse(["-btrue"])
-      ok {d} == {border: true}
-      d = @parser.parse(["-bon"])
-      ok {d} == {border: true}
-      d = @parser.parse(["-byes"])
-      ok {d} == {border: true}
-      #
-      d = @parser.parse(["--border=true"])
-      ok {d} == {border: true}
-      d = @parser.parse(["--border=on"])
-      ok {d} == {border: true}
-      d = @parser.parse(["--border=yes"])
-      ok {d} == {border: true}
-    end
-    it "[!3n810] converts 'false'/'off'/'no' into false." do
-      d = @parser.parse(["-bfalse"])
-      ok {d} == {border: false}
-      d = @parser.parse(["-boff"])
-      ok {d} == {border: false}
-      d = @parser.parse(["-bno"])
-      ok {d} == {border: false}
-      #
-      d = @parser.parse(["--border=false"])
-      ok {d} == {border: false}
-      d = @parser.parse(["--border=off"])
-      ok {d} == {border: false}
-      d = @parser.parse(["--border=no"])
-      ok {d} == {border: false}
-    end
-    it "[!h8ayh] raises error when failed to convert value into true nor false." do
-      pr = proc { @parser.parse(["-bt"]) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError,
-                     "-bt: boolean expected.")
-      #
-      pr = proc { @parser.parse(["--border=t"]) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError,
-                     "--border=t: boolean expected.")
     end
   end
-  describe 'PARAM_TYPES[Date]' do
-    before do
-      require 'date'
-      sc = Benry::Cmdopt::Schema.new
-      sc.add(:date, "-d, --date=<YYYY-MM-DD>]", "date", type: Date)
-      @parser = Benry::Cmdopt::Parser.new(sc)
-    end
+  topic Benry::CmdOpt do
-    it "[!sru5j] converts 'YYYY-MM-DD' into date object." do
-      d = @parser.parse(['-d', '2000-01-01'])
-      ok {d[:date]} == Date.new(2000, 1, 1)
-      #
-      d = @parser.parse(['--date=2000-1-2'])
-      ok {d[:date]} == Date.new(2000, 1, 2)
-    end
-    it "[!h9q9y] raises error when failed to convert into date object." do
-      pr = proc { @parser.parse(['-d', '2000/01/01']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError,
-                     "-d 2000/01/01: invalid date format (ex: '2000-01-01')")
-      #
-      pr = proc { @parser.parse(['--date=01-01-2000']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError,
-                     "--date=01-01-2000: invalid date format (ex: '2000-01-01')")
+    topic 'PARAM_TYPES[Integer]' do
+      before do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:indent, "-i, --indent[=<N>]", "indent width", type: Integer)
+        @parser = Benry::CmdOpt::Parser.new(sc)
+      end
+      spec "[!6t8cs] converts value into integer." do
+        d = @parser.parse(['-i20'])
+        ok {d[:indent]} == 20
+        #
+        d = @parser.parse(['--indent=12'])
+        ok {d[:indent]} == 12
+      end
+      spec "[!nzwc9] raises error when failed to convert value into integer." do
+        pr = proc { @parser.parse(['-i2.1']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "-i2.1: Integer expected.")
+        #
+        pr = proc { @parser.parse(['--indent=2.2']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--indent=2.2: Integer expected.")
+      end
     end
-    it "[!i4ui8] raises error when specified date not exist." do
-      pr = proc { @parser.parse(['-d', '2001-02-29']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError,
-                     "-d 2001-02-29: date not exist.")
-      #
-      pr = proc { @parser.parse(['--date=2001-02-29']) }
-      ok {pr}.raise?(Benry::Cmdopt::OptionError,
-                     "--date=2001-02-29: date not exist.")
+    topic 'PARAM_TYPES[Float]' do
+      before do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:ratio, "-r, --ratio=<RATIO>", "ratio", type: Float)
+        @parser = Benry::CmdOpt::Parser.new(sc)
+      end
+      spec "[!gggy6] converts value into float." do
+        d = @parser.parse(['-r', '1.25'])
+        ok {d[:ratio]} == 1.25
+        #
+        d = @parser.parse(['--ratio=1.25'])
+        ok {d[:ratio]} == 1.25
+      end
+      spec "[!t4elj] raises error when faield to convert value into float." do
+        pr = proc { @parser.parse(['-r', 'abc']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "-r abc: Float expected.")
+        #
+        pr = proc { @parser.parse(['--ratio=abc']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError, "--ratio=abc: Float expected.")
+      end
     end
-  end
+    topic 'PARAM_TYPES[TrueClass]' do
+      before do
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:border  , "-b, --border[=<on|off>]", "enable border", type: TrueClass)
+        @parser = Benry::CmdOpt::Parser.new(sc)
+      end
+      spec "[!47kx4] converts 'true'/'on'/'yes' into true." do
+        d = @parser.parse(["-btrue"])
+        ok {d} == {border: true}
+        d = @parser.parse(["-bon"])
+        ok {d} == {border: true}
+        d = @parser.parse(["-byes"])
+        ok {d} == {border: true}
+        #
+        d = @parser.parse(["--border=true"])
+        ok {d} == {border: true}
+        d = @parser.parse(["--border=on"])
+        ok {d} == {border: true}
+        d = @parser.parse(["--border=yes"])
+        ok {d} == {border: true}
+      end
+      spec "[!3n810] converts 'false'/'off'/'no' into false." do
+        d = @parser.parse(["-bfalse"])
+        ok {d} == {border: false}
+        d = @parser.parse(["-boff"])
+        ok {d} == {border: false}
+        d = @parser.parse(["-bno"])
+        ok {d} == {border: false}
+        #
+        d = @parser.parse(["--border=false"])
+        ok {d} == {border: false}
+        d = @parser.parse(["--border=off"])
+        ok {d} == {border: false}
+        d = @parser.parse(["--border=no"])
+        ok {d} == {border: false}
+      end
-  describe '.new()' do
+      spec "[!h8ayh] raises error when failed to convert value into true nor false." do
+        pr = proc { @parser.parse(["-bt"]) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError,
+                       "-bt: Boolean expected.")
+        #
+        pr = proc { @parser.parse(["--border=t"]) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError,
+                       "--border=t: Boolean expected.")
+      end
-    it "[!7kkqv] creates Facade object." do
-      obj = Benry::Cmdopt.new
-      ok {obj}.is_a?(Benry::Cmdopt::Facade)
     end
-  end
+    topic 'PARAM_TYPES[Date]' do
-end
+      before do
+        require 'date'
+        sc = Benry::CmdOpt::Schema.new
+        sc.add(:date, "-d, --date=<YYYY-MM-DD>]", "date", type: Date)
+        @parser = Benry::CmdOpt::Parser.new(sc)
+      end
+      spec "[!sru5j] converts 'YYYY-MM-DD' into date object." do
+        d = @parser.parse(['-d', '2000-01-01'])
+        ok {d[:date]} == Date.new(2000, 1, 1)
+        #
+        d = @parser.parse(['--date=2000-1-2'])
+        ok {d[:date]} == Date.new(2000, 1, 2)
+      end
+      spec "[!h9q9y] raises error when failed to convert into date object." do
+        pr = proc { @parser.parse(['-d', '2000/01/01']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError,
+                       "-d 2000/01/01: Invalid date format (ex: '2000-01-01')")
+        #
+        pr = proc { @parser.parse(['--date=01-01-2000']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError,
+                       "--date=01-01-2000: Invalid date format (ex: '2000-01-01')")
+      end
+      spec "[!i4ui8] raises error when specified date not exist." do
+        pr = proc { @parser.parse(['-d', '2001-02-29']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError,
+                       "-d 2001-02-29: Date not exist.")
+        #
+        pr = proc { @parser.parse(['--date=2001-02-29']) }
+        ok {pr}.raise?(Benry::CmdOpt::OptionError,
+                       "--date=2001-02-29: Date not exist.")
+      end
+    end
-class Benry::Cmdopt::Facade::Test < MiniTest::Test
+    topic '.new()' do
-  describe '#add()' do
+      spec "[!7kkqv] creates Facade object." do
+        obj = Benry::CmdOpt.new
+        ok {obj}.is_a?(Benry::CmdOpt::Facade)
+      end
-    it "[!vmb3r] defines command option." do
-      cmdopt = Benry::Cmdopt.new()
-      cmdopt.add(:help, "-h, --help", "show help message")
-      items = cmdopt.instance_eval { @schema.instance_variable_get('@items') }
-      ok {items}.is_a?(Array)
-      ok {items.length} == 1
-      ok {items[0].key} == :help
-      ok {items[0].short} == 'h'
-      ok {items[0].long} == 'help'
-      ok {items[0].help} == 'show help message'
     end
   end
-  describe '#option_help()' do
-    before do
-      @cmdopt = Benry::Cmdopt.new
-      @cmdopt.add(:help   , "-h, --help"        , "show help message")
-      @cmdopt.add(:version, "    --version"     , "print version")
-      @cmdopt.add(:file   , "-f, --file=<FILE>" , "filename")
+  topic Benry::CmdOpt::Facade do
+    topic '#add()' do
+      spec "[!vmb3r] defines command option." do
+        cmdopt = Benry::CmdOpt.new()
+        cmdopt.add(:help, "-h, --help", "show help message", detail: "(text)", tag: :important)
+        items = cmdopt.instance_eval { @schema.instance_variable_get('@items') }
+        ok {items}.is_a?(Array)
+        ok {items.length} == 1
+        ok {items[0].key} == :help
+        ok {items[0].short} == 'h'
+        ok {items[0].long} == 'help'
+        ok {items[0].desc} == 'show help message'
+        ok {items[0].detail} == '(text)'
+        ok {items[0].tag} == :important
+      end
+      spec "[!71cvg] type, rexp, enum, and range are can be passed as positional args as well as keyword args." do
+        cmdopt = Benry::CmdOpt.new()
+        cmdopt.add(:key, "--optdef[=xx]", "desc", Integer, /\A\d+\z/, [2,4,8], (2..8), value: 4)
+        items = cmdopt.instance_eval { @schema.instance_variable_get('@items') }
+        item = items.first
+        ok {item.type} == Integer
+        ok {item.rexp} == /\A\d+\z/
+        ok {item.enum} == [2,4,8]
+        ok {item.range} == (2..8)
+        ok {item.value} == 4
+      end
     end
-    it "[!dm4p8] returns option help message." do
-      help = @cmdopt.option_help()
-      ok {help} == <<END
+    topic '#option_help()' do
+      before do
+        @cmdopt = Benry::CmdOpt.new
+        @cmdopt.add(:help   , "-h, --help"        , "show help message")
+        @cmdopt.add(:version, "    --version"     , "print version")
+        @cmdopt.add(:file   , "-f, --file=<FILE>" , "filename")
+      end
+      spec "[!dm4p8] returns option help message." do
+        helpmsg = @cmdopt.option_help()
+        ok {helpmsg} == <<END
   -h, --help           : show help message
       --version        : print version
   -f, --file=<FILE>    : filename
 END
+      end
     end
-  end
+    topic '#to_s()' do
-  describe '#each_option_help()' do
+      spec "[!s61vo] '#to_s' is an alias to '#option_help()'." do
+        cmdopt = Benry::CmdOpt.new
+        cmdopt.add(:help   , "-h, --help"        , "show help message")
+        cmdopt.add(:version, "    --version"     , "print version")
+        ok {cmdopt.to_s} == cmdopt.option_help()
+      end
-    before do
-      @cmdopt = Benry::Cmdopt.new
-      @cmdopt.add(:help   , "-h, --help"        , "show help message")
-      @cmdopt.add(:version, "    --version"     , "print version")
-      @cmdopt.add(:file   , "-f, --file=<FILE>" , "filename")
     end
-    it "[!bw9qx] yields each option definition string and help message." do
-      cmdopt = @cmdopt
-      pairs = []
-      cmdopt.each_option_help do |opt, help|
-        pairs << [opt, help]
+    topic '#each_option_and_desc()' do
+      before do
+        @cmdopt = Benry::CmdOpt.new
+        @cmdopt.add(:help   , "-h, --help"        , "show help message")
+        @cmdopt.add(:version, "    --version"     , "print version")
+        @cmdopt.add(:debug  , "-D"                , nil)       # hidden option
+        @cmdopt.add(:_trace , "-T"                , "trace")   # hidden option
+      end
+      spec "[!bw9qx] yields each option definition string and help message." do
+        pairs = []
+        @cmdopt.each_option_and_desc {|opt, desc| pairs << [opt, desc] }
+        ok {pairs} == [
+          ["-h, --help"   , "show help message"],
+          ["    --version", "print version"],
+        ]
+      end
+      spec "[!kunfw] yields all items (including hidden items) if `all: true` specified." do
+        ## when 'all: true'
+        pairs = []
+        @cmdopt.each_option_and_desc(all: true) {|opt, desc| pairs << [opt, desc] }
+        ok {pairs} == [
+          ["-h, --help"   , "show help message"],
+          ["    --version", "print version"],
+          ["-D"           , nil],
+          ["-T"           , "trace"],
+        ]
+        ## when 'all: false'
+        pairs = []
+        @cmdopt.each_option_and_desc(all: false) {|opt, desc| pairs << [opt, desc] }
+        ok {pairs} == [
+          ["-h, --help"   , "show help message"],
+          ["    --version", "print version"],
+        ]
+      end
+      spec "[!wght5] returns enumerator object if block not given." do
+        ## when 'all: true'
+        xs = @cmdopt.each_option_and_desc(all: true)
+        ok {xs}.is_a?(Enumerator)
+        ok {xs.collect {|x, _| x }} == ["-h, --help", "    --version", "-D", "-T"]
+        ## when 'all: false'
+        xs = @cmdopt.each_option_and_desc(all: false)
+        ok {xs}.is_a?(Enumerator)
+        ok {xs.collect {|x, _| x }} == ["-h, --help", "    --version"]
       end
-      ok {pairs} == [
-        ["-h, --help", "show help message"],
-        ["    --version", "print version"],
-        ["-f, --file=<FILE>", "filename"],
-      ]
     end
-  end
+    topic '#parse()' do
-  describe '#parse_options()' do
+      before do
+        @cmdopt = Benry::CmdOpt.new()
+        @cmdopt.add(:file, "-f, --file=<FILE>", "file") do |val|
+          File.open(val) {|f| f.read }
+        end
+        @cmdopt.add(:debug, "-d, --debug[=<LEVEL>]", "debug", type: Integer)
+      end
-    before do
-      @cmdopt = Benry::Cmdopt.new()
-      @cmdopt.add(:file, "-f, --file=<FILE>", "file") do |val|
-        File.open(val) {|f| f.read }
+      spec "[!areof] handles only OptionError when block given." do
+        errmsg = nil
+        errcls = nil
+        @cmdopt.parse(["-dx"]) {|err|
+          errmsg = err.message
+          errcls = err.class
+        }
+        ok {errmsg} == "-dx: Integer expected."
+        ok {errcls} == Benry::CmdOpt::OptionError
+        #
+        pr = proc do
+          @cmdopt.parse(["-f", "/foo/bar/baz.png"])
+        end
+        ok {pr}.raise?(Errno::ENOENT, /No such file or directory/)
       end
-      @cmdopt.add(:file, "-d, --debug[=<LEVEL>]", "debug", type: Integer)
-    end
-    it "[!areof] handles only OptionError when block given." do
-      errmsg = nil
-      errcls = nil
-      @cmdopt.parse(["-dx"]) {|err|
-        errmsg = err.message
-        errcls = err.class
-      }
-      ok {errmsg} == "-dx: integer expected."
-      ok {errcls} == Benry::Cmdopt::OptionError
-      #
-      pr = proc do
-        @cmdopt.parse(["-f", "/foo/bar/baz.png"])
+      spec "[!peuva] returns nil when OptionError handled." do
+        ret = @cmdopt.parse(["-dx"]) {|err| 1 }
+        ok {ret} == nil
+      end
+      spec "[!za9at] parses options only before args when `all: false`." do
+        argv = ["aaa", "-d3", "bbb"]
+        #
+        argv1 = argv.dup
+        opts1 = @cmdopt.parse(argv1)
+        ok {opts1} == {:debug=>3}
+        ok {argv1} == ["aaa", "bbb"]
+        #
+        argv2 = argv.dup
+        opts2 = @cmdopt.parse(argv2, all: false)
+        ok {opts2} == {}
+        ok {argv2} == ["aaa", "-d3", "bbb"]
       end
-      ok {pr}.raise?(Errno::ENOENT, /No such file or directory/)
-    end
-    it "[!peuva] returns nil when OptionError handled." do
-      ret = @cmdopt.parse(["-dx"]) {|err| 1 }
-      ok {ret} == nil
     end
   end