therefore 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b48be7ef4ee5a7ab3ace829843bc2f53129feb056f01e4697c752351aee5434c
-  data.tar.gz: 0631270b4eb1b7b3d116957083af143e1c7e7866b1717cf21101abe619ef761e
+  metadata.gz: 0d246d3dec40b144695422a6bed485e924ba24c594ecc153dc6ec82603de37ca
+  data.tar.gz: c254bcc43eede3650a00593f9d85baf6bdb146c6d7d12fe62eb901844c8af85d
 SHA512:
-  metadata.gz: d51de8f98f23b3877165d6af60aabb12273bf8525c124eac96967e7ea95347838b165bd0788872cf6b5dc32505b88624d1a7bb286854a5cf90e818094f78b135
-  data.tar.gz: cefd3f2f6658fa5898d968f0cb32da6edd7aacb49f915ed637fd63d4d1e1a1b9f3e23be7ee81f15a471b9ff76dd8bffee8401f2a94ab14223f038cf0642a49fe
+  metadata.gz: 913bd179a56a3548f09574a8a4732d127d35683b55a1242b70cebf5199a01af67f9a1514e78e310b60a572df7b4578650414fb3c826d26b29da5412ab9c97876
+  data.tar.gz: bc9a8140e5029e302212aec60916b72d63036e7220e3758ebf895ed12dd271a2035b0fbc6ed391689b634ac3e03627f0050c895d85aaee545c10d3a6ad499d99

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+<!--[//]: # (
+## <Release number> <Date YYYY-MM-DD>
+### Breaking changes
+### Deprecations
+### New features
+### Bug fixes
+)-->
+
+## 1.1.0 2026-11-06
+
+### New features
+
+- Added `if` and `unless` methods.
+
+## 1.0.1 2025-02-24
+
+### New features
+
+- Added type signatures for the methods.
+
 ## 1.0.0 2023-05-04
 
 First release. Refer to [README.md](README.md) for the full documentation.

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/Rakefile

@@ -1,9 +1,6 @@
 # frozen_string_literal: true
 
 require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new :spec
 
 require 'rubocop/rake_task'
 

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.0'
+  VERSION = '1.1.0'
 end

data/sig/therefore.rbs

@@ -0,0 +1,29 @@
+class NilClass
+  def therefore: () { (self) -> void } -> self
+    | () -> Enumerator[nil]
+
+  def otherwise: [T] () { (self) -> T } -> T
+    | () -> Enumerator[class]
+    | (untyped) -> untyped
+end
+
+class FalseClass
+  def therefore: () { (self) -> void } -> self
+    | () -> Enumerator[nil]
+
+  def otherwise: [T] () { (self) -> T } -> T
+    | () -> Enumerator[class]
+    | (untyped) -> untyped
+end
+
+module Kernel
+  def therefore: [T] () { (self) -> T } -> T
+    | () -> Enumerator[self]
+
+  def otherwise: () { (self) -> void } -> self
+    | () -> Enumerator[nil]
+    | (untyped) -> untyped
+
+  def if: () { (self) -> bool } -> self?
+  def unless: () { (self) -> bool } -> self?
+end

data/therefore.gemspec

@@ -0,0 +1,30 @@
+require_relative 'lib/therefore/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'therefore'
+  spec.version = Therefore::VERSION
+  spec.authors = ['Moku S.r.l.', 'Riccardo Agatea']
+  spec.email = ['info@moku.io']
+  spec.license = 'MIT'
+
+  spec.summary = 'A simple wrapper for if conditionals, what each is for while loops.'
+  spec.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 methods.'
+  spec.homepage = 'https://github.com/moku-io/therefore'
+  spec.required_ruby_version = '>= 2.6.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/moku-io/therefore'
+  spec.metadata['changelog_uri'] = 'https://github.com/moku-io/therefore/blob/master/CHANGELOG.md'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir __dir__ do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: therefore
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Moku S.r.l.
 - Riccardo Agatea
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-04 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
@@ -20,7 +19,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
 - Gemfile
@@ -32,6 +30,8 @@ files:
 - lib/therefore/kernel_patch.rb
 - lib/therefore/nil_class_patch.rb
 - lib/therefore/version.rb
+- sig/therefore.rbs
+- therefore.gemspec
 homepage: https://github.com/moku-io/therefore
 licenses:
 - MIT
@@ -39,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
@@ -54,8 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.6
-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: []

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper