dried_interaction 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bb3c6571b1286ed2e0f2b327efb07eacb17bb0f6e6edca8355d6081de014bae
-  data.tar.gz: 44c570ac8b377f963bcde0d78de4bf67e3fbe57bd39ef4216e15c31b686909b5
+  metadata.gz: 2f78458580c4604685a1e5e0115864894059552dce690536518d36f54aabfd08
+  data.tar.gz: 1b1e0e2ccfb7e71d0bde3f634895e2b01b8d0d4d1761212edd02dafb0073ee20
 SHA512:
-  metadata.gz: 19f0b433ebed93ee5d903cdf794af2827582642445ea7a21bdb0410915a54807cb9011c42b26ea131c4a3b3fc2e0df5568a63ce93a6e60b0de8fab3a246767bb
-  data.tar.gz: ddbf74d37d6e4d8cacb5a56d6e6833362122f0b3f3250ea3ddedae6835221a9b016d932b18e70bb3bcdafe6e116b6729f36b329c6912cfdaef9733459e0727cc
+  metadata.gz: 0c26753cd44cab35cd0b2d2500863ca5febbe0a4637e82419d3e041c7785aaedc6b351c336d96037ecc346d239cdc73739fbc2d3fe15334e48f7f7ed19f2c7cf
+  data.tar.gz: b03db178d0c805414d9a97faa50c407f9a75ec4d99ba36d9926a6b8fbeee19881972d6796e627db34ab1eab99bbdf881dd7686b49173cd60f4cadf92f9f440e9

data/.gitignore

@@ -6,6 +6,8 @@
 /pkg/
 /spec/reports/
 /tmp/
+dried_interaction-*.gem
+Gemfile.lock
 
 # rspec failure tracking
 .rspec_status

data/README.md

@@ -18,11 +18,6 @@ Or install it yourself as:
 
     $ gem install dried_interaction
 
-## Why it may be useful to you
-1. Keeps your business logic typed
-2. Validates interactor input data by default
-3. Includes incredible DRY stack gems by default for yours interactors
-
 ## Usage
 ### Setting up an interactor
 For setting up an interactor you need to include DriedInteraction into your class.
@@ -63,6 +58,30 @@ class PublishPost
 end
 ```
 
+### Contract options
+You can pass to contract some options which will customize contract logic.
+1. `kind`. Explains which type of validator you will use.
+Available values: `simple` (By default) and `extended`
+`simple` kind uses simple `Dry::Schema.Params`
+`extended` kind uses more complex `Dry::Validation.Contract`
+
+```rb
+  contract(kind: :simple) do ... end
+  # or
+  contract(kind: :extended) do ... end
+```
+
+2. `mode`. Explains how to handle contract validation errors.
+Available values: `strict` (By default) and `soft`
+`strict` mode raises exception when contract check fails.
+`soft`  mode returns Failure monad with error info when contract check fails.
+
+```rb
+  contract(mode: :strict) do ... end # => raise DriedInteractionError
+  # or
+  contract(mode: :soft) do ... end # => returns Failure(DriedInteractionError)
+```
+
 ### Interactor calling
 
 ```rb
@@ -77,10 +96,22 @@ PublishPost.new.call(user, params) do |interactor|
 end
 ```
 
-## Additional info
+When you use `soft` mode you can handle contract failure as divided failure case:
+```rb
+  PublishPost.new.call(user, params) do |interactor|
+  interactor.success do |post|
+    # handle success
+  end
+
+  interactor.failure(DriedInteractionError) do |error|
+    #  handle contract validation error
+  end
 
-1. You have to return a monad from interactor as result.
-2. Contract failure will be handled as exception.
+  interactor.failure do |error|
+    # handle failure
+  end
+end
+```
 
 ## Contributing
 

data/lib/dried_interaction/class_methods.rb

@@ -5,14 +5,24 @@ require 'dry/schema'
 
 module DriedInteraction
   module ClassMethods
-    attr_accessor :contract_validator
+    MODES = %i[strict soft].freeze
+    attr_accessor :contract_validator, :contract_mode
 
-    def contract(kind = :simple, &block)
+    def contract(kind: :simple, mode: MODES.first, &block)
+      @contract_mode = resolve_contract_mode(mode)
+      @contract_validator = resolve_contract_validator(kind, &block)
+    end
+
+    def resolve_contract_mode(mode)
+      MODES.include?(mode.to_sym) ? mode.to_sym : (raise ArgumentError)
+    end
+
+    def resolve_contract_validator(kind, &block)
       case kind
       when :simple
-        @contract_validator = Dry::Schema.Params(&block)
+        Dry::Schema.Params(&block)
       when :extended
-        @contract_validator = Dry::Validation.Contract(&block)
+        Dry::Validation.Contract(&block)
       else
         raise ArgumentError
       end

data/lib/dried_interaction/instance_methods.rb

@@ -1,16 +1,20 @@
 # frozen_string_literal: true
 
+require 'dry/monads'
 require 'dried_interaction/error'
 
 module DriedInteraction
   module InstanceMethods
+    include Dry::Monads[:result]
+
     def call(*args)
       interaction_contract_error('Call method allows only one argument') if args.size != 1
 
       arg = args.first
       contract = self.class.contract_validator
       contract_params = fetch_contract_params(contract)
-      check_params_presence_in_args(contract_params, arg.keys)
+      check_result = check_params_presence_in_args(contract_params, arg.keys)
+      return check_result if check_result&.failure?
 
       contract_result = contract.(arg)
       return interaction_contract_error(contract_result.errors.messages) if contract_result.failure?
@@ -32,7 +36,20 @@ module DriedInteraction
     end
 
     def interaction_contract_error(msgs)
-      raise DriedInteractionError, class: self.class.to_s, errors: Array.wrap(msgs).join('; ')
+      error = DriedInteractionError.new(class: self.class.to_s, errors: wrap_errors(msgs).join('; '))
+
+      case self.class.contract_mode
+      when :strict
+        raise error
+      when :soft
+        Failure(error)
+      else
+        raise ArgumentError
+      end
+    end
+
+    def wrap_errors(msgs)
+      msgs.is_a?(Array) ? msgs : [msgs]
     end
   end
 end

data/lib/dried_interaction/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DriedInteraction
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dried_interaction
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - gl-pv
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-04-05 00:00:00.000000000 Z
+date: 2023-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-initializer
@@ -140,7 +140,6 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- dried_interaction-0.1.0.gem
 - dried_interaction.gemspec
 - lib/dried_interaction.rb
 - lib/dried_interaction/class_methods.rb