monad-oxide 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d74a96544bd662cb0fcf3131ca119560a4c0811e27a0668b24ef4bca351c610f
-  data.tar.gz: d93aa6573dd0bc7ac9529f828b630a421e9d527d1a75b6074fe8879a7defd52e
+  metadata.gz: 33bf53ee100fbb7245db4b0c04712db889c4ec8936a86502b94ddbed696ae76a
+  data.tar.gz: a16a6e4f90f07361d99fefb05c9693e4d1176111e9cb04bb50a8fa729f3897dd
 SHA512:
-  metadata.gz: 793f5483be340bb1e5789fb29488a8c040b803848b5579fbc29e50af13006b1699fa75402bf796ead161031835c246908e7d543c98994c82d43d5a56641d8d43
-  data.tar.gz: 998649fd304a9cfe9ce05dea05b67ac88e616a3e4a8a22c707c0ff4661ac5574170a016a5d21bf1c0f610ec5de2543e0817ed71830ea59a8682b6a43e1c51ab1
+  metadata.gz: cad21e595bacf6a29985216ea7976d9e3698bcfb4365defc2d88b5bb99d15b4d4146630572f03309512d843fc1aff8fd3bd26171e8d061b6b362d93831de467a
+  data.tar.gz: c61f8e86f2058a1ba267c05c9691226c7df24aed3586a0c7431f543dce593a1b47182be3775534ad49a928b49e36d16cba2712d17335b5a9eca9f63f25f2c48d

data/lib/err.rb

@@ -188,6 +188,16 @@ module MonadOxide
       @data
     end
 
+    ##
+    # Safely unwrap the `Result`.  In the case of `Err`, this returns the
+    # wrapped value.
+    #
+    # @param _f A dummy function.  Not used.
+    # @return [T] The wrapped value.
+    def unwrap_err_or_else(f=nil, &_block)
+      @data
+    end
+
     ##
     # Safely unwrap the `Result`. In the case of `Err`, this returns the
     # provided default value.
@@ -198,5 +208,18 @@ module MonadOxide
       x
     end
 
+    ##
+    # Safely unwrap the `Result`. In the case of `Err`, this uses the provided
+    # function to produce a value.
+    #
+    # @param f [Proc<B>] The function to call. Could be a block
+    #          instead.  Takes nothing and returns a [B=Object].
+    # @yield Will yield a block that takes nothing and returns a [B=Object].
+    #        Same as `f' parameter.
+    # @return [B] The value returned from `f`.
+    def unwrap_or_else(f=nil, &block)
+      (f || block).call()
+    end
+
   end
 end

data/lib/ok.rb

@@ -146,13 +146,37 @@ module MonadOxide
       )
     end
 
+    ##
+    # Safely unwrap the `Result`.  In the case of `Ok`, this uses the provided
+    # function to produce a value.
+    #
+    # @param f [Proc<B>] The function to call. Could be a block
+    #          instead.  Takes nothing and returns a [B=Object].
+    # @yield Will yield a block that takes nothing and returns a [B=Object].
+    #        Same as `f' parameter.
+    # @return [B] The value returned from `f`.
+    def unwrap_err_or_else(f=nil, &block)
+      (f || block).call()
+    end
+
     ##
     # Safely unwrap the `Result`. In the case of `Ok`, this returns the
     # data in the Ok.
     #
-    # @param [B] x The value that will be returned.
+    # @param [B] _x The value that will be returned.
     # @return [A] The data in the Ok.
-    def unwrap_or(_)
+    def unwrap_or(_x)
+      @data
+    end
+
+    ##
+    # Safely unwrap the `Result`.  In the case of `Ok`, this returns the
+    # wrapped value.
+    #
+    # @param f [Proc<B>] A dummy function.  Not used.
+    #          instead.  Takes nothing and returns a [B=Object].
+    # @return [B] The value returned from `f`.
+    def unwrap_or_else(_f=nil, &_block)
       @data
     end
 

data/lib/result.rb

@@ -240,6 +240,21 @@ module MonadOxide
       Err.new(ResultMethodNotImplementedError.new())
     end
 
+    ##
+    # Safely unwrap the `Result` but with lazy evaluation.  In the case of
+    # `Err`, this returns the wrapped value.  For `Ok` the function provided is
+    # evaluated and its returned value is what is returned.
+    #
+    # @param f [Proc<B>] The function to call for `Ok`. Could be a block
+    #          instead.  Takes nothing and returns a [B=Object].
+    # @yield Will yield a block for `Ok` that takes nothing and returns a
+    #        [B=Object].  Same as `f' parameter.
+    # @return [T|B] The wrapped value for `Err` and the returned from `f` for
+    #               `Ok`.
+    def unwrap_err_or_else(_f)
+      raise ResultMethodNotImplementedError.new()
+    end
+
     ##
     # Attempt to safely access the `Result` data. This always returns a value
     # instead of raising an Exception. In the case of `Ok`, the data is
@@ -250,5 +265,35 @@ module MonadOxide
       Err.new(ResultMethodNotImplementedError.new())
     end
 
+    ##
+    # Safely unwrap the `Result` but with lazy evaluation.  In the case of
+    # `Ok`, this returns the wrapped value.  For `Err` the function provided is
+    # evaluated and its returned value is what is returned.
+    #
+    # @param f [Proc<B>] The function to call for `Err`. Could be a block
+    #          instead.  Takes nothing and returns a [B=Object].
+    # @yield Will yield a block for `Err` that takes nothing and returns a
+    #        [B=Object].  Same as `f' parameter.
+    # @return [T|B] The wrapped value for `Ok` and the returned from `f` for
+    #               `Err`.
+    def unwrap_or_else(_f)
+      raise ResultMethodNotImplementedError.new()
+    end
+
+    ##
+    # Safely unwrap the `Result` but with lazy evaluation.  In the case of `Ok`,
+    # this returns the wrapped value.  For `Err` the function provided is
+    # evaluated and its returned value is what is returned.
+    #
+    # @param f [Proc<B>] The function to call for `Err`. Could be a block
+    #          instead.  Takes nothing and returns a [B=Object].
+    # @yield Will yield a block for `Err` that takes nothing and returns a
+    #        [B=Object].  Same as `f' parameter.
+    # @return [T|B] The wrapped value for `Ok` and the returned from `f` for
+    #               `Err`.
+    def unwrap_or_else(_f)
+      raise ResultMethodNotImplementedError.new()
+    end
+
   end
 end

data/lib/version.rb

@@ -3,5 +3,5 @@ module MonadOxide
   # This version is locked to 0.x.0 because semver is a lie and this project
   # uses CICD to push new versions. Any commits that appear on main will result
   # in a new version of the gem created and published.
-  VERSION='0.9.0'
+  VERSION='0.11.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: monad-oxide
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Logan Barnett
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-10 00:00:00.000000000 Z
+date: 2024-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: org-ruby