shellopts 2.0.6 → 2.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52971494b88f77b6b66a95e8409de7cbebcbf030588089c395424b7e86f5e372
-  data.tar.gz: e00e482a0db690c2b7bd0861589a5179a67d7cec9b285ebcc1d2b5a7b6f73ff7
+  metadata.gz: 6e8933ca7084aea3e51858cd679eec2a6b34b2fc7ae9a55ccce131947ccc7375
+  data.tar.gz: 125309b75338e9205fb05c5c556fca54cbc1cc77ef890a4ca2d6992c69eff302
 SHA512:
-  metadata.gz: 2206c1e56c4239472bf5b697854fc4d7ba06bd9dedfe4eb2f86c2e115f4ddd52f66e9b4f47cbba41b1b4eafb08b8666b2115df7f70d769465dcb3e4a344d322a
-  data.tar.gz: f9bc90bdba87159a2821afb3c719ba4c4fbc7077601266d9e61c5f83273924bc23e9fa2208bf727855fc99b6acac09a97ec3dc58be179f649c9ed6dbb4fcc259
+  metadata.gz: 123b17ded3c4943267612959f3b8ab56a37249e38ea9c338c577ad254ebc1c7c9c305ca9a7a3ee2661d9474e905ddd193c5da8e7a5adc3e711c236349095a636
+  data.tar.gz: a3115c875274fccf6628d4c839e3eac36804157f7c56e90b599e8201c1bf8f1070b5b92b7e22cbe2c6615e20b81f4de8b81233227aaccdb873f1016e129d99ae

data/TODO

@@ -1,4 +1,5 @@
 
+o Add brackets to optional option arguments: '--all=FILE?' -> '--all[=FILE]'
 o Ignore all text after ' # ' (doesn't conflict with option flag)
 o Command aliases
 o Add user-defined setions

data/lib/shellopts/args.rb

@@ -2,18 +2,23 @@
 module ShellOpts
   # Specialization of Array for arguments lists. Args extends Array with a
   # #extract and an #expect method to extract elements from the array. The
-  # methods raise a ShellOpts::UserError exception in case of errors
+  # methods raise a ShellOpts::Error exception in case of errors
   #
   class Args < Array
+    # :call-seq:
+    #   extract(count, message = nil)
+    #   extract(range, message = nil)
+    #
     # Remove and return elements from beginning of the array
     #
     # If +count_or_range+ is a number, that number of elements will be
     # returned.  If the count is one, a simple value is returned instead of an
     # array. If the count is negative, the elements will be removed from the
     # end of the array. If +count_or_range+ is a range, the number of elements
-    # returned will be in that range. The range can't contain negative numbers 
+    # returned will be in that range. Note that the range can't contain
+    # negative numbers 
     #
-    # #extract raise a ShellOpts::UserError exception if there's is not enough
+    # #extract raise a ShellOpts::Error exception if there's is not enough
     # elements in the array to satisfy the request
     #
     def extract(count_or_range, message = nil) 
@@ -30,16 +35,16 @@ module ShellOpts
           count.abs <= self.size or inoa(message)
           start = count >= 0 ? 0 : size + count
           r = slice!(start, count.abs)
-          r.size <= 0 ? nil : (r.size == 1 ? r.first : r)
+          r.size == 1 ? r.first : r
         else
           raise ArgumentError
       end
     end
 
     # As #extract except it doesn't allow negative counts and that the array is
-    # expect to be emptied by the operation
+    # expected to be emptied by the operation
     #
-    # #expect raise a ShellOpts::UserError exception if the array is not emptied 
+    # #expect raise a ShellOpts::Error exception if the array is not emptied 
     # by the operation
     #
     def expect(count_or_range, message = nil)
@@ -55,7 +60,7 @@ module ShellOpts
 
   private
     def inoa(message = nil) 
-      raise ArgumentError, message || "Illegal number of arguments"
+      raise ShellOpts::Error, message || "Illegal number of arguments"
     end
   end
 end

data/lib/shellopts/version.rb

@@ -1,3 +1,3 @@
 module ShellOpts
-  VERSION = "2.0.6"
+  VERSION = "2.0.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shellopts
 version: !ruby/object:Gem::Version
-  version: 2.0.6
+  version: 2.0.7
 platform: ruby
 authors:
 - Claus Rasmussen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-01 00:00:00.000000000 Z
+date: 2022-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: forward_to