djk_monads 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 351088f4c8de33dd072afb7fa93ef5cdbeb4bed569dde6bc1c8e4ef147f3d1d6
-  data.tar.gz: ba3766f358d52203f3de0fca4571804b5bfa0923572a896c0259147f7f2929c7
+  metadata.gz: b30c229861aed4c358bf22661ceb3d8f205d2a9e8a6c5968f94ad4ffa9293eef
+  data.tar.gz: 8cb0f86b3183e0bda40c7ba494851ba3eaa8683405ea81056d6475e03f378165
 SHA512:
-  metadata.gz: 100910e5eeb79c53b5c21fac1eb9d645848b49524c80447ed7530b437b7a1b6f80c4d7c4e83dbeb2751414217ece7718304002a2583bd5fc440b88c412be1ac5
-  data.tar.gz: 0c7eef839bba5d57f6d4cb233de7a8503de1fb3faadebda36646ce1294be648cca1f77b8f658c4735c16773e5267502b7a3071d27d5aca2b791554460421b458
+  metadata.gz: 1b1d880512a0d912263eb913dd4dd0a744dc6738367350389ab4dcbb1379c3242c0049f9d4c96f401fb9a0b473362bcee0ad76fe5e3abe874207d7884e9cb84f
+  data.tar.gz: bed23a372a2bacdf245a9eb7076a389e11a7eee319935e48887bb3bb050307081d5db28637d665171a8d2b14109f8c05514e1a4f98a04c0824ea7ba3f29f4b71

data/.gem_release.yml

@@ -0,0 +1,4 @@
+bump:
+  file: lib/djk/monads/version.rb
+release:
+  github: true

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.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/djk_monads.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "djk"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: djk_monads
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Dan Kotowski
@@ -17,6 +17,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gem_release.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
@@ -24,11 +25,14 @@ 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
 - lib/djk/monads/return_error.rb
 - lib/djk/monads/version.rb
+- lib/djk_monads.rb
 homepage: https://github.com/djkotowski/djk_monads
 licenses:
 - MIT