dryer_services 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba13ef8192d27da5fda2b291efb698e4fc11638b2e46e8faad4108aeba7129fa
-  data.tar.gz: 6624e849a4b7c36ae41900bf41aee44d5303fb1443f0654d49a13b3bce60450d
+  metadata.gz: 5da96272749622ca4b98bae9f6d151a56826dc87641c2e5cc609f93e46a4dd13
+  data.tar.gz: a40fb9f8d0640629cdc1c9b6424786cbc3509169b448b66dfc328f079ffccb4b
 SHA512:
-  metadata.gz: d01980e96ed796b2b0c292fd1763a579daddb0aaf03f5ad74ddcf6d25a76109c9481d49b9cd00aa6c1496df95d13d6d6addd4d6784dff33cdbdced444275f028
-  data.tar.gz: 5a9447e7d141ba65dc7398e55ba22a35f47330d8c4b6f70f9ec12619aa513e472167eda4142a77f7dc421781d58bdef12dbe66339e2d0d7108d982102a236fa0
+  metadata.gz: 788649f164868cfbc12115a9f2a1292907aec9e59a7dde02ad16a581e228b38da8674059ef578de3b37f8db159f58bb23ab09ac9ae844b630612b288bee5ab34
+  data.tar.gz: a12edffd82da0f701c91c5e0f085f50dcf55a289c59adeabe2e7520296c149759e36c14f4bbf0131b738484b69e4627684359195ad522fbdce57c76e4f5bfbb9

data/README.md

@@ -37,13 +37,23 @@ end
 Add.call(1,2) # returns 3
 ```
 
-### ResultService Example
-
-Result Service wraps the value returned from `call` in a `Dry::Monad::Result`.
-If the return value is an Error, it will return a Failure. If the return value
-is already a `Dry::Monad::Result`, it will not wrap the result, otherwise it
-will wrap the result in a `Dry::Monads::Success`
-
+### ResultService Examples
+
+ResultService wraps the value returned from `call` in a `Dry::Monad::Result`.
+There are several cases
+    - If the return value is an Error, it will return a Failure
+    - If the return value is not an Error, and is not a Result, it will wrap the
+      return value in a Result
+    - If the return value is a list of Results eg [Success(1), Success(2)] it
+      will condense those results into a single Result eg Success([1,2]). If any
+      of the results in the list are Failures eg [Success(1), Failure(2)], It
+      will return the first failure encountered eg Failure(2). Changing a list
+      of Monads (Results) into a Monad containing a list of values, is called
+      'traversing'
+   - If the return value is already a `Dry::Monad::Result`, it will not wrap the
+     result
+
+#### Wrapping an error in a Failure
 ```
 class Divide < Dryer::Services::ResultService
     def initialize(a, b)
@@ -53,7 +63,7 @@ class Divide < Dryer::Services::ResultService
 
     def call
         if b == 0
-            StandError.new("Can not divide by zero")
+            StandardError.new("Can not divide by zero")
         else
             a/b
         end
@@ -63,23 +73,41 @@ class Divide < Dryer::Services::ResultService
     attr_reader :a, :b
 end
 
-Add.call(4,2) # returns Dry::Monads::Success(2)
-Add.call(4,0) # returns Dry::Monads::Failure("Can not divide by zero")
+Divide.call(4,2) # returns Dry::Monads::Success(2)
+Divide.call(4,0) # returns Dry::Monads::Failure("Can not divide by zero")
+```
+
+#### Traversing a list of results
+```
+class DivideMany < Dryer::Services::ResultService
+    def initialize(a, b)
+        @a = a
+        @b = b
+    end
+
+    def call
+        # each call to Divide returns a Result
+        # so we are returning a list of Results
+        a.map { |x| Divide.call(x,b) }
+    end
+
+    private
+    attr_reader :a, :b
+end
+
+DivideMany.call([2,4,6],2) # returns Dry::Monads::Success([1,2,3])
+DivideMany.call([2,4,6],0) # returns Dry::Monads::Failure("Can not divide by zero")
 ```
 
 ## Advantages
 Using the Service pattern can help to make code more modular, and make it easier
 to separate data modeling from transformations.
 
-# Development
-This gem is set up to be developed using [Nix](https://nixos.org/)
-Once you have nix installed you can run
-`make env`
-to enter the development environment. Then run `make` to see other available
-commands
-
-If you don't want to use nix, all the scripts can be run directly from the
-`scripts` directory.
+## Development
+This gem is set up to be developed using [Nix](https://nixos.org/) and
+[ruby_gem_dev_shell](https://github.com/jbernie2/ruby_gem_dev_shell)
+Once you have nix installed you can run `make env` to enter the development
+environment and then `make` to see the list of available commands
 
 ## Contributing
 Please create a github issue to report any problems using the Gem.

data/dryer_services.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name                  = 'dryer_services'
-  spec.version               = "1.1.0"
+  spec.version               = "2.0.0"
   spec.authors               = ['John Bernier']
   spec.email                 = ['john.b.bernier@gmail.com']
   spec.summary               = 'A service object leveraging the dry-monads gem'

data/lib/dryer/services/services/result_service.rb

@@ -15,6 +15,11 @@ module Dryer
             result
           elsif result.is_a?(StandardError)
             Dry::Monads::Failure(result)
+          elsif result.is_a?(Array) && result.all?{ |x| x.is_a?(Dry::Monads::Result) }
+            Dry::Monads::List[*result]
+              .typed(Dry::Monads::Result)
+              .traverse
+              .fmap(&:value)
           else
             Dry::Monads::Success(result)
           end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dryer_services
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - John Bernier
@@ -89,7 +89,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.13
+rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
 summary: A service object leveraging the dry-monads gem