getopt 1.5.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99ad66e79501d20a7843a33a34eb9f87b0e50104e2f3ebf859bd0c8438c8a8b6
-  data.tar.gz: efa7c0566bc69b9450ef3d30b58f8b19f5e96c496423f42b892ed43ca527711e
+  metadata.gz: ca47de7a2b707c120f664cddb09b52ea83437da650968259b2bca08bded4b9d6
+  data.tar.gz: 0afa07ce4a5c65753fcb9cc9e1b878b1b83cb7cdce590fbe01dda585c19e923f
 SHA512:
-  metadata.gz: a085c54bc733cde23f172ea2a64f8c68b63d857e46dea68c986025abc2b75cd43c18e9a34cd2f2d5a13beaded891759c06306ab7b30895322538c5490ccc3d63
-  data.tar.gz: b1fab5263c19e9e229d9a9d292bb4b8894a93eec47b9f92cdb70d37485b35cd4e82921aeb725ed4c47df9946fd9fa3f02b1e1627a2ed1d7de50d40689b0eefb5
+  metadata.gz: c1e31f007d67944148636e8db0b0700fd9c62399ca1b7961af769a4ccc7fa9deed32c49ba9e73daf3df099e647ede6480fe5951ff9a8ea63561c02a40e79fc78
+  data.tar.gz: f5ed551262c5e84c5b30a7c445174933081866394db9b448ac2ded94a2001597383aa1f0ebbfc699f5b9c16964b6ba2604d0801b8bcb5b566d50e0f755579474

data/{CHANGES → CHANGES.rdoc}

@@ -1,3 +1,8 @@
+== 1.5.1 - 23-Mar-2020
+* Properly add a LICENSE file since the Apache-2.0 license requires it.
+* Added explicit .rdoc extensions to the README, CHANGES and MANIFEST files,
+  mostly so they look nicer on github.
+
 == 1.5.0 - 25-Jan-2019
 * Changed license to Apache-2.0.
 

data/LICENSE

@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

data/{MANIFEST → MANIFEST.rdoc}

@@ -1,6 +1,7 @@
-* CHANGES
-* MANIFEST
-* README
+* CHANGES.rdoc
+* LICENSE
+* MANIFEST.rdoc
+* README.rdoc
 * Rakefile
 * getopt.gemspec
 * certs/djberg96_pub.pem

data/README.rdoc

@@ -0,0 +1,199 @@
+= Description
+
+Implements a simple Getopt::Std class for command line parsing, as well
+as a Getopt::Long class for more advanced command line parsing.
+
+= Installation
+
+  gem install getopt
+   
+= Synopsis
+== Getopt::Std
+
+  require 'getopt/std'
+	
+  # Look for -o with argument, and -I and -D boolean arguments
+  opt = Getopt::Std.getopts("o:ID")
+
+  if opt["I"]
+    # Do something if -I passed
+		
+  if opt["D"]
+    # Do something if -D passed
+		
+  if opt["o"]
+    case opt["o"]
+      # blah, blah, blah
+    end
+  end
+
+== Getopt::Long
+
+  require 'getopt/long'
+
+  opt = Getopt::Long.getopts(
+    ["--foo", "-f", Getopt::BOOLEAN],
+    ["--bar", "-b", Getopt::REQUIRED]
+  )
+   
+  # Or, to save your fingers some typing:
+  #
+  # require "getopt/long"
+  # include Getopt
+  # opt = Long.getopts(
+  #    ["--foo", "-f", BOOLEAN],
+  #    ["--bar", "-b", REQUIRED]
+  # )
+
+  if opt["foo"]
+    # Do something if --foo or -f passed
+
+  if opt["b"]
+    # Do something if --bar or -b passed
+
+= Class Methods
+
+  Std.getopts(switches)
+
+Takes a series of single character switches that can be accepted on the
+command line.  Those characters followed by a ':' require an argument. The
+rest are considered boolean switches.  Returns a hash, with the switches
+as the key (sans the leading '-').  For boolean switches, the value is
+either true or false.  Switches that were not passed on the command line
+do not appear in the hash.
+
+In the event that a switch that accepts an argument appears multiple times
+the value for that key becomes an array of values.
+
+  Long.getopts(switches)
+
+Takes an array of switches beginning with "--" followed by one or more
+alphanumeric or hyphen characters, or "-" followed by a single character.
+The type of argument, if any, can be specified as BOOLEAN, OPTIONAL,
+REQUIRED or INCREMENT.
+
+The array should be in the form:
+
+  # long form, short form (alias), option type
+  ["--long", "-l", Getopt::OPTION]
+
+Note that only the long form is required.  If the short form is not
+specified, it will automatically be set to the first letter of the long
+switch.  If multiple long switches with the same first character are
+listed without short switches, only the first long switch gets the short
+switch alias.
+
+If the argument type is not specified, the default is BOOLEAN.
+
+For the truly lazy, you can also pass a string of long switches (with
+no short switches or argument types). 
+
+See the 'examples' directory for more examples.
+
+= Getopt::Long argument types
+
+REQUIRED
+
+If the option is specified on the command line, it must be followed by
+a non-blank argument. This argument cannot be another switch. If this
+switch appears multiple times, the values are collected into an array.
+
+BOOLEAN
+
+If the option is specified on the command line, its value is set to true.
+It must not be followed by a non-blank argument, excluding other switches.
+Attempting to pass a boolean switch more than once will raise an error.
+
+OPTIONAL
+
+If the option is specified on the command line, it may or may not accept
+an argument, excluding other valid switches. If an argument is present,
+it's value is set to that argument.  If an argument is not present, it's
+value is set to nil.
+
+INCREMENT
+
+If the option is specified on the command line, its value is incremented
+by one for each appearance on the command line, or set to 1 if it appears
+only once.
+
+= Future Plans
+
+* Add support for negatable options so that you can do "--no-foo", for example.
+
+* Add support for numeric types, so that you don't have to manually convert
+  strings to numbers.
+
+* Allow shortcut characters for the option types, e.g. "?" for BOOLEAN, "+"
+  for INCREMENT, etc.
+
+= Known Issues
+
+== Getopt::Std
+
+You cannot squish switches that require arguments with the argument itself.
+For example, if you do Getopt::Std.getopts("o:ID"), it will not parse
+"-IDohello" properly. Instead, you must do "-IDo hello". Or, you can just
+separate the argument, e.g. "-I -D -o hello".
+
+== Getopt::Long
+
+If you mix and match compressed switches with separate, optional switches
+the optional switch will be set to true instead of nil if it separated
+from the compressed switches.
+   
+== Reporting Issues
+
+If you find any other issues, please log them on the project
+page at https://github.com/djberg96/getopt.
+
+= Other Stuff
+
+Neither class attempts to be POSIX compliant in any way, shape or form. And I don't care!
+
+= Notes From the Author
+
+My main gripe with the getoptlong library currently in the standard library
+is that it doesn't return a hash, yet gives you partial hash behavior. This
+was both confusing and annoying, since the first thing I do (along with
+everyone else) is collect the results into a hash for later processing.
+
+My main gripe with the optparse library (also in the standard library) is
+that it treats command line processing like event processing. It's too
+complex, when 90% of the time all you want to do is slurp the command line
+options into a hash.
+
+So, I did something utterly novel with this library. I collected the command
+line options ... (wait for it) ... into a hash! Then I give that hash to
+you, aliases and all. I did get some ideas from Perl's Getopt::Long library,
+but this is in no way a port of that module (which supports POSIX parsing, GNU
+parsing, more option types, etc). My goal was to provide the functionality
+that I felt would cover the vast majority of common cases, yet still provide
+a little extra spice with switch types (REQUIRED, OPTIONAL, etc).
+
+There are a few extra things I plan to add (see the 'Future Plans' above) but
+I do not plan on this library ever becoming as feature rich as, say, Perl's
+Getopt::Long module.
+   
+If you plan to write a full fledged command line application, e.g. you plan
+on implementing a full help system, gobs of command line options and tons of
+switches, consider Jim Freeze's 'commandline' gem.
+
+= Warranty
+
+This package is provided "as is" and without any express or
+implied warranties, including, without limitation, the implied
+warranties of merchantability and fitness for a particular purpose.
+
+= License
+
+Apache-2.0
+
+= Copyright
+
+(C) 2005-2020, Daniel J. Berger
+All Rights Reserved
+
+= Author
+
+Daniel J. Berger

data/getopt.gemspec

@@ -2,7 +2,7 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'getopt'
-  spec.version    = '1.5.0'
+  spec.version    = '1.5.1'
   spec.author     = 'Daniel J. Berger'
   spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'
@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.files      = Dir['**/*'].reject{ |f| f.include?('git') }
   spec.cert_chain = Dir['certs/*']
 
-  spec.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
+  spec.extra_rdoc_files  = ['README.rdoc', 'CHANGES.rdoc', 'MANIFEST.rdoc']
    
   spec.add_development_dependency('test-unit', '>= 2.5.0')
   spec.required_ruby_version = '>= 2.2.0'

data/lib/getopt/version.rb

@@ -1,6 +1,6 @@
 module Getopt
   module Version
     # The version of the getopt library
-    VERSION = '1.5.0'.freeze
+    VERSION = '1.5.1'.freeze
   end
 end

data/test/test_getopt_long.rb

@@ -14,7 +14,7 @@ class TC_Getopt_Long < Test::Unit::TestCase
   end
 
   def test_version
-    assert_equal('1.5.0', Long::VERSION)
+    assert_equal('1.5.1', Long::VERSION)
     assert_true(Long::VERSION.frozen?)
   end
 

data/test/test_getopt_std.rb

@@ -10,7 +10,7 @@ include Getopt
 
 class TC_Getopt_Std < Test::Unit::TestCase
   def test_version
-    assert_equal('1.5.0', Std::VERSION)
+    assert_equal('1.5.1', Std::VERSION)
     assert_true(Std::VERSION.frozen?)
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: getopt
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -60,16 +60,14 @@ email: djberg96@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README
-- CHANGES
-- MANIFEST
+- README.rdoc
+- CHANGES.rdoc
+- MANIFEST.rdoc
 files:
+- LICENSE
 - test
 - test/test_getopt_long.rb
 - test/test_getopt_std.rb
-- CHANGES
-- MANIFEST
-- README
 - Rakefile
 - certs
 - certs/djberg96_pub.pem
@@ -84,7 +82,10 @@ files:
 - lib/getopt/version.rb
 - lib/getopt-long.rb
 - lib/getopt-std.rb
+- CHANGES.rdoc
+- MANIFEST.rdoc
 - getopt.gemspec
+- README.rdoc
 homepage: https://github.com/djberg96/getopt
 licenses:
 - Apache-2.0
@@ -110,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Getopt::Std and Getopt::Long option parsers for Ruby

data/README

@@ -1,191 +0,0 @@
-= Description
-  Implements a simple Getopt::Std class for command line parsing, as well
-  as a Getopt::Long class for more advanced command line parsing.
-
-= Installation
-
-  gem install getopt
-   
-= Synopsis
-== Getopt::Std
-
-  require 'getopt/std'
-	
-  # Look for -o with argument, and -I and -D boolean arguments
-  opt = Getopt::Std.getopts("o:ID")
-
-  if opt["I"]
-    # Do something if -I passed
-		
-  if opt["D"]
-    # Do something if -D passed
-		
-  if opt["o"]
-    case opt["o"]
-      # blah, blah, blah
-    end
-  end
-
-== Getopt::Long
-
-  require 'getopt/long'
-
-  opt = Getopt::Long.getopts(
-    ["--foo", "-f", Getopt::BOOLEAN],
-    ["--bar", "-b", Getopt::REQUIRED]
-  )
-   
-  # Or, to save your fingers some typing:
-  #
-  # require "getopt/long"
-  # include Getopt
-  # opt = Long.getopts(
-  #    ["--foo", "-f", BOOLEAN],
-  #    ["--bar", "-b", REQUIRED]
-  # )
-
-  if opt["foo"]
-    # Do something if --foo or -f passed
-
-  if opt["b"]
-    # Do something if --bar or -b passed
-
-= Class Methods
-
-Std.getopts(switches)
-
-  Takes a series of single character switches that can be accepted on the
-  command line.  Those characters followed by a ':' require an argument. The
-  rest are considered boolean switches.  Returns a hash, with the switches
-  as the key (sans the leading '-').  For boolean switches, the value is
-  either true or false.  Switches that were not passed on the command line
-  do not appear in the hash.
-
-  In the event that a switch that accepts an argument appears multiple times
-  the value for that key becomes an array of values.
-
-Long.getopts(switches)
-
-  Takes an array of switches beginning with "--" followed by one or more
-  alphanumeric or hyphen characters, or "-" followed by a single character.
-  The type of argument, if any, can be specified as BOOLEAN, OPTIONAL,
-  REQUIRED or INCREMENT.
-
-  The array should be in the form:
-
-  # long form, short form (alias), option type
-  ["--long", "-l", Getopt::OPTION]
-
-  Note that only the long form is required.  If the short form is not
-  specified, it will automatically be set to the first letter of the long
-  switch.  If multiple long switches with the same first character are
-  listed without short switches, only the first long switch gets the short
-  switch alias.
-
-  If the argument type is not specified, the default is BOOLEAN.
-
-  For the truly lazy, you can also pass a string of long switches (with
-  no short switches or argument types). 
-
-  See the 'examples' directory for more examples.
-
-= Getopt::Long argument types
-
-REQUIRED
-  If the option is specified on the command line, it must be followed by
-  a non-blank argument.  This argument cannot be another switch. If this
-  switch appears multiple times, the values are collected into an array.
-
-BOOLEAN
-  If the option is specified on the command line, its value is set to true.
-  It must not be followed by a non-blank argument, excluding other switches.
-  Attempting to pass a boolean switch more than once will raise an error.
-
-OPTIONAL
-  If the option is specified on the command line, it may or may not accept
-  an argument, excluding other valid switches.  If an argument is present,
-  it's value is set to that argument.  If an argument is not present, it's
-  value is set to nil.
-
-INCREMENT
-  If the option is specified on the command line, its value is incremented
-  by one for each appearance on the command line, or set to 1 if it appears
-  only once.
-
-= Future Plans
-  Add support for negatable options so that you can do "--no-foo", for
-  example.
-
-  Add support for numeric types, so that you don't have to manually convert
-  strings to numbers.
-
-  Allow shortcut characters for the option types, e.g. "?" for BOOLEAN, "+"
-  for INCREMENT, etc.
-
-= Known Issues
-
-== Getopt::Std
-
-  You cannot squish switches that require arguments with the argument itself.
-  For example, if you do Getopt::Std.getopts("o:ID"), it will not parse
-  "-IDohello" properly.  Instead, you must do "-IDo hello".  Or, you can just
-  separate the argument, e.g. "-I -D -o hello".
-
-== Getopt::Long
-
-  If you mix and match compressed switches with separate, optional switches
-  the optional switch will be set to true instead of nil if it separated
-  from the compressed switches.
-   
-== Reporting Issues
-
-  If you find any other issues, please log them on the project
-  page at https://github.com/djberg96/getopt.
-
-= Other Stuff
-
-  Neither class attempts to be POSIX compliant in any way, shape or form.
-  And I don't care!
-
-= Notes From the Author
-
-  My main gripe with the getoptlong library currently in the standard library
-  is that it doesn't return a hash, yet gives you partial hash behavior.  This
-  was both confusing and annoying, since the first thing I do (along with
-  everyone else) is collect the results into a hash for later processing.
-
-  My main gripe with the optparse library (also in the standard library) is
-  that it treats command line processing like event processing.  It's too
-  complex, when 90% of the time all you want to do is slurp the command line
-  options into a hash.
-
-  So, I did something utterly novel with this library.  I collected the command
-  line options ... (wait for it) ... into a hash!  Then I give that hash to
-  you, aliases and all.  I did get some ideas from Perl's Getopt::Long library,
-  but this is in no way a port of that module (which supports POSIX parsing, GNU
-  parsing, more option types, etc).  My goal was to provide the functionality
-  that I felt would cover the vast majority of common cases, yet still provide
-  a little extra spice with switch types (REQUIRED, OPTIONAL, etc).
-
-  There are a few extra things I plan to add (see the 'Future Plans' above) but
-  I do not plan on this library ever becoming as feature rich as, say, Perl's
-  Getopt::Long module.
-   
-  If you plan to write a full fledged command line application, e.g. you plan
-  on implementing a full help system, gobs of command line options and tons of
-  switches, consider Jim Freeze's 'commandline' gem.
-
-= Warranty
-  This package is provided "as is" and without any express or
-  implied warranties, including, without limitation, the implied
-  warranties of merchantability and fitness for a particular purpose.
-
-= License
-  Apache-2.0
-
-= Copyright
-  (C) 2005-2019, Daniel J. Berger
-  All Rights Reserved
-
-= Author
-  Daniel J. Berger