decoding 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b61483d249ba9fc5939de6d7b1aadf7ecc6c2ea4fceb65f927447a4d3828bcfa
-  data.tar.gz: beab3f51cec564c1bdf2bd7f40ffbc4f97280e7197e14b9e8cd5a980b3756366
+  metadata.gz: 5d613b53b493863ecae1fcbc778f5684acbbc628ad51f88fca0953889cd138d0
+  data.tar.gz: cfc4039a5bfcf182c174b0d1f037d2cbd3b610fa746904906a2209b680fb4cad
 SHA512:
-  metadata.gz: fcc99943040df23b080b84d32b0a6e8755dd2fd19c4a62befdd49970c843f0e28d96c1df885bb7c42538cc2e2b65f89d71c9ebb4f0f1da983d726bc95de39002
-  data.tar.gz: 8e53f19908fbccadb6068b851d96188d583267787631ce0c6207d61d2e2542716f44012c7ce0996b1146026ec07a764ad716c6b15d1b1c09974d3bf0994057d0
+  metadata.gz: cbe2df98d6a2b6b9588cc5ecfe5543cae21575488a09d99768f10791fdb66332f8cda35483b6e61045a8bbdb5949f900cdd69ab94cfb602e456fb05f5dbfa14e
+  data.tar.gz: e0eaddb3e027ba796f126aa500564507481847c196d139b16a51c390cb28990706be3d959bde8700857abbf2c18fc69765f79c03cd7cd16cbfd5e7a7be03be92

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.2.6]
+
+* Add `Decoding::Result#unwrap!`
+
+## [0.2.5]
+
+* Report all error messages in the `any` decoder
+
 ## [0.2.4]
 
 * Make `succeed` and `fail` proper, composable decoders

data/lib/decoding/decoders/any.rb

@@ -20,8 +20,18 @@ module Decoding
       # @param value [Object]
       # @return [Decoding::Result<Object>]
       def call(value)
-        err_proc = -> { err(failure("None of the decoders matched")) }
-        @decoders.lazy.map { _1.call(value) }.find(err_proc, &:ok?)
+        failures = []
+        @decoders.each do |decoder|
+          result = decoder.call(value)
+
+          # NOTE: we could've pattern matched here but that would create an
+          # unreachable `else` clause triggering code coverage issues. This
+          # explicit way ensures we know every code path is touched.
+          return result if result.ok?
+
+          failures << result.unwrap_err(nil)
+        end
+        err(failure("None of the decoders matched:\n#{failures.map { "  - #{_1}" }.join("\n")}"))
       end
     end
   end

data/lib/decoding/result.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 module Decoding
+  # Raised when calling {Result#unwrap!} on an `Err` value.
+  class UnwrapError < StandardError; end
+
   # A result represent the outcome of some computation that can succeed or fail.
   # The results are represented with two subclasses of `Result`: `Ok` and `Err`.
   # Each hold a single result value.
@@ -83,6 +86,14 @@ module Decoding
     # @return [Object]
     def unwrap(default_value) = default_value
 
+    # Extract the value out of a `Result` value. In case of an `Ok`, this
+    # returns the result's value. In case of an `Err`, a {UnwrapError} is
+    # raised with the error value as its message.
+    #
+    # @raise [Decoding::UnwrapError] if the result is an `Err` value.
+    # @return [Object]
+    def unwrap! = raise(UnwrapError, value.to_s)
+
     # Extract the error value out of a `Result` value. In case of an `Err`, this
     # returns the result's value. In case of an `Ok`, the given `default_value`
     # is returned.
@@ -142,6 +153,7 @@ module Decoding
 
     def ok? = true
     def unwrap(_) = value
+    def unwrap! = value
     def map = self.class.new(yield value)
 
     def and(other)

data/lib/decoding/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Decoding
-  VERSION = "0.2.4"
+  VERSION = "0.2.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: decoding
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - Arjan van der Gaag