dryer_services 1.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fc730ff5d7dc75aed6d18e68f50f2de371535271974ed5d12d6d08ad3cf5207
-  data.tar.gz: 61f6a0e307a4d0b9e7104a870b53ffc234f743515e67ef9a6232ce6f7a15648f
+  metadata.gz: 5da96272749622ca4b98bae9f6d151a56826dc87641c2e5cc609f93e46a4dd13
+  data.tar.gz: a40fb9f8d0640629cdc1c9b6424786cbc3509169b448b66dfc328f079ffccb4b
 SHA512:
-  metadata.gz: 1ada4c583fe9f5eded4af12b4bdda7e003376ae55d79de3d3609d9ee19d3d0e4c56483317139e9cee6fa43bf05a0af4df7a53741f01ca7dae6c97999e9649cd6
-  data.tar.gz: 9cbf2836e9b0dde5377c7fc576300dc0894bce93697f4649445f238235b42daf1366820aa8535ec0da1b228fc5c67192b564cbd1b13601d9461105793d2409b1
+  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)
@@ -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.2.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.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - John Bernier