djk_monads 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6f330ae60b92a91bef13cc75f8bde18a7c899d1fedd5a4b31351b1a514e95f7
-  data.tar.gz: e6c883dae9cdfea03a68114867529e055257da1927d689ad49e9b01eff153da0
+  metadata.gz: b30c229861aed4c358bf22661ceb3d8f205d2a9e8a6c5968f94ad4ffa9293eef
+  data.tar.gz: 8cb0f86b3183e0bda40c7ba494851ba3eaa8683405ea81056d6475e03f378165
 SHA512:
-  metadata.gz: da8133cfe913bd04cc44d0524adcd6cbdc6d0915532bfa04d221d151e1843b75297aa8484ceeb78c47d543e48268111ec7c5b0a6af04a0df5631b0af8321aa0d
-  data.tar.gz: e98d7fa303e01433906ef2023a9d220dab309487b1f648979f0b4ea42e55a9cef574f70f0aba99009b33ba32752e631a91d5b5692bfaa662fdf0e9003a0bc9e5
+  metadata.gz: 1b1d880512a0d912263eb913dd4dd0a744dc6738367350389ab4dcbb1379c3242c0049f9d4c96f401fb9a0b473362bcee0ad76fe5e3abe874207d7884e9cb84f
+  data.tar.gz: bed23a372a2bacdf245a9eb7076a389e11a7eee319935e48887bb3bb050307081d5db28637d665171a8d2b14109f8c05514e1a4f98a04c0824ea7ba3f29f4b71

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-10-09
+
+- Add opt-in `be_ok_result` and `be_err_result` RSpec matchers, loaded with `require "djk/monads/expectations"`
+
 ## [0.1.0] - 2026-09-25
 
 - Initial release

data/README.md

@@ -140,6 +140,22 @@ Option.none.expect(KeyError.new("no key"))
 
 Other methods: `some?`, `none?`, `unwrap_or_else { }` and `to_a` (`[value]` for a Some, `[]` for None).
 
+### RSpec matchers
+
+The gem ships `be_ok_result` and `be_err_result` matchers. They aren't loaded by `require "djk_monads"`; require them in your `spec_helper.rb`:
+
+```ruby
+require "djk/monads/expectations"
+
+expect(Result.ok(1)).to be_ok_result
+expect(Result.err("boom")).to be_err_result
+
+# Pass a class to also check the wrapped error's type
+expect(Result.err(KeyError.new("no key"))).to be_err_result(KeyError)
+```
+
+The matchers need `rspec-expectations`, which this gem doesn't depend on. Your app must have RSpec in its Gemfile, or requiring them raises a `LoadError`.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then run `bundle exec rake` to run the specs and RuboCop. CI also checks formatting with `bin/stree check`. `bin/console` opens an interactive prompt with the gem loaded.

data/lib/djk/monads/expectations/result_matchers.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "rspec/expectations"
+
+RSpec::Matchers.define :be_ok_result do
+  match { |actual| actual.is_a?(DJK::Monads::Ok) }
+
+  failure_message { |actual| "expected #{actual.inspect} to be an Ok result" }
+
+  failure_message_when_negated { |actual| "expected #{actual.inspect} not to be an Ok result" }
+end
+
+RSpec::Matchers.define :be_err_result do |expected_class = nil|
+  match { |actual| actual.is_a?(DJK::Monads::Err) && (expected_class.nil? || actual.unwrap_err!.is_a?(expected_class)) }
+
+  failure_message do |actual|
+    if expected_class.nil?
+      "expected #{actual.inspect} to be an Err result"
+    elsif actual.is_a?(DJK::Monads::Err)
+      "expected #{actual.inspect} to be an Err result of type #{expected_class}, but got #{actual.unwrap_err!.class}"
+    else
+      "expected #{actual.inspect} to be an Err result of type #{expected_class}"
+    end
+  end
+
+  failure_message_when_negated do |actual|
+    if expected_class
+      "expected #{actual.inspect} not to be an Err result of type #{expected_class}"
+    else
+      "expected #{actual.inspect} not to be an Err result"
+    end
+  end
+end

data/lib/djk/monads/expectations.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "../../djk"
+require_relative "expectations/result_matchers"

data/lib/djk/monads/version.rb

@@ -2,6 +2,6 @@
 
 module DJK
   module Monads
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: djk_monads
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Dan Kotowski
@@ -25,6 +25,8 @@ files:
 - lib/djk.rb
 - lib/djk/monads.rb
 - lib/djk/monads/err.rb
+- lib/djk/monads/expectations.rb
+- lib/djk/monads/expectations/result_matchers.rb
 - lib/djk/monads/ok.rb
 - lib/djk/monads/option.rb
 - lib/djk/monads/result.rb