philiprehberger-try 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b19953b62d7e9a8cf174f7d5d2c20996bcce267bebeb551658354fd0dbfd3e5
-  data.tar.gz: 23d825ef9a47e0b68394763acaf68301403569c2fcf449596e8068dc8d99465f
+  metadata.gz: 0c9450e5d2764d72177933ac79769244a27c0963e89482efa19e6e99b3ed1880
+  data.tar.gz: 92bd0ab4f69ba2ae16a1f32e6e80f4ee20cb44cebce09ac59da3621fecbe5a12
 SHA512:
-  metadata.gz: c107e212abc0e641e334f5f1a530015ba10fa4c361896f2d003e6218c40cb1a57c41dfe65a14e788412f344764f11ce5e76d134b150c7381fd8163aede0153ef
-  data.tar.gz: fc69e87c5925b572a26d77fd08824626ccc3eafb4cd80a93cdecaa84b8f0f7c5d59a5f98a42df4f2b87e1b6f11323b9799c62aadbaf3ffa52d4e421b36f82b02
+  metadata.gz: 76cf42ba98e17b49a0db796c5dca5d95e82f9538740e28dcb77322d7c784e5631a054ab20952fbcc5729a818b583ab2a6a24bdd6ae2fb2dd1e274eb0e37ccd1e
+  data.tar.gz: f958fc1f60467f1ffe1932f79b5b86087725bf9ad76a0602105d10164fb8f3d8db866a4c8f539fd71cc19e7f3130bf00051a4c0025bdde69d41babd50f62dce8

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-05-07
+
+### Added
+- `Success#map_error` and `Failure#map_error` — declaratively transform a `Failure`'s error into a different exception. `Success#map_error` is a no-op. Non-Exception block return values are wrapped in `RuntimeError` to preserve the `Failure#error` invariant.
+
 ## [0.4.0] - 2026-04-09
 
 ### Added
@@ -64,6 +69,8 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - `.map` for transforming success values
 - Optional timeout support
 
+[0.5.0]: https://github.com/philiprehberger/rb-try/releases/tag/v0.5.0
+[0.4.0]: https://github.com/philiprehberger/rb-try/releases/tag/v0.4.0
 [0.3.0]: https://github.com/philiprehberger/rb-try/releases/tag/v0.3.0
 [0.2.0]: https://github.com/philiprehberger/rb-try/releases/tag/v0.2.0
 [0.1.5]: https://github.com/philiprehberger/rb-try/releases/tag/v0.1.5

data/README.md

@@ -124,6 +124,21 @@ result = Philiprehberger::Try.call { raise ArgumentError, "bad input" }
 result.value # => "default value"
 ```
 
+### Mapping Errors
+
+Transform a `Failure`'s error into a different exception without recovering:
+
+```ruby
+require 'philiprehberger/try'
+
+result = Philiprehberger::Try.call { File.read('missing.txt') }
+                             .map_error { |e| MyError.new("read failed: #{e.message}") }
+```
+
+`Success#map_error` is a no-op. On `Failure`, the block return is wrapped in a new `Failure`. If
+the block returns a non-Exception value, it is wrapped in `RuntimeError` so that `Failure#error`
+always exposes an Exception.
+
 ### Side effects with `tap`
 
 Execute side effects without changing the result:
@@ -215,6 +230,7 @@ result.error    # => #<Timeout::Error: execution expired>
 | `#map { block }` | Wraps block result in new `Try.call` | Returns self |
 | `#flat_map { block }` | Chains block returning Try | Returns self |
 | `#recover { block }` | Returns self | Wraps block result in `Try.call` |
+| `#map_error { block }` | Returns self | Wraps block result (or `RuntimeError`) in new `Failure` |
 | `#filter { block }` | Returns self if truthy, `Failure` if falsy | Returns self |
 | `#deconstruct_keys(keys)` | `{ success: true, value: }` | `{ success: false, error: }` |
 | `#tap { block }` | Calls block, returns self | Calls block, returns self |

data/lib/philiprehberger/try/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Try
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/try.rb

@@ -90,6 +90,10 @@ module Philiprehberger
         self
       end
 
+      def map_error
+        self
+      end
+
       def filter
         return Failure.new(ArgumentError.new('filter condition not met')) unless yield @value
 
@@ -165,6 +169,12 @@ module Philiprehberger
         Try.call { yield @error }
       end
 
+      def map_error
+        new_error = yield @error
+        new_error = RuntimeError.new(new_error.to_s) unless new_error.is_a?(Exception)
+        Failure.new(new_error)
+      end
+
       def filter
         self
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-try
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-10 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
 description: A tiny utility for concise error handling. Wrap risky expressions with
   Try.call, chain fallbacks with or_else and or_try, filter with predicates, handle