amazing-activist 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5a9d6f3426a86d93d6affd8f54d19f7f071cb5142636c1b3b6fc2a12fbe87b9
-  data.tar.gz: d53b13cc039dee609e0d2870c560932942d3aa38009b4e7a742f7ce7ad44e9df
+  metadata.gz: ccad58a6e900c0d926811f0f5520a807665c3966efff845ac4359c00493cf0cf
+  data.tar.gz: 79b51504d7c1bea9dc76bcefe0d78697d7a3e30f15bd21c3dac8684ebaf81dac
 SHA512:
-  metadata.gz: '0549ced0fb0312fd5c4cca4cfc8ccaa0e359584c868497a5eea3caa7ad246958de12566d5f33525d555f6bbd9c3a77eb3536514d0e555b83a8a629048c3d58ff'
-  data.tar.gz: de8d63d94501dc73c61cc626e899407846af44dc8e9cb1c603e7154d57a57720adaa0897a319782a458ed9d89eff474a510777f5083206b9da902143f89060bd
+  metadata.gz: 36d6f413e5a39dbde9bf7c0aa6ef40bb58f438096ba659963536c7a2c059c135a00f88f765058edfdb53bdc572352f48f5ac6ebd3d7e4444205b9c34c85ccf51
+  data.tar.gz: 56347f7ea9356a1edfdff9f41816b34036f25184ccc7e102ebb11524371b7e3e2e1f134d17bf6644c47ebc7ffd1f36fc369f12f438c62571837f9ae48e8684b2

data/lib/amazing_activist/base.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "./irresistible"
 require_relative "./outcome"
 
 module AmazingActivist
@@ -28,14 +29,7 @@ module AmazingActivist
   # end
   # ----
   class Base
-    class << self
-      # Convenience method to initialize and immediatelly call the activity.
-      # @see #initialize
-      # @see #call
-      def call(...)
-        new(...).call
-      end
-    end
+    extend Irresistible
 
     # @param params [Hash{Symbol => Object}]
     def initialize(**params)

data/lib/amazing_activist/broken_contract_error.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "./error"
+
+module AmazingActivist
+  class BrokenContractError < Error; end
+end

data/lib/amazing_activist/contractable.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative "./broken_contract_error"
+
+module AmazingActivist
+  module Contractable
+    DEFAULT_BROKEN_OUTCOME_HANDLER = lambda do |outcome|
+      raise BrokenContractError, "#{self.class}#call returned #{outcome.class} instead of Outcome"
+    end
+    private_constant :DEFAULT_BROKEN_OUTCOME_HANDLER
+
+    protected
+
+    # @api internal
+    def broken_contract_handler
+      return @broken_contract_handler if defined?(@broken_contract_handler)
+
+      ancestors.each do |klass|
+        next unless klass < Base && klass != self
+
+        return @broken_contract_handler = klass.broken_contract_handler
+      end
+
+      @broken_contract_handler = DEFAULT_BROKEN_OUTCOME_HANDLER
+    end
+
+    private
+
+    def on_broken_outcome(&block)
+      raise ArgumentError, "Handler block required." unless block
+
+      @broken_contract_handler = block
+    end
+  end
+end

data/lib/amazing_activist/irresistible.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative "./broken_contract_error"
+require_relative "./contractable"
+require_relative "./rescuable"
+require_relative "./unwrap_error"
+
+module AmazingActivist
+  module Irresistible
+    include Contractable
+    include Rescuable
+
+    # Initialize and call activity.
+    #
+    # @see #initialize
+    # @see #call
+    def call(...)
+      activity = new(...)
+      outcome  = irresistible_call(activity)
+
+      unless outcome.is_a?(Outcome::Failure) || outcome.is_a?(Outcome::Success)
+        return activity.instance_exec(outcome, &broken_contract_handler)
+      end
+
+      outcome
+    end
+
+    private
+
+    # @api internal
+    def irresistible_call(activity)
+      activity.call
+    rescue UnwrapError => e
+      e.failure
+    rescue Exception => e # rubocop:disable Lint/RescueException
+      handler = rescue_handler_for(e)
+      raise unless handler
+
+      activity.instance_exec(e, &handler)
+    end
+  end
+end

data/lib/amazing_activist/rescuable.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module AmazingActivist
+  module Rescuable
+    protected
+
+    # @api internal
+    def rescue_handlers
+      return @rescue_handlers if defined?(@rescue_handlers)
+
+      ancestors.each do |klass|
+        next unless klass < Base && klass != self
+
+        return @rescue_handlers = klass.rescue_handlers
+      end
+
+      @rescue_handlers = [].freeze
+    end
+
+    # @api internal
+    def rescue_handlers=(new_handlers)
+      @rescue_handlers = new_handlers.freeze
+    end
+
+    private
+
+    def rescue_from(*klasses, &block)
+      raise ArgumentError, "Handler block required." unless block
+
+      klasses.each do |klass|
+        klass_name =
+          case klass
+          when Module then klass.name
+          when String then klass
+          else raise ArgumentError, "#{klass.inspect} must be an Exception class or a String referencing a class."
+          end
+
+        self.rescue_handlers += [[klass_name, block].freeze]
+      end
+    end
+
+    # @api internal
+    def rescue_handler_for(exception)
+      while exception
+        rescue_handlers.reverse_each do |klass, handler|
+          return handler if exception.is_a?(const_get(klass))
+        rescue StandardError
+          # do nothing
+        end
+
+        exception = exception.cause
+      end
+
+      nil
+    end
+  end
+end

data/lib/amazing_activist/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AmazingActivist
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amazing-activist
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Alexey Zapparov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-19 00:00:00.000000000 Z
+date: 2024-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -50,13 +50,17 @@ files:
 - lib/amazing-activist.rb
 - lib/amazing_activist.rb
 - lib/amazing_activist/base.rb
+- lib/amazing_activist/broken_contract_error.rb
+- lib/amazing_activist/contractable.rb
 - lib/amazing_activist/error.rb
+- lib/amazing_activist/irresistible.rb
 - lib/amazing_activist/locale/en.yml
 - lib/amazing_activist/locale/gl.yml
 - lib/amazing_activist/outcome.rb
 - lib/amazing_activist/outcome/failure.rb
 - lib/amazing_activist/outcome/success.rb
 - lib/amazing_activist/polyglot.rb
+- lib/amazing_activist/rescuable.rb
 - lib/amazing_activist/unwrap_error.rb
 - lib/amazing_activist/version.rb
 homepage: https://github.com/ixti/amazing-activist
@@ -64,9 +68,9 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/ixti/amazing-activist
-  source_code_uri: https://github.com/ixti/amazing-activist/tree/v0.3.0
+  source_code_uri: https://github.com/ixti/amazing-activist/tree/v0.4.0
   bug_tracker_uri: https://github.com/ixti/amazing-activist/issues
-  changelog_uri: https://github.com/ixti/amazing-activist/blob/v0.3.0/CHANGES.md
+  changelog_uri: https://github.com/ixti/amazing-activist/blob/v0.4.0/CHANGES.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []