slayer 0.5.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f88c862cf4596840150934c88372a6cda656557e34da5a3918e98f19b159c645
-  data.tar.gz: 84d431982bad263f5a8cad99e3cd7fdb62610b9b75a80621c8ad457d01f93600
+  metadata.gz: 8afcb532ebe21d444e89baf763a76b20cf4ab19ad1bf51d45bfbd29042f3ec16
+  data.tar.gz: 5f77a3a44acf2cd3a2888f38e67963b22866c5c81a44a628be1c28128d128812
 SHA512:
-  metadata.gz: e390d010a072ec169f4c8a776547a4e3d562599db94a11a91534c7f0a2cc0667ce10c94fcfe765de658edb1bd477f38a4ac14b1972cbc183c03c666391193fbf
-  data.tar.gz: 13adcd8d46c0e28e1f4c243426ca1ad628157ca056d8298932dbdbf946d288661358a1c6e2a6ebbcf2e497a9efea45811579cb6063c28e46e80410f1a6f6d0e4
+  metadata.gz: f383e130f4d8bef5d42f9de29db7890f585c8116f3f6ea093cb83fc3c8b29b608ee82b16e881130527adedaf36761e216985d8b13208abac93bfef74739d53c7
+  data.tar.gz: 2b96b3b9473ad470033138e8f201a6fc5cdc893c2724fa4e0de1a0c7e820af93256d91569fe67f2a36dc66191f0956cf5ba45c11394e6d7778d015ee2633e7cb

data/README.md

@@ -261,6 +261,39 @@ RSpec.describe RSpecCommand do
 end
 ```
 
+#### Stubbing Command Results
+
+The RSpec helpers provide two utility functions for use in your tests which should simplify testing commands with stubbed results. This can be useful when you want
+test a Rails controller, and your command is already tested separately. In this case, you only really care about the logic in your matching blocks --- not in the command itself.
+
+Put another way: this is useful when you want to test the success or failure conditions of your commands.
+
+```ruby
+RSpec.describe FooController, type: :controller do do
+  context 'successful command' do
+    let(:foo) { create(:foo) }
+    let(:fake_res) { fake_result(ok: true, message: 'foo updated') }
+
+    describe '#update' do
+      # Foo will not be called, instead we will get back the stubbed response
+      # from the let block above, allowing us to bypass the command logic and
+      # test only the controller logic
+      stub_command_response(UpdateFooCommand, fake_res)
+      post :update, params: { id: foo.id }
+      expect(response).to have_http_status :ok
+    end
+  end
+end
+
+```
+
+This method --- `stub_command_response` --- can take the return value as either a second argument, or as a block:
+
+```ruby
+stub_command_response(UpdateFooCommand, fake_res)     # => fake result as an argument
+stub_command_response(UpdateFooCommand) { fake_res }  # => fake result as a block
+```
+
 ### Minitest
 
 To use with Minitest, update your 'test_helper' file to include:

data/lib/slayer/command.rb

@@ -4,15 +4,11 @@ module Slayer
       def call(*args, &block)
         instance = self.new
 
-        begin
-          res = instance.call(*args, &block)
-        rescue ResultFailureError => e
-          res = e.result
-        end
+        res = __get_result(instance, *args, &block)
+        handle_match(res, instance, block) if block_given?
 
         raise CommandNotImplementedError unless res.is_a? Result
 
-        handle_match(res, instance, block) if block_given?
         return res
       end
       ruby2_keywords :call if respond_to?(:ruby2_keywords, true)
@@ -30,6 +26,18 @@ module Slayer
         raise ResultFailureError, err(value: value, status: status, message: message)
       end
 
+      def __get_result(instance, *args, &block)
+        res = nil
+
+        begin
+          res = instance.call(*args, &block)
+        rescue ResultFailureError => e
+          res = e.result
+        end
+
+        res
+      end
+
       private
 
       def handle_match(res, instance, block)

data/lib/slayer/rspec.rb

@@ -1,3 +1,4 @@
+require 'rspec/mocks'
 require 'rspec/expectations'
 
 # rubocop:disable Metrics/BlockLength
@@ -92,3 +93,25 @@ RSpec::Matchers.define :be_err_result do
 end
 
 # rubocop:enable Metrics/BlockLength
+
+module Slayer
+  module RspecHelpers
+    def stub_command_response(klass, res = nil, &block)
+      res = block.call if block_given? && res.nil?
+
+      expect(klass).to receive(:__get_result).and_return(res)
+    end
+
+    # rubocop:disable Naming/MethodParameterName
+    def fake_result(ok: true, value: nil, message: nil, status: nil)
+      res = Slayer::Result.new(value, status, message)
+      res.fail unless ok == true
+
+      res
+    end
+
+    # rubocop:enable Naming/MethodParameterName
+  end
+end
+
+RSpec.configure { |config| config.include Slayer::RspecHelpers }

data/lib/slayer/version.rb

@@ -1,3 +1,3 @@
 module Slayer
-  VERSION = '0.5.1'
+  VERSION = '0.5.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slayer
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.2
 platform: ruby
 authors:
 - Wyatt Kirby
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-02-03 00:00:00.000000000 Z
+date: 2023-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: virtus