options_by_example 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ced46483d8abae62122bb45cd0d4753408c4d93e08405a3409583ec9fcfb477
-  data.tar.gz: e8484baa8976c72154fb2da2509482d985501c08960e7e67fdf04731e307787b
+  metadata.gz: beeaa2ae22a04cfe49102108f616bad5d3fb63b00156bb34647774ba07c8def0
+  data.tar.gz: e2af434e1812a6244c276bea7b00b52b97411927ccc207e843f4866e64356d08
 SHA512:
-  metadata.gz: 22f691bf1fc36e14868996b32b15de17a1760add666aa046e6dc57fb0e09f8dad75c7c18260255930c88ea3e56a1c994285dd320a659e6c9ee92fc4ae45d3f10
-  data.tar.gz: 1d54dca36e9829f2018af7493586e18ca7d590819d112e28482c93684212adc4ccd53e5c5183d49885c927f4ddb9e23c0654874ddbceb0e617f95c6fc6b96258
+  metadata.gz: fca827e7190634ca8382ff90d074a276fd4367a609fad77b3d58a8488f85b97e3e8493fe2a717fd9a9aff3fefdde4315058c1512addaf4b1d7663f1a2dc201db
+  data.tar.gz: a2ce56d793153540e2c9c4959dc7af5aff0e73a4c32037a738a368f06128d4f35730411f8cce8875e5e1a3c153e6e4a4344de006171ca1b70d1b24737eeaf819

data/lib/options_by_example/commandline_parser.rb

@@ -41,6 +41,7 @@ class OptionsByExample
       expand_dash_number_to_dash_n_option
       raise_if_unknown_options
       parse_options
+      coerce_num_date_time_etc
 
       validate_number_of_arguments
       parse_required_arguments
@@ -114,25 +115,7 @@ class OptionsByExample
 
         if argument_name
           raise "Expected argument for option '#{option}', got none" if args.empty?
-          value = args.shift
-
-          begin
-            case argument_name
-            when 'NUM'
-              expected_type = 'an integer value'
-              value = Integer value
-            when 'DATE'
-              expected_type = 'a date (e.g. YYYY-MM-DD)'
-              value = Date.parse value
-            when 'TIME'
-              expected_type = 'a timestamp (e.g. HH:MM:SS)'
-              value = Time.parse value
-            end
-          rescue ArgumentError
-            raise "Invalid argument \"#{value}\" for option '#{option}', please provide #{expected_type}"
-          end
-
-          @argument_values[option_name] = value
+          @argument_values[option_name] = args.shift
           @option_took_argument = option
         else
           @option_took_argument = nil
@@ -142,6 +125,27 @@ class OptionsByExample
       end
     end
 
+    def coerce_num_date_time_etc
+      @option_names.each do |option, (each, argument_name)|
+        next unless value = @argument_values[each]
+        begin
+          case argument_name
+          when 'NUM'
+            expected_type = 'an integer value'
+            @argument_values[each] = Integer value
+          when 'DATE'
+            expected_type = 'a date (e.g. YYYY-MM-DD)'
+            @argument_values[each]  = Date.parse value
+          when 'TIME'
+            expected_type = 'a timestamp (e.g. HH:MM:SS)'
+            @argument_values[each]  = Time.parse value
+          end
+        rescue ArgumentError
+          raise "Invalid argument \"#{value}\" for option '#{option}', please provide #{expected_type}"
+        end
+      end
+    end
+
     def validate_number_of_arguments
       count_optional_arguments = @argument_names.values.count(:optional)
       count_required_arguments = @argument_names.values.count(:required)

data/lib/options_by_example/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 class OptionsByExample
-  VERSION = '3.3.0'
+  VERSION = '3.4.0'
 end
 
 
@@ -11,6 +11,12 @@ __END__
 # Minor version bump when backward-compatible changes or enhancements
 # Patch version bump when backward-compatible bug fixes, security updates etc
 
+3.4.0
+  - Ensure default values are coerced too
+  - Print error message to stdout
+  - New method #expect_at_most_one_except (experimental)
+  - New method #expect_at_most_one_of (experimental)
+
 3.3.0
   - Expand dash-number to dash-n option
   - Complete support for inline specification of options

data/lib/options_by_example.rb

@@ -28,8 +28,18 @@ class OptionsByExample
     puts @usage_spec.message
     exit 0
   rescue RuntimeError => err
-    puts "ERROR: #{err.message}"
-    exit 1
+    abort "ERR: #{err.message}"
+  end
+
+  def expect_at_most_one_except(*extra_options)
+    expect_at_most_one_of *(@options.keys - extra_options)
+  end
+
+  def expect_at_most_one_of(*mutually_exclusive_options)
+    provided_options = @options.keys & mutually_exclusive_options
+    if provided_options.length > 1
+      abort "ERR: Found more than one mutually-exclusive option {#{provided_options.join ', '}}"
+    end
   end
 
   def fetch(*args, &block)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: options_by_example
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.4.0
 platform: ruby
 authors:
 - Adrian Kuhn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-02-03 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: