service_actor 3.1.2 → 3.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 182079e8ce5159c685b472dcecec697cd640e2006266f9f8e71b1fe829e24743
-  data.tar.gz: 28522d5045e623f0fb55ac77519720e3d76168f070c108a1785c46b322a04a9f
+  metadata.gz: 40bbf17640409642508a6cb2dc7bd7197a49266ae9639c4a97c5cf52a3696ddd
+  data.tar.gz: 6b2627086780fcbead6e4ce3feff3565eab1bc5e3181a743296e8a7099e22480
 SHA512:
-  metadata.gz: 6c4ae5e139ac02cc1244c24c8b245161cebe2246112bdfe25646c38d09f5b83d34d68f902ded72477149c1f6a928a617d1bbfbf5dd7479ee35d0d6f87c0b08a8
-  data.tar.gz: 2f0d5c297e68ba61db4467d6ef83e14ec92e12b839a5bea78d0fdd072ae08f7077676fd88cd8ad22f7e1e5790e987be69695c8bb0c465eea58d0e3a59cac7c04
+  metadata.gz: 0af13a24439bbab76ce2ae6ddf57e41b86b34c4f81e7d333650675195ab27d2519385e479bc1c41eee3c61f54253812c7e6579fea47bd7d8d17839d76a9808af
+  data.tar.gz: d25a43b1637a9dd1d79c6c0686ccc9bc2bb69dfbf0667c5a8775b1ac3fffab4c3d2233a955a17d676a0ee17b1af1a583449ac39dea220bbc02df3f82e9df6275

data/README.md

@@ -18,7 +18,7 @@ and controllers thin.
   - [Conditions](#conditions)
   - [Allow nil](#allow-nil)
   - [Types](#types)
-  - [Result](#result)
+  - [Fail](#fail)
 - [Play actors in a sequence](#play-actors-in-a-sequence)
   - [Rollback](#rollback)
   - [Lambdas](#lambdas)
@@ -103,7 +103,7 @@ class BuildGreeting < Actor
   output :greeting
 
   def call
-    self.greeting = 'Have a wonderful day!'
+    self.greeting = "Have a wonderful day!"
   end
 end
 ```
@@ -122,8 +122,8 @@ Inputs can be marked as optional by providing a default:
 ```rb
 class BuildGreeting < Actor
   input :name
-  input :adjective, default: 'wonderful'
-  input :length_of_time, default: -> { ['day', 'week', 'month'].sample }
+  input :adjective, default: "wonderful"
+  input :length_of_time, default: -> { ["day", "week", "month"].sample }
 
   output :greeting
 
@@ -136,7 +136,7 @@ end
 This lets you call the actor without specifying those keys:
 
 ```rb
-result = BuildGreeting.call(name: 'Jim')
+result = BuildGreeting.call(name: "Jim")
 result.greeting # => "Have a wonderful week Jim!"
 ```
 
@@ -149,8 +149,7 @@ result = BuildGreeting.call
 
 ### Conditions
 
-You can ensure an input is included in a collection by using `in` (unreleased
-yet):
+You can ensure an input is included in a collection by using `in`:
 
 ```rb
 class Pay < Actor
@@ -192,12 +191,12 @@ end
 
 ### Types
 
-Sometimes it can help to have a quick way of making sure we didn't mess up our
+Sometimes it can help to have a quick way of making sure we didn’t mess up our
 inputs.
 
 For that you can use the `type` option and giving a class or an array
-of possible classes. If the input or output doesn't match is not an instance of
-these types, an error is raised.
+of possible classes. If the input or output doesn’t match these types, an
+error is raised.
 
 ```rb
 class UpdateUser < Actor
@@ -212,10 +211,9 @@ You may also use strings instead of constants, such as `type: 'User'`.
 
 When using a type condition, `allow_nil` defaults to `false`.
 
-### Result
+### Fail
 
-All actors return a successful result by default. To stop the execution and
-mark an actor as having failed, use `fail!`:
+To stop the execution and mark an actor as having failed, use `fail!`:
 
 ```rb
 class UpdateUser
@@ -225,7 +223,7 @@ class UpdateUser
   def call
     user.attributes = attributes
 
-    fail!(error: 'Invalid user') unless user.valid?
+    fail!(error: "Invalid user") unless user.valid?
 
     # …
   end
@@ -235,7 +233,8 @@ end
 This will raise an error in your app with the given data added to the result.
 
 To test for the success of your actor instead of raising an exception, use
-`.result` instead of `.call` and call `success?` or `failure?` on the result.
+`.result` instead of `.call`. You can then call `success?` or `failure?` on
+the result.
 
 For example in a Rails controller:
 
@@ -253,7 +252,7 @@ class UsersController < ApplicationController
 end
 ```
 
-Any keys you add to `fail!` will be added to the result, for example you could
+The keys you add to `fail!` will be added to the result, for example you could
 do: `fail!(error_type: "validation", error_code: "uv52", …)`.
 
 ## Play actors in a sequence
@@ -302,8 +301,8 @@ anything to clean up if they call `fail!`.
 
 ### Lambdas
 
-You can use inline actions using lambdas. Inside these lambdas, you don't have
-getters and setters but have access to the shared result:
+You can use inline actions using lambdas. Inside these lambdas you have access to
+the shared result:
 
 ```rb
 class Pay < Actor
@@ -315,15 +314,15 @@ end
 ```
 
 Like in this example, lambdas can be useful for small work or preparing the
-result for the next actors. If you want to do more work before, or after the
-whole `play`, you can also override the `call` method. For example:
+result for the next actors. If you want to do more work before, after or around
+the whole `play`, you can also override the `call` method. For example:
 
 ```rb
 class Pay < Actor
   # …
 
   def call
-    Time.with_timezone('Paris') do
+    Time.with_timezone("Paris") do
       super
     end
   end
@@ -354,6 +353,8 @@ catch the exception to treat it as an actor failure:
 class PlaceOrder < Actor
   fail_on ServiceActor::ArgumentError
 
+  input :currency, in: ["EUR", "USD"]
+
   # …
 end
 ```
@@ -368,11 +369,11 @@ make it easier for you to test your application.
 
 ## Build your own actor
 
-If you application already uses an "Actor" class, you can build your own by
-changing the gem's require statement:
+If you application already uses a class called “Actor”, you can build your own
+by changing the gem’s require statement:
 
 ```rb
-gem 'service_actor', require: 'service_actor/base'
+gem "service_actor", require: "service_actor/base"
 ```
 
 And building your own class to inherit from:
@@ -387,7 +388,7 @@ end
 
 This gem is heavily influenced by
 [Interactor](https://github.com/collectiveidea/interactor) ♥.
-Some key differences make `actor` unique:
+Some key differences make Actor unique:
 
 - Does not [hide errors when an actor fails inside another
   actor](https://github.com/collectiveidea/interactor/issues/170).

data/lib/service_actor/attributable.rb

@@ -27,6 +27,9 @@ module ServiceActor
           result[name]
         end
 
+        # For avoid method redefined warning messages.
+        alias_method name, name if method_defined?(name)
+
         protected name
       end
 

data/lib/service_actor/core.rb

@@ -38,12 +38,15 @@ module ServiceActor
     # To implement in your actors.
     def rollback; end
 
+    # This method is used internally to override behavior on call. Overriding
+    # `call` instead would mean that end-users have to call `super` in their
+    # actors.
     # :nodoc:
     def _call
       call
     end
 
-    private
+    protected
 
     # Returns the current context from inside an actor.
     attr_reader :result

data/lib/service_actor/error.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module ServiceActor
-  # Standard exception from which other inherit.
+  # Standard exception from which others inherit.
   class Error < StandardError; end
 end

data/lib/service_actor/nil_checkable.rb

@@ -36,15 +36,10 @@ module ServiceActor
       end
 
       def allow_nil?(options)
-        if options.key?(:allow_nil)
-          options[:allow_nil]
-        elsif options.key?(:default) && options[:default].nil?
-          true
-        elsif options[:type]
-          false
-        else
-          true
-        end
+        return options[:allow_nil] if options.key?(:allow_nil)
+        return true if options.key?(:default) && options[:default].nil?
+
+        !options[:type]
       end
     end
   end

data/lib/service_actor/playable.rb

@@ -48,7 +48,7 @@ module ServiceActor
       end
 
       def rollback
-        return unless @played
+        return unless defined?(@played)
 
         @played.each do |actor|
           next unless actor.respond_to?(:rollback)
@@ -60,16 +60,27 @@ module ServiceActor
       private
 
       def play_actor(actor)
-        if actor.is_a?(Class) && actor.ancestors.include?(Actor)
-          actor = actor.new(result)
-          actor._call
-        else
-          new_result = actor.call(result)
-          result.merge!(new_result.to_h) if new_result.respond_to?(:to_h)
-        end
+        play_service_actor(actor) ||
+          play_interactor(actor) ||
+          actor.call(result)
+      end
+
+      def play_service_actor(actor)
+        return unless actor.is_a?(Class)
+        return unless actor.ancestors.include?(ServiceActor::Core)
+
+        actor = actor.new(result)
+        actor._call
 
         (@played ||= []).unshift(actor)
       end
+
+      def play_interactor(actor)
+        return unless actor.is_a?(Class)
+        return unless actor.ancestors.map(&:name).include?('Interactor')
+
+        result.merge!(actor.call(result).to_h)
+      end
     end
   end
 end

data/lib/service_actor/result.rb

@@ -47,7 +47,7 @@ module ServiceActor
       to_h[name]
     end
 
-    # Redefined here to override the method on `Object`.
+    # Defined here to override the method on `Object`.
     def display
       to_h.fetch(:display)
     end

data/lib/service_actor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ServiceActor
-  VERSION = '3.1.2'
+  VERSION = '3.1.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: service_actor
 version: !ruby/object:Gem::Version
-  version: 3.1.2
+  version: 3.1.3
 platform: ruby
 authors:
 - Sunny Ripert
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-28 00:00:00.000000000 Z
+date: 2022-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -156,6 +156,7 @@ metadata:
   homepage_uri: https://github.com/sunny/actor
   source_code_uri: https://github.com/sunny/actor
   changelog_uri: https://github.com/sunny/actor/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -171,7 +172,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Service objects for your application logic