shellopts 2.6.3 → 2.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd0eab6e9ab4b9b3f88b7e0431411d683fc4b1f0edc01a4841637083cffad482
-  data.tar.gz: e46065ac5acf79b47d96e44c1b5b9c70f9cf1f086794364b15389f1582a15501
+  metadata.gz: abc8469755c86dcf44a9c55bc94e1ff2e7666a4e7b03f64ead617ffe01b3b8ac
+  data.tar.gz: bb77b26f604d37f3a055db86b7698b1fdc95e28ee3650e11d1ea384d27cd7100
 SHA512:
-  metadata.gz: 16a38fdf11c48d499898008754ef648eda8e9ff018ba4aa914361dd08aa82028fcdcb653629a3fc13bc40145bab7a0f698703f65f3564be2a14602783b7099f5
-  data.tar.gz: '09ae9862034fbcf05d6559d8d6356ed87123d38a19b193f8881d434e762b36e3ae04390fafe506fc019fa783ae1d7d02c61c56aaf27de7389caf4a1527969538'
+  metadata.gz: fd22327ccba22437e2133aa5bd6f887a7297774712e5452c573f5cc3c8a6748dfa2981fb5b9829f3c354d444029959d0e105430cd4eee71629974834ee731a51
+  data.tar.gz: 9973cf20508104fa5f2b53d32fed51dc7944b24c11492b78612a8fc1f0c19c784b622e1809f61265019212ab27cebad4a70503a0429fe55b0fb5bde1272c8585

data/lib/shellopts/version.rb

@@ -1,3 +1,3 @@
 module ShellOpts
-  VERSION = "2.6.3"
+  VERSION = "2.6.4"
 end

data/lib/shellopts.rb

@@ -29,6 +29,7 @@ require_relative 'shellopts/formatter.rb'
 require_relative 'shellopts/dump.rb'
 
 # TODO: Describe exception handling
+# TODO: Option: float (from left to rigth), fill (fill-in everywhere)
 #
 # Notes
 #   * Two kinds of exceptions: Expected & unexpected. Expected exceptions are
@@ -132,8 +133,8 @@ module ShellOpts
     # Floating options
     attr_accessor :float
 
-    # True if ShellOpts lets exceptions through instead of writing an error
-    # message and exit
+    # Use exceptions instead of ShellOpts's error methods. Default is
+    # ShellOpts.exception that itself defalts to false. Mostly used for debug
     attr_accessor :exception
 
     # Debug: Internal variables made public
@@ -155,8 +156,7 @@ module ShellOpts
         # Floating options
         float: true,
 
-        # Let exceptions through
-        exception: false
+        exception: ::ShellOpts.exception
       )
 
       @name = name || File.basename(file)
@@ -268,7 +268,8 @@ module ShellOpts
     #
     # #error is supposed to be used when the user made an error and the usage
     # is written to help correcting the error
-    def error(subject = nil, message)
+    def error(message)
+      raise ShellOpts::Error.new(message) if ::ShellOpts.exception
       $stderr.puts "#{name}: #{message}"
       saved = $stdout
       begin
@@ -286,6 +287,7 @@ module ShellOpts
     # when the user specified the correct arguments but something else went
     # wrong during processing
     def failure(message)
+      raise ShellOpts::Failure.new(message) if ::ShellOpts.exception
       $stderr.puts "#{name}: #{message}"
       exit 1
     end
@@ -316,7 +318,7 @@ module ShellOpts
     end
 
     def handle_exceptions(&block)
-      return yield if exception
+      return yield if ::ShellOpts.exception
       begin
         yield
       rescue Error => ex
@@ -408,6 +410,12 @@ module ShellOpts
     ShellOpts.process(spec, argv, silent: silent, quiet: quiet, verbose: verbose, debug: debug, **opts)
   end
 
+  # True if ShellOpts lets exceptions through instead of writing an error
+  # message and exit
+  @exception = false
+  def self.exception = @exception
+  def self.exception=(value) @exception = value end
+
   # The instance is a ShellOpts object. 'instance.program' and 'instance.argv'
   # is the same as the values returned from ShellOpts.process
   @instance = nil
@@ -428,13 +436,15 @@ module ShellOpts
   def self.verbose?(level = 1) level <= instance.program.__verbose__ end
   def self.debug?() instance.program.__debug__ end
 
-  def self.error(subject = nil, message)
-    instance.error(subject, message) if instance? # Never returns
+  def self.error(message)
+    raise Error.new(message) if exception
+    instance.error(message) if instance? # Never returns
     $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{message}"
     exit 1
   end
 
   def self.failure(message)
+    raise Error.new(message) if exception
     instance.failure(message) if instance?
     $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{message}"
     exit 1

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: shellopts
 version: !ruby/object:Gem::Version
-  version: 2.6.3
+  version: 2.6.4
 platform: ruby
 authors:
 - Claus Rasmussen
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-18 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: forward_to
@@ -159,7 +158,6 @@ files:
 homepage: http://github.com/clrgit/shellopts
 licenses: []
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -174,8 +172,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Parse command line options and arguments
 test_files: []