the_help 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58c4ca451c960bbd6f54ee05d9a786db32365e8630cd57d1730d21b1e23b4b28
-  data.tar.gz: d6b16972071beed84aebb226bf77be94e8e04bdc38ea8eb452170da903287e05
+  metadata.gz: 7c3bac0cd5079035a765ff1018c38020e8f7805b00fd0e7123da0a9fe2547e15
+  data.tar.gz: 7708a7c8c5523525b6ee909bd1395b03b898f69bb4fdab7e91b14fe6817e332c
 SHA512:
-  metadata.gz: 31854f6f5c438280a532d0f9674f10409873164fa240b06716939972d72dd28de48244dc9ab0b160d5714d9c351d5f37da2323cbf33780bcf4c62d23aeadbf2b
-  data.tar.gz: 59f1e173753355dbbaec54c1d4411c49184ff769e3a84061c5f81413e634761a9b959b86d8ffe9ff86bc54c3b2b316671bd75f477ee3fe693e7fbf7883ba6671
+  metadata.gz: a2a35d48df57043c329f3425539ca6e8aa181bd2f9b420977c5d871caab068d1a100ad8ae2d9b924dd56022340e0c0f4c5cb4587e510955627b9db428a4c2a9b
+  data.tar.gz: b91c4d0a6601a062987b77fbdb53760959b20332d8a071b216087568b1934ef99d5cd7e72dc19ecda5074c468e6d601154386a85f8c1e711aa69772b75e4433c

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    the_help (3.0.0)
+    the_help (3.1.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -118,6 +118,33 @@ call_service(MyService, foo: false)
 # raises the exception ArgumentError with the message 'foo must be true'
 ```
 
+If you want to make sure the exception's backtrace points to the correct line of code, raise the
+exception in a block provided to the `#error` method:
+
+```ruby
+class MyService < TheHelp::Service
+  authorization_policy allow_all: true
+
+  input :foo
+
+  main do
+    if foo
+      result.success 'bar'
+    else
+      result.error { raise ArgumentError.new('foo must be true') }
+    end
+  end
+end
+
+call_service(MyService, foo: false)
+# raises the exception ArgumentError with the message 'foo must be true'
+```
+
+With the block form, the backtrace will point to the line where the exception was first raised
+rather than to the `#value!` method, however all other code execution will continue until the
+point where the `#value!` method is called (as long as the exception is a subtype of
+`StandardError`.)
+
 ### Running Callbacks
 
 In some cases a simple success or error result is not sufficient to describe the various results

data/lib/the_help/service.rb

@@ -194,8 +194,16 @@ module TheHelp
         freeze
       end
 
-      def error(value)
-        self.value = value
+      def error(value = nil, &block)
+        self.value = if block_given?
+                       begin
+                        self.value = block.call
+                       rescue StandardError => e
+                         e
+                       end
+                     else
+                       value
+                     end
         self.status = :error
         freeze
       end

data/lib/the_help/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TheHelp
-  VERSION = '3.0.0'
+  VERSION = '3.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: the_help
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - John Wilger