therefore 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cde2ad4b634cd0840fe0f13cc9a4c44a5a5aba39fdaab8a4a06a8d1fa7b1f837
-  data.tar.gz: fa254e95d0954056d2baefbceb5af4d80b3ee146a4bb814880d64190d7b74632
+  metadata.gz: 0d246d3dec40b144695422a6bed485e924ba24c594ecc153dc6ec82603de37ca
+  data.tar.gz: c254bcc43eede3650a00593f9d85baf6bdb146c6d7d12fe62eb901844c8af85d
 SHA512:
-  metadata.gz: c2bcbbc471d55240369fed7cfac8520cbcc0306608727d0661409955d4391222305f904ed649ffaead4a24a387a093842a64ea0824af6797069746772b72e57b
-  data.tar.gz: e7e5048347332140a1d1c40e42a11fe35de4044f39f9f75db89e1d80e99f35719e2f3bacec61c4de959fffb195bd7cfb10323ec2bd53e74d5a45303c5cf7930f
+  metadata.gz: 913bd179a56a3548f09574a8a4732d127d35683b55a1242b70cebf5199a01af67f9a1514e78e310b60a572df7b4578650414fb3c826d26b29da5412ab9c97876
+  data.tar.gz: bc9a8140e5029e302212aec60916b72d63036e7220e3758ebf895ed12dd271a2035b0fbc6ed391689b634ac3e03627f0050c895d85aaee545c10d3a6ad499d99

data/CHANGELOG.md

@@ -8,6 +8,12 @@
 ### Bug fixes
 )-->
 
+## 1.1.0 2026-11-06
+
+### New features
+
+- Added `if` and `unless` methods.
+
 ## 1.0.1 2025-02-24
 
 ### New features

data/README.md

@@ -26,6 +26,8 @@ gem install therefore
 
 ## Usage
 
+### `therefore` and `otherwise`
+
 `obj.therefore {...}` will invoke the block, yielding `obj` to it, unless `obj` is either `nil` or `false`. If the block is invoked its result is returned, otherwise `obj` is returned:
 
 ```ruby
@@ -81,6 +83,30 @@ nil.otherwise.to_a # => [nil]
 'string'.otherwise.to_a # => []
 ```
 
+### `if` and `unless`
+
+Let's consider a regular `if...end` conditional:
+
+```ruby
+if condition
+  expression
+end
+```
+
+`therefore` and `otherwise` abstract away the condition, relying on the implicit "is it nil/false?", and use the block for the expression.
+
+`if` and `unless` do the opposite: they use the block for the condition, and return the receiver or `nil` depending on the result.
+
+```ruby
+request
+  .if(&:open?)
+  &.close!
+
+# is equivalent to
+
+request.close! if request.open?
+```
+
 ## Version numbers
 
 Therefore loosely follows [Semantic Versioning](https://semver.org/), with a hard guarantee that breaking changes to the public API will always coincide with an increase to the `MAJOR` number.

data/lib/therefore/kernel_patch.rb

@@ -18,4 +18,12 @@ module Kernel
       end
     end
   end
+
+  def if
+    self if yield self
+  end
+
+  def unless
+    self unless yield self
+  end
 end

data/lib/therefore/version.rb

@@ -1,3 +1,3 @@
 module Therefore
-  VERSION = '1.0.1'
+  VERSION = '1.1.0'
 end

data/sig/therefore.rbs

@@ -23,4 +23,7 @@ module Kernel
   def otherwise: () { (self) -> void } -> self
     | () -> Enumerator[nil]
     | (untyped) -> untyped
+
+  def if: () { (self) -> bool } -> self?
+  def unless: () { (self) -> bool } -> self?
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: therefore
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Moku S.r.l.
 - Riccardo Agatea
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-24 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Just like each, therefore relies on block semantics, so it's essentially
   an if conditional with a scope, a closure, and the ability to be chained with other
@@ -40,7 +39,6 @@ metadata:
   homepage_uri: https://github.com/moku-io/therefore
   source_code_uri: https://github.com/moku-io/therefore
   changelog_uri: https://github.com/moku-io/therefore/blob/master/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -55,8 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: A simple wrapper for if conditionals, what each is for while loops.
 test_files: []