benry-cmdopt 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51be94488014a32dabfc2f524a850fa657a11c4c1d9d9b92761d00e57e24969e
-  data.tar.gz: d2078058fec806f194f0bfd1d5d6705a78430c7989d7eb9ddccadea2daa3311b
+  metadata.gz: e22704458cfcb32a806de14c4b4df853673de1309b964d4362e2cc9605f64fca
+  data.tar.gz: 78a52a4a0d1b5d261bea63c58b454b0b68810f10fb3795e347644f269715580f
 SHA512:
-  metadata.gz: 41e0e1a914cb6022f31244d6770067bd38636f27c0ce9e30dbcd37a731bc8d3f485329e0c0b49ff3aa322250f6d475ee0c28032a1053132e0f8c2bf061b2aa7c
-  data.tar.gz: e5e3922ccf2d06e9b56997cc07e7616dfa905fedb1974953f7bc9138d7b888cab6d5b5c8025000cd574b8b608ead71ef772571fa71486c5467294d20376bdb9e
+  metadata.gz: b79a27875901ee9aaa5ef6f8bee208e2b5d76ff69511a9b47d741df9350c724f1b3c9530a48c80cc2e1bd69ce5283f447c104da0c2587ec96628750ce141031f
+  data.tar.gz: e063f8ab5ab3d1054d96e1410b6b85d4517086d0c64772b1957951e6faada16e2e71d7333eb3388f981d545b1011db37a002fc7eb70cb7e637f5828165f1aef0

data/CHANGES.md

@@ -3,6 +3,13 @@ CHANGES
 =======
 
 
+Release 1.0.0 (2021-01-18)
+--------------------------
+
+* [change] rename 'build_option_help()' to 'option_help()'.
+* [change] shorten option help width when no long options defined.
+
+
 Release 1.0.0 (2021-01-17)
 --------------------------
 

data/README.md

@@ -1,23 +1,184 @@
 Benry::Cmdopt README
 ====================
 
-($Release: 1.0.0 $)
+($Release: 1.1.0 $)
 
 Benry::Cmdopt is a command option parser library, like `optparse.rb`.
 
-Compared to `optparse.rb`:
-
-* Easy to use, easy to extend, easy to understand.
-* Not add `-h` nor `--help` automatically.
-* Not add `-v` nor `--version` automatically.
-* Not regard `-x` as short cut of `--xxx`.
-  (`optparser.rb` regards `-x` as short cut of `--xxx` automatically.)
-* Provides very simple feature to build custom help message.
-* Separates command option schema class from parser class.
+Compared to `optparse.rb`, Benry::Cmdopt is easy to use, easy to extend,
+and easy to understahnd.
 
 (Benry::Cmdopt requires Ruby >= 2.3)
 
 
+Why not `optparse.rb`?
+======================
+
+* Source code of `optparse.rb` is very large and complicated, because
+  `OptParse` class does everything about command option parsing.
+  It is hard to customize or extend `OptionParser` class.
+
+  On the other hand, `benry/cmdopt.rb` consists of several classes
+  (schema class, parser class, and facade class).
+  Therefore it is easy to understand and extend these classes.
+
+  File `optparse.rb` contains 1234 lines (without comments), while
+  `benry/cmdopt.rb` (v1.1.0) contains only 361 lines (without comments).
+
+* `optparse.rb` regards `-x` as a short cut of `--xxx` automatically
+  even if you have not defined `-x` option.
+  That is, short options which are not defined can be available unexpectedly.
+  This feature is hard-coded in `OptionParser#parse_in_order()`
+  and hard to be disabled.
+
+  On the other hand, `benry/cmdopt.rb` doesn't behave this way.
+  `-x` option is available only when `-x` is defined.
+
+* `optparse.rb` can handle both `--name=val` and `--name val` styles.
+  The later style is ambiguous; you may wonder whether `--name` takes
+  `val` as argument or `--name` takes no argument (and `val` is command
+  argument).
+
+  Therefore the `--name=val` style is better than the `--name val` style.
+
+  `optparse.rb` cannot disable `--name val` style.
+  `benry/cmdopt.rb` supports only `--name=val` style.
+
+* `optparse.rb` enforces you to catch `OptionParser::ParseError` exception.
+  That is, you must know error class name.
+
+  `benry/cmdopt.rb` provides error handler without exception class name.
+  You don't need to know error class name on error handling.
+
+```ruby
+### optparse.rb
+require 'optparse'
+parser = OptionParser.new
+parser.on('-f', '--file=<FILE>', "filename")
+opts = {}
+begin
+  parser.parse!(ARGV, into: opts)
+rescue OptionParser::ParseError => ex   # specify error class
+  $stderr.puts "ERROR: #{ex.message}"
+  exit 1
+end
+
+### benry/cmdopt.rb
+require 'benry/cmdopt'
+cmdopt = Benry::Cmdopt.new
+cmdopt.add(:file, '-f, --file=<FILE>', "filename")
+opts = cmdopt.parse(ARGV) do |err|  # error handling wihtout error class name
+  $stderr.puts "ERROR: #{err.message}"
+  exit 1
+end
+```
+
+* `optparse.rb` uses long option name as hash key automatically, but
+  it doesn't provide the way to specify hash key of short-only option.
+
+  `benry/cmdopt.rb` can specify hash key of short-only option.
+
+```ruby
+### optparse.rb
+require 'optparse'
+parser = OptionParser.new
+parser.on('-v', '--verbose', "verbose mode") # short and long option
+parser.on('-q',              "quiet mode")   # short-only option
+#
+opts = {}
+parser.parse!(['-v'], into: opts) # short option
+p opts  #=> {:verbose=>true}      # hash key is long option name
+#
+opts = {}
+parser.parse!(['-q'], into: opts) # short option
+p opts  #=> {:q=>true}            # hash key is short option name
+
+### benry/cmdopt.rb
+require 'benry/cmdopt'
+cmdopt = Benry::Cmdopt.new
+cmdopt.add(:verbose, '-v, --verbose', "verbose mode") # short and long
+cmdopt.add(:quiet  , '-q'           , "quiet mode")   # short-only
+#
+opts = cmdopt.parse(['-v'])   # short option
+p opts  #=> {:verbose=>true}  # independent hash key of option name
+#
+opts = cmdopt.parse(['-q'])   # short option
+p opts  #=> {:quiet=>true}    # independent hash key of option name
+```
+
+* `optparse.rb` adds `-h` and `--help` options automatically, and
+  terminates current process when `-v` or `--version` specified in terminal.
+  It is hard to remove these options.
+
+  On the other hand, `benry/cmdopt.rb` does not add these options.
+  benry/cmdopt.rb` does nothing extra.
+
+```ruby
+require 'optparse'
+parser = OptionParser.new
+## it is able to overwrite '-h' and/or '--help',
+## but how to remove or disable these options?
+opts = {}
+parser.on('-h <host>', "hostname") {|v| opts[:host] = v }
+parser.parse(['--help'])  # <== terminates current process!!
+puts 'xxx'   #<== not printed because current process alreay terminated
+```
+
+* `optparse.rb` adds `-v` and `--version` options automatically, and
+  terminates current process when `-v` or `--version` specified in terminal.
+  It is hard to remove these options.
+
+  On the other hand, `benry/cmdopt.rb` does not add these options.
+  benry/cmdopt.rb` does nothing extra.
+
+```ruby
+require 'optparse'
+parser = OptionParser.new
+## it is able to overwrite '-v' and/or '--version',
+## but how to remove or disable these options?
+opts = {}
+parser.on('-v', "verbose mode") { opts[:verbose] = true }
+parser.parse(['--version'])  # <== terminates current process!!
+puts 'xxx'   #<== not printed because current process alreay terminated
+```
+
+* `optparse.rb` generates help message automatically, but it doesn't
+  contain `-h`, `--help`, `-v`, nor `--version`.
+  These options are available but not shown in help message. Strange.
+
+* `optparse.rb` generates help message with too wide option name
+  by default. You must specify proper width.
+
+  `benry/cmdopt.rb` calculates proper width automatically.
+  You don't need to specify proper width in many case.
+
+```ruby
+### optparse.rb
+require 'optparse'
+banner = "Usage: blabla <options>"
+parser = OptionParser.new(banner)  # or OptionParser.new(banner, 25)
+parser.on('-f', '--file=<FILE>', "filename")
+parser.on('-m <MODE>'          , "verbose/quiet")
+puts parser.help
+### output
+# Usage: blabla <options>
+#     -f, --file=<FILE>                filename
+#     -m <MODE>                        verbose/quiet
+
+### benry/cmdopt.rb
+require 'benry/cmdopt'
+cmdopt = Benry::Cmdopt.new()
+cmdopt.add(:file, '-f, --file=<FILE>', "filename")
+cmdopt.add(:mode, '-m <MODE>'        , "verbose/quiet")
+puts "Usage: blabla <options>"
+puts cmdopt.option_help()
+### output (calculated proper width)
+# Usage: blabla <options>
+#   -f, --file=<FILE>    : filename
+#   -m <MODE>            : verbose/quiet
+```
+
+
 Usage
 =====
 
@@ -30,8 +191,8 @@ require 'benry/cmdopt'
 
 ## define
 cmdopt = Benry::Cmdopt.new
-cmdopt.add(:help   , "-h, --help"   , "print help message")
-cmdopt.add(:version, "    --version", "print version")
+cmdopt.add(:help   , '-h, --help'   , "print help message")
+cmdopt.add(:version, '    --version', "print version")
 
 ## parse with error handling
 options = cmdopt.parse(ARGV) do |err|
@@ -46,7 +207,7 @@ if options[:help]
   puts "Usage: foobar [<options>] [<args>...]"
   puts ""
   puts "Options:"
-  puts cmdopt.build_option_help()
+  puts cmdopt.option_help()
   ## or
   #format = "  %-20s : %s"
   #cmdopt.each_option_help {|opt, help| puts format % [opt, help] }
@@ -59,29 +220,32 @@ Command option parameter
 
 ```ruby
 ## required parameter
-cmdopt.add(:file, "-f, --file=<FILE>", "filename")
-cmdopt.add(:file, "    --file=<FILE>", "filename")
-cmdopt.add(:file, "-f <FILE>"        , "filename")
+cmdopt.add(:file, '-f, --file=<FILE>', "filename")
+cmdopt.add(:file, '    --file=<FILE>', "filename")
+cmdopt.add(:file, '-f <FILE>'        , "filename")
 
 ## optional parameter
-cmdopt.add(:file, "-f, --file[=<FILE>]", "filename")
-cmdopt.add(:file, "    --file[=<FILE>]", "filename")
-cmdopt.add(:file, "-f[<FILE>]"         , "filename")
+cmdopt.add(:file, '-f, --file[=<FILE>]', "filename")
+cmdopt.add(:file, '    --file[=<FILE>]', "filename")
+cmdopt.add(:file, '-f[<FILE>]'         , "filename")
 ```
 
+Notice that `"--file <FILE>"` style is not supported.
+Please use `"--file=<FILE>"` style.
+
 
 Argument varidation
 -------------------
 
 ```ruby
 ## type
-cmdopt.add(:indent , "-i <N>", "indent width", type: Integer)
+cmdopt.add(:indent , '-i <N>', "indent width", type: Integer)
 ## pattern
-cmdopt.add(:indent , "-i <N>", "indent width", pattern: /\A\d+\z/)
+cmdopt.add(:indent , '-i <N>', "indent width", pattern: /\A\d+\z/)
 ## enum
-cmdopt.add(:indent , "-i <N>", "indent width", enum: [2, 4, 8])
+cmdopt.add(:indent , '-i <N>', "indent width", enum: [2, 4, 8])
 ## callback
-cmdopt.add(:indent , "-i <N>", "indent width") {|val|
+cmdopt.add(:indent , '-i <N>', "indent width") {|val|
   val =~ /\A\d+\z/  or
     raise "integer expected."  # raise without exception class.
   val.to_i                     # convert argument value.
@@ -102,7 +266,7 @@ Multiple parameters
 -------------------
 
 ```ruby
-cmdopt.add(:lib , "-I <NAME>", "library names") {|optdict, key, val|
+cmdopt.add(:lib , '-I <NAME>', "library name") {|optdict, key, val|
   arr = optdict[key] || []
   arr << val
   arr
@@ -110,11 +274,29 @@ cmdopt.add(:lib , "-I <NAME>", "library names") {|optdict, key, val|
 ```
 
 
-Not support
------------
+Hidden option
+-------------
+
+If help string of command otpion is nil, it will not included
+in help message.
+
+```ruby
+require 'benry/cmdopt'
+cmdopt = Benry::Cmdopt.new
+cmdopt.add(:verbose, '-v, --verbose', "verbose mode")
+cmdopt.add(:debug  , '-d[<LEVEL>]'  , nil, type: Integer) # hidden
+puts cmdopt.option_help()
+### output ('-d' is not included)
+#  -v, --verbose        : verbose mode
+```
+
+
+Not supported
+-------------
 
 * default value
 * `--no-xxx` style option
+* bash/zsh completion
 
 
 Internal classes
@@ -140,7 +322,7 @@ opts = parser.parse(argv) do |err|
   $stderr.puts "ERROR: #{err.message}"
   exit 1
 end
-p opts   #=> [:help=>true, :indent=>2, :file=>"blabla.txt"]
+p opts   #=> {:help=>true, :indent=>2, :file=>"blabla.txt"}
 p argv   #=> ["aaa", "bbb"]
 ```
 

data/benry-cmdopt.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name            = 'benry-cmdopt'
-  spec.version         = '$Release: 1.0.0 $'.split()[1]
+  spec.version         = '$Release: 1.1.0 $'.split()[1]
   spec.author          = 'kwatch'
   spec.email           = 'kwatch@gmail.com'
   spec.platform        = Gem::Platform::RUBY

data/lib/benry/cmdopt.rb

@@ -19,8 +19,8 @@ module Benry
   ## Usage:
   ##     ## define
   ##     cmdopt = Benry::Cmdopt.new
-  ##     cmdopt.add(:help   , "-h, --help"   , "print help message")
-  ##     cmdopt.add(:version, "    --version", "print version")
+  ##     cmdopt.add(:help   , '-h, --help'   , "print help message")
+  ##     cmdopt.add(:version, '    --version', "print version")
   ##     ## parse
   ##     options = cmdopt.parse(ARGV) do |err|
   ##       $stderr.puts "ERROR: #{err.message}"
@@ -33,7 +33,7 @@ module Benry
   ##       puts "Usage: foobar [<options>] [<args>...]"
   ##       puts ""
   ##       puts "Options:"
-  ##       puts cmdopt.build_option_help()
+  ##       puts cmdopt.option_help()
   ##       ## or
   ##       #format = "  %-20s : %s"
   ##       #cmdopt.each_option_help {|opt, help| puts format % [opt, help] }
@@ -41,23 +41,23 @@ module Benry
   ##
   ## Command option parameter:
   ##     ## required
-  ##     cmdopt.add(:file, "-f, --file=<FILE>", "filename")
-  ##     cmdopt.add(:file, "    --file=<FILE>", "filename")
-  ##     cmdopt.add(:file, "-f <FILE>"        , "filename")
+  ##     cmdopt.add(:file, '-f, --file=<FILE>', "filename")
+  ##     cmdopt.add(:file, '    --file=<FILE>', "filename")
+  ##     cmdopt.add(:file, '-f <FILE>'        , "filename")
   ##     ## optional
-  ##     cmdopt.add(:file, "-f, --file[=<FILE>]", "filename")
-  ##     cmdopt.add(:file, "    --file[=<FILE>]", "filename")
-  ##     cmdopt.add(:file, "-f[<FILE>]"         , "filename")
+  ##     cmdopt.add(:file, '-f, --file[=<FILE>]', "filename")
+  ##     cmdopt.add(:file, '    --file[=<FILE>]', "filename")
+  ##     cmdopt.add(:file, '-f[<FILE>]'         , "filename")
   ##
   ## Validation:
   ##     ## type
-  ##     cmdopt.add(:indent , "-i <N>", "indent width", type: Integer)
+  ##     cmdopt.add(:indent , '-i <N>', "indent width", type: Integer)
   ##     ## pattern
-  ##     cmdopt.add(:indent , "-i <N>", "indent width", pattern: /\A\d+\z/)
+  ##     cmdopt.add(:indent , '-i <N>', "indent width", pattern: /\A\d+\z/)
   ##     ## enum
-  ##     cmdopt.add(:indent , "-i <N>", "indent width", enum: [2, 4, 8])
+  ##     cmdopt.add(:indent , '-i <N>', "indent width", enum: [2, 4, 8])
   ##     ## callback
-  ##     cmdopt.add(:indent , "-i <N>", "indent width") {|val|
+  ##     cmdopt.add(:indent , '-i <N>', "indent width") {|val|
   ##       val =~ /\A\d+\z/  or
   ##         raise "integer expected."  # raise without exception class.
   ##       val.to_i                     # convert argument value.
@@ -70,20 +70,31 @@ module Benry
   ##     * Date      (`/\A\d\d\d\d-\d\d?-\d\d?\z/`)
   ##
   ## Multiple parameters:
-  ##     cmdopt.add(:lib , "-I <NAME>", "library names") {|optdict, key, val|
+  ##     cmdopt.add(:lib , '-I <NAME>', "library name") {|optdict, key, val|
   ##       arr = optdict[key] || []
   ##       arr << val
   ##       arr
   ##     }
   ##
-  ## Not support:
+  ## Hidden option:
+  ##     ### if help string is nil, that option is removed from help message.
+  ##     require 'benry/cmdopt'
+  ##     cmdopt = Benry::Cmdopt.new
+  ##     cmdopt.add(:verbose, '-v, --verbose', "verbose mode")
+  ##     cmdopt.add(:debug  , '-d[<LEVEL>]'  , nil, type: Integer) # hidden
+  ##     puts cmdopt.option_help()
+  ##     ### output ('-d' doesn't appear because help string is nil)
+  ##     #  -v, --verbose        : verbose mode
+  ##
+  ## Not supported:
   ##     * default value
   ##     * `--no-xxx` style option
+  ##     * bash/zsh completion
   ##
   module Cmdopt
 
 
-    VERSION = '$Release: 1.0.0 $'.split()[1]
+    VERSION = '$Release: 1.1.0 $'.split()[1]
 
 
     def self.new
@@ -105,9 +116,9 @@ module Benry
         self
       end
 
-      def build_option_help(width_or_format=nil, all: false)
+      def option_help(width_or_format=nil, all: false)
         #; [!dm4p8] returns option help message.
-        return @schema.build_option_help(width_or_format, all: all)
+        return @schema.option_help(width_or_format, all: all)
       end
 
       def each_option_help(&block)
@@ -148,6 +159,10 @@ module Benry
         key || long  or
           raise error("add(#{key.inspect}, #{optdef.inspect}): long option required when option key (1st arg) not specified.")
         key ||= long.gsub(/-/, '_').intern
+        #; [!97sn0] raises SchemaError when ',' is missing between short and long options.
+        if long.nil? && param =~ /\A--/
+          raise error("add(#{key.inspect}, #{optdef.inspect}): missing ',' between short option and long options.")
+        end
         #; [!7xmr5] raises SchemaError when type is not registered.
         #; [!s2aaj] raises SchemaError when option has no params but type specified.
         if type
@@ -179,13 +194,13 @@ module Benry
         item
       end
 
-      def build_option_help(width_or_format=nil, all: false)
+      def option_help(width_or_format=nil, all: false)
         #; [!0aq0i] can take integer as width.
         #; [!pcsah] can take format string.
         #; [!dndpd] detects option width automatically when nothing specified.
         case width_or_format
         when nil    ; format = _default_format()
-        when Integer; format = "  %-#{width_or_format}s: %s"
+        when Integer; format = "  %-#{width_or_format}s : %s"
         when String ; format = width_or_format
         else
           raise ArgumentError.new("#{width_or_format.inspect}: width (integer) or format (string) expected.")
@@ -214,19 +229,6 @@ module Benry
         return buf.join()
       end
 
-      def _default_format(min_width=20, max_width=35)
-        #; [!hr45y] detects preffered option width.
-        w = 0
-        each_option_help do |opt, help|
-          w = opt.length if w < opt.length
-        end
-        w = min_width if w < min_width
-        w = max_width if w > max_width
-        #; [!kkh9t] returns format string.
-        return "  %-#{w}s : %s"
-      end
-      private :_default_format
-
       def each_option_help(&block)
         #; [!4b911] yields each optin definition str and help message.
         @items.each do |item|
@@ -274,30 +276,50 @@ module Benry
         return short, long, param1 || param2, !!param2
       end
 
+      def _default_format(min_width=nil, max_width=35)
+        #; [!bmr7d] changes min_with according to options.
+        min_width ||= _preferred_option_width()
+        #; [!hr45y] detects preffered option width.
+        w = 0
+        each_option_help do |opt, help|
+          w = opt.length if w < opt.length
+        end
+        w = min_width if w < min_width
+        w = max_width if w > max_width
+        #; [!kkh9t] returns format string.
+        return "  %-#{w}s : %s"
+      end
+
+      def _preferred_option_width()
+        #; [!kl91t] shorten option help min width when only single options which take no arg.
+        #; [!0koqb] widen option help min width when any option takes an arg.
+        #; [!kl91t] widen option help min width when long option exists.
+        long_p  = @items.any? {|x| x.help &&  x.long &&  x.param }
+        short_p = @items.all? {|x| x.help && !x.long && !x.param }
+        return short_p ? 8 : long_p ? 20 : 14
+      end
+
     end
 
 
     class SchemaItem    # avoid Struct
 
       def initialize(key, optdef, short, long, param, help, optional: nil, type: nil, pattern: nil, enum: nil, &callback)
-        @key      = key
-        @optdef   = optdef
-        @short    = short
-        @long     = long
-        @param    = param
-        @help     = help
-        @optional = optional
-        @type     = type
-        @pattern  = pattern
-        @enum     = enum
-        @callback = callback
+        @key      = key       unless key.nil?
+        @optdef   = optdef    unless optdef.nil?
+        @short    = short     unless short.nil?
+        @long     = long      unless long.nil?
+        @param    = param     unless param.nil?
+        @help     = help      unless help.nil?
+        @optional = optional  unless optional.nil?
+        @type     = type      unless type.nil?
+        @pattern  = pattern   unless pattern.nil?
+        @enum     = enum      unless enum.nil?
+        @callback = callback  unless callback.nil?
       end
 
       attr_reader :key, :optdef, :short, :long, :param, :help, :optional, :type, :pattern, :enum, :callback
-
-      def optional_param?
-        @optional
-      end
+      alias optional_param? optional
 
       def validate_and_convert(val, optdict)
         #; [!h0s0o] raises RuntimeError when value not matched to pattern.

data/test/cmdopt_test.rb

@@ -113,6 +113,13 @@ class Benry::Cmdopt::Schema::Test < MiniTest::Test
       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",
@@ -213,7 +220,7 @@ class Benry::Cmdopt::Schema::Test < MiniTest::Test
   end
 
 
-  describe '#build_option_help()' do
+  describe '#option_help()' do
 
     before do
       sc = Benry::Cmdopt::Schema.new
@@ -226,19 +233,19 @@ class Benry::Cmdopt::Schema::Test < MiniTest::Test
     end
 
     it "[!0aq0i] can take integer as width." do
-      help = @schema.build_option_help(41)
+      help = @schema.option_help(41)
       ok {help} == <<END
-  -h, --help                               : show help message.
-      --version                            : print version
-  -f, --file=<FILE>                        : filename
-  -i, --indent[=<WIDTH>]                   : enable indent
+  -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+2
+      ok {s.length} == 41+3
     end
 
     it "[!pcsah] can take format string." do
-      help = @schema.build_option_help("%-42s: %s")
+      help = @schema.option_help("%-42s: %s")
       ok {help} == <<END
 -h, --help                                : show help message.
     --version                             : print version
@@ -250,7 +257,7 @@ END
     end
 
     it "[!dndpd] detects option width automatically when nothing specified." do
-      help = @schema.build_option_help()
+      help = @schema.option_help()
       ok {help} == <<END
   -h, --help             : show help message.
       --version          : print version
@@ -262,12 +269,12 @@ END
     end
 
     it "[!v7z4x] skips option help if help message is not specified." do
-      help = @schema.build_option_help()
+      help = @schema.option_help()
       ok {help} !~ /debug/
     end
 
     it "[!to1th] includes all option help when `all` is true." do
-      help = @schema.build_option_help(nil, all: true)
+      help = @schema.option_help(nil, all: true)
       ok {help} =~ /debug/
       ok {help} == <<END
   -h, --help             : show help message.
@@ -286,7 +293,7 @@ output mode
   q, quiet:   print litte output
   c, compact: print summary output
 END
-      actual = sc.build_option_help()
+      actual = sc.option_help()
       expected = <<END
   -m, --mode=<MODE>    : output mode
                            v, verbose: print many output
@@ -325,6 +332,51 @@ END
       ok {ret} == "  %-22s : %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
+
+
+  describe '#_preferred_option_width()' do
+
+    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
+
+    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
+
+    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
 
 
@@ -839,7 +891,7 @@ class Benry::Cmdopt::Facade::Test < MiniTest::Test
   end
 
 
-  describe '#build_option_help()' do
+  describe '#option_help()' do
 
     before do
       @cmdopt = Benry::Cmdopt.new
@@ -849,7 +901,7 @@ class Benry::Cmdopt::Facade::Test < MiniTest::Test
     end
 
     it "[!dm4p8] returns option help message." do
-      help = @cmdopt.build_option_help()
+      help = @cmdopt.option_help()
       ok {help} == <<END
   -h, --help           : show help message
       --version        : print version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: benry-cmdopt
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - kwatch
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-17 00:00:00.000000000 Z
+date: 2021-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest