optparse 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8070528a5fa8e91d067053a532c9771c71f63d16d6a31622c7ca3c6e487c425
-  data.tar.gz: e854fcd1fe22dd596fe2650e4141e59124d0f78ae492de3164b250a4d18cc9de
+  metadata.gz: 418e5857a7b44f43280185c3b47044dfeeae912cdfbb1732e1d449959d2f7ea6
+  data.tar.gz: 7bc504678e83873db67b7a70cbf70a9795e6d5c8910ad7829ecc0f161eb09e91
 SHA512:
-  metadata.gz: 3e246c2d76a0b033b8f31e4d0c850050281b6722e3d7d4ae5e11de16bc00ad337f75243b2b932b915cc45406294038d7b770c3e2150d3faab5bc674135ce6355
-  data.tar.gz: 75b3d9526ad311161ad01507616dbd60ec97714a1440d10b15702bf360a3f0d081a5cade68d25d6bed50f56ed19599d657e7fb4e56d130b50b51861d501b08ce
+  metadata.gz: 5145d4416caf4eb5a64cf415548d56ae7b533089d29b83bd16876fdbde1c644f4b260e1aa3a68010d92107e065f9197c2e0e8691997d80261c5542bbc95ff6ef
+  data.tar.gz: 37cb54b326baa9239ed1366ff2ad465352b8de03a32360f2a4d49e9214a1d6bb01916ebff354787ec378b7d7deb50b2444a1e45eac215fa335b21156ba594818

data/ChangeLog

@@ -0,0 +1,277 @@
+-*- coding: utf-8 -*-
+
+commit c80dfb1ebd9e92142de4a0719f7fb91d753c35e5
+  Author:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  AuthorDate: 2022-12-05 16:17:01 +0900
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2022-12-05 16:17:01 +0900
+
+    Bump version to 0.3.0
+
+commit fee86ef7a443e602e951ac67143a890a22e8aa3a
+  Author:     Yusuke Endoh <mame@ruby-lang.org>
+  AuthorDate: 2022-11-29 01:14:47 +0900
+  Commit:     Yusuke Endoh <mame@ruby-lang.org>
+  CommitDate: 2022-11-29 01:14:47 +0900
+
+    Fix the test failure i ruby/ruby
+
+    ```
+    $ make test-all TESTS=test/optparse/
+    ...
+
+    [148/178] TestOptionParserDidYouMean#test_raise_unknown = 0.00 s
+      1) Failure:
+    TestOptionParserDidYouMean#test_raise_unknown [/home/mame/work/ruby/test/optparse/test_optparse.rb:106]:
+    <["--bar"]> expected but was
+    <[]>.
+    ```
+
+    In the old test/unit (bundled in ruby/ruby), when a test class inherits from
+    another test class, the child class runs all the tests defined in the parent
+    class.
+    However, it looks like the new test/unit does not do so. This is because the
+    test failure does not occur in ruby/optparse.
+
+    As a tentative solution, this changes the option names in TestOptionParser to
+    avoid the name conflict with TestOptionParserDidYouMean.
+
+commit 12529653cd35ed38cb0a00d22ec0fe6e0907ce89
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-10-30 00:36:19 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-11-28 23:23:54 +0900
+
+    Add `raise_unknown` flag (#38)
+
+commit ab5073e4d8928814a1e667bb93164d6998bf2558
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-11-21 18:28:33 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-11-21 18:30:01 +0900
+
+    Use class methods of `File` over `IO`
+
+commit 51f7e060ee6e2ccab6b052e7fb14532bc3485ce2
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-10-29 22:25:42 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-10-29 22:46:59 +0900
+
+    Add tests for `load(into:)`
+
+commit 2ea626fcff72b68b5ae6e1381c28f5db94de7e94
+  Author:     Whyme Lyu <5longluna@gmail.com>
+  AuthorDate: 2022-10-29 21:46:23 +0800
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2022-10-29 22:46:23 +0900
+
+    #load() into hash (#42)
+
+    OptionParser#load learns .load(into: Hash)
+
+    Co-authored-by: Nobuyoshi Nakada <nobu@ruby-lang.org>
+
+commit fb34a1d3a36aa33a5d2a02d511fbd705887505b0
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-10-29 22:23:14 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-10-29 22:40:11 +0900
+
+    Add tests for `OptionParser#load`
+
+commit 078638ee6da875680ebcfd06efa50bb573fd1af2
+  Author:     Maciek Rząsa <maciejrzasa@gmail.com>
+  AuthorDate: 2022-10-08 12:30:12 +0200
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2022-10-08 19:30:12 +0900
+
+    Don't treat empty string as an option description
+
+commit 3bcca8a81574aaef19a6ba09f91fc1e318aadfa4
+  Author:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  AuthorDate: 2022-06-17 18:35:47 +0900
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2022-06-17 18:41:16 +0900
+
+    Update Ruby versions on GHA with ci_versions/all.json
+
+commit f2b8318631d3d265131a0b281ee730025eda9027
+  Author:     konsolebox <konsolebox@gmail.com>
+  AuthorDate: 2022-06-09 19:43:24 +0800
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2022-06-09 20:43:24 +0900
+
+    Also accept '-' as an optional argument (#35)
+
+commit e70e689deddb6c1d72e2073a5c4723b3fdfff68c
+  Author:     ydah <13041216+ydah@users.noreply.github.com>
+  AuthorDate: 2022-05-21 06:24:41 +0900
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2022-05-21 08:47:36 +0900
+
+    Fix typo in documentation
+
+    - "hypnen" -> "hyphen"
+    - "hadler" -> "handler"
+
+commit 4b47d9c24b3b143bc661c3ef5d0de9f71882b4ce
+  Author:     Jeremy Evans <code@jeremyevans.net>
+  AuthorDate: 2022-04-22 13:01:43 -0700
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2022-05-02 20:12:12 +0900
+
+    Avoid defining the same test class in multiple files
+
+    Should fix issues with parallel testing sometimes not running all
+    tests.
+
+    This should be viewed skipping whitespace changes.
+
+    Fixes [Bug #18731]
+
+commit 2bea3b38c354c3a49b5705f9f560eef522b4b1e2
+  Author:     Peter Zhu <peter@peterzhu.ca>
+  AuthorDate: 2022-04-14 11:15:57 -0400
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2022-04-15 14:21:13 +0900
+
+    Fix broken links in docs
+
+commit 3653d5b909d876d3322546a4c2157ea5a94df1b9
+  Author:     dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
+  AuthorDate: 2022-04-11 03:21:22 +0000
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2022-04-11 12:39:39 +0900
+
+    Bump actions/upload-artifact from 2 to 3
+
+    Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 2 to 3.
+    - [Release notes](https://github.com/actions/upload-artifact/releases)
+    - [Commits](https://github.com/actions/upload-artifact/compare/v2...v3)
+
+    ---
+    updated-dependencies:
+    - dependency-name: actions/upload-artifact
+      dependency-type: direct:production
+      update-type: version-update:semver-major
+    ...
+
+    Signed-off-by: dependabot[bot] <support@github.com>
+
+commit a3f0ec21b19bd26111f1025fd8434e55beef309d
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-04-04 15:05:15 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-04-04 15:05:15 +0900
+
+    Define `inspect` and `pretty_inspect`
+
+commit 482a42668e7228485b3274cfb0523af87ab44e56
+  Author:     dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
+  AuthorDate: 2022-03-25 16:56:25 +0900
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2022-03-25 16:56:25 +0900
+
+    Bump actions/checkout from 2 to 3 (#31)
+
+    Bumps [actions/checkout](https://github.com/actions/checkout) from 2 to 3.
+    - [Release notes](https://github.com/actions/checkout/releases)
+    - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
+    - [Commits](https://github.com/actions/checkout/compare/v2...v3)
+
+    ---
+    updated-dependencies:
+    - dependency-name: actions/checkout
+      dependency-type: direct:production
+      update-type: version-update:semver-major
+    ...
+
+    Signed-off-by: dependabot[bot] <support@github.com>
+
+    Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
+
+commit 5bc8b13b8806bac75f8aa0adeaa75a6631b992ec
+  Author:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  AuthorDate: 2022-03-25 16:49:09 +0900
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2022-03-25 16:49:09 +0900
+
+    Added dependabot (#30)
+
+commit 9e29d86c12819dc383e042cc0059224299a8fcd8
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-01-12 20:58:54 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-01-12 20:58:54 +0900
+
+    Fix for ruby 3.0 or earlier
+
+commit 0ac99576964657f7f44dadcca4c2546594076f88
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-01-12 19:37:33 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-01-12 19:37:33 +0900
+
+    DidYouMean::PlainFormatter is deprecated
+
+commit dab72c543db6c0c0f89a470006ae71390adf0c50
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-01-12 18:22:11 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-01-12 18:22:11 +0900
+
+    Fix links to the page directory files
+
+    https://bugs.ruby-lang.org/issues/18468
+
+commit d182cd60b58eb6bc537f23b0309cde187309056b
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-01-12 18:17:22 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-01-12 18:19:40 +0900
+
+    Add rdoc options
+
+    Specify the main page and the page directory.  Also in Rakefile,
+    extract and use the same options from the gemspec file.
+
+commit ed283559d492e917f1c28b0ece9ea9c3e1327016
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2022-01-12 18:16:30 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2022-01-12 18:19:39 +0900
+
+    Add .document files
+
+commit e4f26821283dbf7d7dba8973e332641cff3f119f
+  Author:     David Rodríguez <deivid.rodriguez@riseup.net>
+  AuthorDate: 2022-01-04 08:32:45 +0100
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2022-01-04 16:32:45 +0900
+
+    Use `require_relative` for internal requires (#28)
+
+commit faf8e5c8fba85ae2dda8d9d882de4c7016b31ec5
+  Author:     Takashi Kokubun <takashikkbn@gmail.com>
+  AuthorDate: 2021-12-14 20:49:32 -0800
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-12-14 20:49:32 -0800
+
+    s/RubyVM::JIT/RubyVM::MJIT/g (#29)
+
+commit 61df7522f80a04ce40fc7dea655d4b016f224c83
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-11-03 19:52:14 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-11-03 19:52:14 +0900
+
+    Remove the test for deprecated DidYouMean::VerboseFormatter
+
+commit 0aa18752cfcc2e9bd47afe57348ddc0fc966c981
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-11-03 18:34:13 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-11-03 18:34:13 +0900
+
+    Fix typo [ci skip]

data/doc/optparse/argument_converters.rdoc

@@ -0,0 +1,380 @@
+== Argument Converters
+
+An option can specify that its argument is to be converted
+from the default \String to an instance of another class.
+
+=== Contents
+
+- {Built-In Argument Converters}[#label-Built-In+Argument+Converters]
+  - {Date}[#label-Date]
+  - {DateTime}[#label-DateTime]
+  - {Time}[#label-Time]
+  - {URI}[#label-URI]
+  - {Shellwords}[#label-Shellwords]
+  - {Integer}[#label-Integer]
+  - {Float}[#label-Float]
+  - {Numeric}[#label-Numeric]
+  - {DecimalInteger}[#label-DecimalInteger]
+  - {OctalInteger}[#label-OctalInteger]
+  - {DecimalNumeric}[#label-DecimalNumeric]
+  - {TrueClass}[#label-TrueClass]
+  - {FalseClass}[#label-FalseClass]
+  - {Object}[#label-Object]
+  - {String}[#label-String]
+  - {Array}[#label-Array]
+  - {Regexp}[#label-Regexp]
+- {Custom Argument Converters}[#label-Custom+Argument+Converters]
+
+=== Built-In Argument Converters
+
+\OptionParser has a number of built-in argument converters,
+which are demonstrated below.
+
+==== \Date
+
+File +date.rb+
+defines an option whose argument is to be converted to a \Date object.
+The argument is converted by method Date#parse.
+
+  :include: ruby/date.rb
+
+Executions:
+
+  $ ruby date.rb --date 2001-02-03
+  [#<Date: 2001-02-03 ((2451944j,0s,0n),+0s,2299161j)>, Date]
+  $ ruby date.rb --date 20010203
+  [#<Date: 2001-02-03 ((2451944j,0s,0n),+0s,2299161j)>, Date]
+  $ ruby date.rb --date "3rd Feb 2001"
+  [#<Date: 2001-02-03 ((2451944j,0s,0n),+0s,2299161j)>, Date]
+
+==== \DateTime
+
+File +datetime.rb+
+defines an option whose argument is to be converted to a \DateTime object.
+The argument is converted by method DateTime#parse.
+
+  :include: ruby/datetime.rb
+
+Executions:
+
+  $ ruby datetime.rb --datetime 2001-02-03T04:05:06+07:00
+  [#<DateTime: 2001-02-03T04:05:06+07:00 ((2451943j,75906s,0n),+25200s,2299161j)>, DateTime]
+  $ ruby datetime.rb --datetime 20010203T040506+0700
+  [#<DateTime: 2001-02-03T04:05:06+07:00 ((2451943j,75906s,0n),+25200s,2299161j)>, DateTime]
+  $ ruby datetime.rb --datetime "3rd Feb 2001 04:05:06 PM"
+  [#<DateTime: 2001-02-03T16:05:06+00:00 ((2451944j,57906s,0n),+0s,2299161j)>, DateTime]
+
+==== \Time
+
+File +time.rb+
+defines an option whose argument is to be converted to a \Time object.
+The argument is converted by method Time#httpdate or Time#parse.
+
+  :include: ruby/time.rb
+
+Executions:
+
+  $ ruby time.rb --time "Thu, 06 Oct 2011 02:26:12 GMT"
+  [2011-10-06 02:26:12 UTC, Time]
+  $ ruby time.rb --time 2010-10-31
+  [2010-10-31 00:00:00 -0500, Time]
+
+==== \URI
+
+File +uri.rb+
+defines an option whose argument is to be converted to a \URI object.
+The argument is converted by method URI#parse.
+
+  :include: ruby/uri.rb
+
+Executions:
+
+  $ ruby uri.rb --uri https://github.com
+  [#<URI::HTTPS https://github.com>, URI::HTTPS]
+  $ ruby uri.rb --uri http://github.com
+  [#<URI::HTTP http://github.com>, URI::HTTP]
+  $ ruby uri.rb --uri file://~/var
+  [#<URI::File file://~/var>, URI::File]
+
+==== \Shellwords
+
+File +shellwords.rb+
+defines an option whose argument is to be converted to an \Array object by method
+Shellwords#shellwords.
+
+  :include: ruby/shellwords.rb
+
+Executions:
+
+  $ ruby shellwords.rb --shellwords "ruby my_prog.rb | less"
+  [["ruby", "my_prog.rb", "|", "less"], Array]
+  $ ruby shellwords.rb --shellwords "here are 'two words'"
+  [["here", "are", "two words"], Array]
+
+==== \Integer
+
+File +integer.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer.
+
+  :include: ruby/integer.rb
+
+Executions:
+
+  $ ruby integer.rb --integer 100
+  [100, Integer]
+  $ ruby integer.rb --integer -100
+  [-100, Integer]
+  $ ruby integer.rb --integer 0100
+  [64, Integer]
+  $ ruby integer.rb --integer 0x100
+  [256, Integer]
+  $ ruby integer.rb --integer 0b100
+  [4, Integer]
+
+==== \Float
+
+File +float.rb+
+defines an option whose argument is to be converted to a \Float object.
+The argument is converted by method Kernel#Float.
+
+  :include: ruby/float.rb
+
+Executions:
+
+  $ ruby float.rb --float 1
+  [1.0, Float]
+  $ ruby float.rb --float 3.14159
+  [3.14159, Float]
+  $ ruby float.rb --float 1.234E2
+  [123.4, Float]
+  $ ruby float.rb --float 1.234E-2
+  [0.01234, Float]
+
+==== \Numeric
+
+File +numeric.rb+
+defines an option whose argument is to be converted to an instance
+of \Rational, \Float, or \Integer.
+The argument is converted by method Kernel#Rational,
+Kernel#Float, or Kernel#Integer.
+
+  :include: ruby/numeric.rb
+
+Executions:
+
+  $ ruby numeric.rb --numeric 1/3
+  [(1/3), Rational]
+  $ ruby numeric.rb --numeric 3.333E-1
+  [0.3333, Float]
+  $ ruby numeric.rb --numeric 3
+  [3, Integer]
+
+==== \DecimalInteger
+
+File +decimal_integer.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer.
+
+  :include: ruby/decimal_integer.rb
+
+The argument may not be in a binary or hexadecimal format;
+a leading zero is ignored (not parsed as octal).
+
+Executions:
+
+  $ ruby decimal_integer.rb --decimal_integer 100
+  [100, Integer]
+  $ ruby decimal_integer.rb --decimal_integer -100
+  [-100, Integer]
+  $ ruby decimal_integer.rb --decimal_integer 0100
+  [100, Integer]
+  $ ruby decimal_integer.rb --decimal_integer -0100
+  [-100, Integer]
+
+==== \OctalInteger
+
+File +octal_integer.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer.
+
+  :include: ruby/octal_integer.rb
+
+The argument may not be in a binary or hexadecimal format;
+it is parsed as octal, regardless of whether it has a leading zero.
+
+Executions:
+
+  $ ruby octal_integer.rb --octal_integer 100
+  [64, Integer]
+  $ ruby octal_integer.rb --octal_integer -100
+  [-64, Integer]
+  $ ruby octal_integer.rb --octal_integer 0100
+  [64, Integer]
+
+==== \DecimalNumeric
+
+File +decimal_numeric.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer
+
+  :include: ruby/decimal_numeric.rb
+
+The argument may not be in a binary or hexadecimal format;
+a leading zero causes the argument to be parsed as octal.
+
+Executions:
+
+  $ ruby decimal_numeric.rb --decimal_numeric 100
+  [100, Integer]
+  $ ruby decimal_numeric.rb --decimal_numeric -100
+  [-100, Integer]
+  $ ruby decimal_numeric.rb --decimal_numeric 0100
+  [64, Integer]
+
+==== \TrueClass
+
+File +true_class.rb+
+defines an option whose argument is to be converted to +true+ or +false+.
+The argument is evaluated by method Object#nil?.
+
+  :include: ruby/true_class.rb
+
+The argument may be any of those shown in the examples below.
+
+Executions:
+
+  $ ruby true_class.rb --true_class true
+  [true, TrueClass]
+  $ ruby true_class.rb --true_class yes
+  [true, TrueClass]
+  $ ruby true_class.rb --true_class +
+  [true, TrueClass]
+  $ ruby true_class.rb --true_class false
+  [false, FalseClass]
+  $ ruby true_class.rb --true_class no
+  [false, FalseClass]
+  $ ruby true_class.rb --true_class -
+  [false, FalseClass]
+  $ ruby true_class.rb --true_class nil
+  [false, FalseClass]
+
+==== \FalseClass
+
+File +false_class.rb+
+defines an option whose argument is to be converted to +true+ or +false+.
+The argument is evaluated by method Object#nil?.
+
+  :include: ruby/false_class.rb
+
+The argument may be any of those shown in the examples below.
+
+Executions:
+
+  $ ruby false_class.rb --false_class false
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class no
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class -
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class nil
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class true
+  [true, TrueClass]
+  $ ruby false_class.rb --false_class yes
+  [true, TrueClass]
+  $ ruby false_class.rb --false_class +
+  [true, TrueClass]
+
+==== \Object
+
+File +object.rb+
+defines an option whose argument is not to be converted from \String.
+
+  :include: ruby/object.rb
+
+Executions:
+
+  $ ruby object.rb --object foo
+  ["foo", String]
+  $ ruby object.rb --object nil
+  ["nil", String]
+
+==== \String
+
+File +string.rb+
+defines an option whose argument is not to be converted from \String.
+
+  :include: ruby/string.rb
+
+Executions:
+
+  $ ruby string.rb --string foo
+  ["foo", String]
+  $ ruby string.rb --string nil
+  ["nil", String]
+
+==== \Array
+
+File +array.rb+
+defines an option whose argument is to be converted from \String
+to an array of strings, based on comma-separated substrings.
+
+  :include: ruby/array.rb
+
+Executions:
+
+  $ ruby array.rb --array ""
+  [[], Array]
+  $ ruby array.rb --array foo,bar,baz
+  [["foo", "bar", "baz"], Array]
+  $ ruby array.rb --array "foo, bar, baz"
+  [["foo", " bar", " baz"], Array]
+
+==== \Regexp
+
+File +regexp.rb+
+defines an option whose argument is to be converted to a \Regexp object.
+
+  :include: ruby/regexp.rb
+
+Executions:
+
+  $ ruby regexp.rb --regexp foo
+
+=== Custom Argument Converters
+
+You can create custom argument converters.
+To create a custom converter, call OptionParser#accept with:
+
+- An identifier, which may be any object.
+- An optional match pattern, which defaults to <tt>/.*/m</tt>.
+- A block that accepts the argument and returns the converted value.
+
+This custom converter accepts any argument and converts it,
+if possible, to a \Complex object.
+
+  :include: ruby/custom_converter.rb
+
+Executions:
+
+  $ ruby custom_converter.rb --complex 0
+  [(0+0i), Complex]
+  $ ruby custom_converter.rb --complex 1
+  [(1+0i), Complex]
+  $ ruby custom_converter.rb --complex 1+2i
+  [(1+2i), Complex]
+  $ ruby custom_converter.rb --complex 0.3-0.5i
+  [(0.3-0.5i), Complex]
+
+This custom converter accepts any 1-word argument
+and capitalizes it, if possible.
+
+  :include: ruby/match_converter.rb
+
+Executions:
+
+  $ ruby match_converter.rb --capitalize foo
+  ["Foo", String]
+  $ ruby match_converter.rb --capitalize "foo bar"
+  match_converter.rb:9:in `<main>': invalid argument: --capitalize foo bar (OptionParser::InvalidArgument)

data/doc/optparse/creates_option.rdoc

@@ -0,0 +1,7 @@
+Creates an option from the given parameters +params+.
+See {Parameters for New Options}[optparse/option_params.rdoc].
+
+The block, if given, is the handler for the created option.
+When the option is encountered during command-line parsing,
+the block is called with the argument given for the option, if any.
+See {Option Handlers}[optparse/option_params.rdoc#label-Option+Handlers].