axn 0.1.0.pre.alpha.2.1 → 0.1.0.pre.alpha.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20198518e83064e97c25335dbcb2be0a88affe103dcd1aaf8ca3965a964cbeb4
-  data.tar.gz: 70707f0966255c4c0015953fea14a3b42d1bcc2c1e54b896a8ea20c4e5effb3b
+  metadata.gz: dcfb310e364c4fb2c7159a6bdc1ff6766c0025b3b0741a62316d3e18cb5f3bf7
+  data.tar.gz: 7af1c3d88a69c0d109983c85fb6dc1b5ddf162568ee1e1aa516f15bf1d12a1d2
 SHA512:
-  metadata.gz: 781768348b4b08267f34956a94b4a4ab0ef470123d9d084cfb6fd24fb1ab02b6c03f979206a57d828f675ec21b7754672bfbaed10acd8bf222f6efc374c90b39
-  data.tar.gz: d81788b26c3b313fa3d21fb2d7d763109839659eff4d0bc8af0251a7ee93ef77ee121df1f023dad4f71ed63eb94b355d7469cfcac5e21dab4fcbec126f40ea88
+  metadata.gz: 13868e68f4a7b9a45bebbcf793bba1855ec2fa524ccd6f24fdaf1364bb143fcd4cfd862f0906d6455d10e61492b723ffbdc2c836a887052b030d509bf18171b0
+  data.tar.gz: 53014437d7a3972ec584195b2c20955ff9f2c1138dba3eeb35df2e82db8d62ec3b3561ec6b1d870472fc7fcea79dd1c2abe759cf341c46e024ae143d266bfa64

data/CHANGELOG.md

@@ -1,7 +1,9 @@
 # Changelog
 
 ## UNRELEASED
-* N/A
+
+## 0.1.0-alpha.2.2
+* Expands `Action::Result.ok` and `Action::Result.error` to better support mocking in specs
 
 ## 0.1.0-alpha.2.1
 * Expects/Exposes: Add `allow_nil` option

data/docs/recipes/testing.md

@@ -4,7 +4,36 @@
 * TODO: document testing patterns
 :::
 
-Configuring rspec to treat files in spec/actions as service specs:
+## Mocking Axn calls
+
+Say you're writing unit specs for PrimaryAction that calls Subaction, and you want to mock out the Subaction call.
+
+To generate a successful Action::Result:
+
+* Base case: `Action::Result.ok`
+* [Optional] Custom message: `Action::Result.ok("It went awesome")`
+* [Optional] Custom exposures: `Action::Result.ok("It went awesome", some_var: 123)`
+
+To generate a failed Action::Result:
+
+* Base case: `Action::Result.error`
+* [Optional] Custom message: `Action::Result.error("It went poorly")`
+* [Optional] Custom exposures: `Action::Result.error("It went poorly", some_var: 123)`
+* [Optional] Custom exception: `Action::Result.error(some_var: 123) { raise FooBarException.new("bad thing") }`
+
+Either way, using those to mock an actual call would look something like this in your rspec:
+
+```ruby
+let(:subaction_response) { Action::Result.ok("custom message", foo: 1) }
+
+before do
+  expect(Subaction).to receive(:call).and_return(subaction_response)
+end
+```
+
+## RSpec configuration
+
+Configuring rspec to treat files in spec/actions as service specs (very optional):
 
 ```ruby
 RSpec.configure do |config|

data/lib/action/core/context_facade.rb

@@ -94,11 +94,21 @@ module Action
   class Result < ContextFacade
     # For ease of mocking return results in tests
     class << self
-      def ok = Class.new { include(Action) }.call
+      def ok(msg = nil, **exposures)
+        Axn::Factory.build(exposes: exposures.keys, messages: { success: msg }) do
+          exposures.each do |key, value|
+            expose(key, value)
+          end
+        end.call
+      end
 
-      def error(msg = "Something went wrong")
-        Class.new { include(Action) }.tap do |klass|
-          klass.define_method(:call) { fail!(msg) }
+      def error(msg = nil, **exposures, &block)
+        Axn::Factory.build(exposes: exposures.keys, messages: { error: msg }) do
+          exposures.each do |key, value|
+            expose(key, value)
+          end
+          block.call if block_given?
+          fail!
         end.call
       end
     end

data/lib/axn/factory.rb

@@ -71,7 +71,7 @@ module Axn
             axn.exposes(field, **opts)
           end
 
-          axn.messages(**messages) if messages.present?
+          axn.messages(**messages) if messages.present? && messages.values.any?(&:present?)
 
           # Hooks
           axn.before(before) if before.present?

data/lib/axn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Axn
-  VERSION = "0.1.0-alpha.2.1"
+  VERSION = "0.1.0-alpha.2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: axn
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.2.1
+  version: 0.1.0.pre.alpha.2.2
 platform: ruby
 authors:
 - Kali Donovan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-12 00:00:00.000000000 Z
+date: 2025-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel