errgonomic 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dc41a36e372dc0af60cb4282d28c3fd92575c1b6999a41222e4be9623ead934
-  data.tar.gz: 6d5b368f9eabb77bfc1b3e459d18e29b6767681c08e83a77faf69df0bee7dcc0
+  metadata.gz: 1490dc9d568769e95cc3d584907bf7a4bffb1af0381de3e4ce9a141736133166
+  data.tar.gz: 75fe0c80ad6ee5067aa8cce76c78f293e22ca1019b9d3415c57688c9c64ec2b9
 SHA512:
-  metadata.gz: e9e9b29acfc45cbfee45957b864c2ca0498765bd37a2066cd516a012a2397c6b6962695f5ff8844d63aeeaf177014cb16235559153d0d107557f0e4c4e35f26d
-  data.tar.gz: 1484855cc2d7b22649679924958d34694e9e7726969d179147877ebaf31a34089e83c55881b330f3b63bfa8edf1a52f0598da5cc2439b3bf7795a9e96e97580d
+  metadata.gz: 836b910b35ffd4bef2e78a7e5f72548e952a3da57f2e7642baaeeae1ba7bf93992f09b62baca76f2918836621f2dfa5780bfc56beea9c359d38d0154ae601286
+  data.tar.gz: 1fd7d78dcebdbc6eda3f54471f5e7f41c9f2f2db718ee7885489de16d9fbdbe42bf00ae842f171a32067f187abd26e7d6d93c1cb3422d893805f6c2716b7eb67

data/gemset.nix

@@ -269,7 +269,7 @@
       path = ./.;
       type = "path";
     };
-    version = "0.6.0";
+    version = "0.7.0";
   };
   erubi = {
     groups = ["default" "development"];

data/lib/errgonomic/result.rb

@@ -250,6 +250,17 @@ module Errgonomic
         Ok(block.call(value))
       end
 
+      # Map the Err(e) to an Err(f), preserving the Ok
+      #
+      # @example
+      #   Ok(:Alice).map_err { |_e| :Bob } # => Ok(:Alice)
+      #   Err(:bob).map_err { |e| e.capitalize } # => Err(:Bob)
+      def map_err(&block)
+        return self if ok?
+
+        Err(block.call(value))
+      end
+
       # Refuse to serialize an unwrapped Result as a String. Results must be
       # correctly handled to access their inner value.
       #
@@ -271,6 +282,30 @@ module Errgonomic
       def to_json(*_args)
         raise Errgonomic::SerializeError, 'cannot serialize an unwrapped Result'
       end
+
+      # @example simple pattern match with variable capture of the value
+      #   result = Errgonomic::Result::Ok.new(1)
+      #   case result
+      #   in Errgonomic::Result::Ok, value
+      #     "Measurement is #{value}"
+      #   in Errgonomic::Result::Err, err
+      #     "Measurement is not available"
+      #   end # => "Measurement is 1"
+      #
+      # @example more advanced pattern match against the kind of value
+      #   result = Errgonomic::Result::Err.new(StandardError.new("nope"))
+      #   case result
+      #   in Errgonomic::Result::Ok, value
+      #     "Measurement is #{value}"
+      #   in Errgonomic::Result::Err, String => msg
+      #     "Measurement failed with a message: #{msg}"
+      #   in Errgonomic::Result::Err, Exception => e
+      #     "Measurement produced an exception -- #{e.class}: #{e}"
+      #   end # => "Measurement produced an exception -- StandardError: nope"
+      def deconstruct
+        [self, value]
+      end
+
     end
 
     # The Ok variant.

data/lib/errgonomic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Errgonomic
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: errgonomic
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Nick Zadrozny