philiprehberger-maybe 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 518036f3926caf1ec9b91a02bf0dfb954cd7dfbf5c6f9f622a434f99e4927dd7
-  data.tar.gz: 4689a03b925f43adb753c1367feba52208caad03b42fcb14e5faabfa88d464bd
+  metadata.gz: 341d0506aef82e712601101351cdd079ca74fbf324ddced8b42ca4bc0609c52a
+  data.tar.gz: 28b5c750f0c5026f97a85028ba053c79c6183829e75d33d9cd8a33de9944be30
 SHA512:
-  metadata.gz: 7ee4093ef79f5a1a8a9d8b3b79260fbc76091c0118334f5ec3066666cf3e763cdc901e50b2e490d3495d06c71caf314a86383d97161e4d6c93ceb908358be4e0
-  data.tar.gz: e24c606281efb3faef61b85e23661ee6172c2b223e4d59535a3150b13617b796d8a66c88945a1bf18a6259cc176de830816bfcc2bbea0ae6d479846b90824e97
+  metadata.gz: 474569f86325ff1f641682e406dc2717b8846942025eea1f4571d7e0699c2b0b07b5c3d30d6a5c14268676a658a1f87797f6706e3e03620ac6c9d976f24ab11a
+  data.tar.gz: 56554006f33e1a9deca84740b1a5f659fa3c54e69d437aac0563a827fbb52d798159a708f0fb022f58feb4ab9528c3c184a787a8c5b8d701fef512bbe0090cec

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-06-14
+
+### Added
+- `Maybe.lift(&block)` — convert any block into a Maybe-returning Proc. Wraps the block's result in `Maybe.wrap` so existing nil-returning helpers can join a Maybe pipeline without manual wrapping at every call site.
+
 ## [0.4.0] - 2026-05-08
 
 ### Added

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-maybe.svg)](https://rubygems.org/gems/philiprehberger-maybe)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-maybe)](https://github.com/philiprehberger/rb-maybe/commits/main)
 
+![philiprehberger-maybe](https://raw.githubusercontent.com/philiprehberger/rb-maybe/main/package-card.webp)
+
 Optional/Maybe monad with safe chaining and pattern matching
 
 ## Requirements
@@ -174,6 +176,14 @@ outer = Philiprehberger::Maybe.wrap(Philiprehberger::Maybe.wrap(42))
 outer.flatten.value  # => 42
 ```
 
+### Lifting Callables
+
+```ruby
+safe_parse = Philiprehberger::Maybe.lift { |s| Integer(s, exception: false) }
+safe_parse.call('42')   # => Some(42)
+safe_parse.call('abc')  # => None
+```
+
 ## API
 
 ### `Maybe`
@@ -185,6 +195,7 @@ outer.flatten.value  # => 42
 | `.first_some(*maybes)` | Return the first Some, or None if all are None |
 | `.from_bool(condition, value = nil, &block)` | Some when condition is truthy (and value/block result is non-nil), else None |
 | `.try(*error_classes, &block)` | Run block; return Some on success, None on caught errors or nil (defaults to StandardError) |
+| `.lift(&block)` | Return a Proc that wraps the block's result in Some/None |
 
 ### `Maybe::Some`
 

data/lib/philiprehberger/maybe/version.rb

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

data/lib/philiprehberger/maybe.rb

@@ -62,6 +62,21 @@ module Philiprehberger
       None.instance
     end
 
+    # Lift a plain callable into a Maybe-returning callable.
+    #
+    # Takes a block (or callable) and returns a Proc that wraps the block's
+    # result in `Maybe.wrap`. Useful for adapting existing nil-returning Ruby
+    # methods into the Maybe pipeline without manually wrapping each call site.
+    #
+    # @yield arguments forwarded to the block; the block's return value is wrapped
+    # @return [Proc] a Proc that returns Some or None
+    # @raise [Error] if no block is given
+    def self.lift(&block)
+      raise Error, 'block is required' unless block
+
+      ->(*args, **kwargs) { wrap(block.call(*args, **kwargs)) }
+    end
+
     # Container for a present value
     class Some
       include Enumerable

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-maybe
 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-05-08 00:00:00.000000000 Z
+date: 2026-06-15 00:00:00.000000000 Z
 dependencies: []
 description: A Maybe/Optional type for Ruby providing Some and None containers with
   safe chaining, pattern matching via deconstruct_keys, filtering, and value extraction.