u-service 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a21e14f14ad8d4b658660c94ed2e3687c4b589531a61f11fee63c9fcc0810615
-  data.tar.gz: e504198f717114b9fd6794b795381ebfced5a6e29bda56ad83cc1f055296efc6
+  metadata.gz: 8b8bd72203e123ab248a7b0a510d1eb7f457d3b68a04bc257cdc08f8e6a949ab
+  data.tar.gz: 022a4b90b46b1d10a238b37bc9a168b984f21f9d75ab144d5c97159b864b04c9
 SHA512:
-  metadata.gz: 74d66f07259c0d31c1469d70bd9a89190fafce614bdc4adced7e2e8a4dba07859483f020d90a87850804485f44e468835d481263c027fe86e4bbb9eee8af15ff
-  data.tar.gz: c18b4b93cac117a7a5ea48d5bca5ef17811d62eedd18419a75d40ba6559b2518e5d7cb0c745dc38621034c0c8f802f247c602e4e6acb8ea1dee4b1365b5a25bc
+  metadata.gz: 9adc08c22019f4aab1559bdd017e1b92775acd612d102e27bf9a3726c9a3c88eacd250a556cfc11bf40da95dca85b08711b075c5f85806480dc15d09baacbf73
+  data.tar.gz: 68606ccb04d38d3ccd5549242a9faa7bc0004c751f4d72d834c9adfd649d04723b7267b3b8e84a57e2c54da01b5d9e6074bc93f0ad0537674344b529706b562a

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    u-service (0.7.0)
+    u-service (0.8.0)
       u-attributes (~> 1.1)
 
 GEM

data/README.md

@@ -12,7 +12,7 @@ Create simple and powerful service objects.
   - [Required Ruby version](#required-ruby-version)
   - [Installation](#installation)
   - [Usage](#usage)
-    - [How to create a basic Service Object?](#how-to-create-a-basic-service-object)
+    - [How to create a Service Object?](#how-to-create-a-service-object)
     - [How to use the Service Object result hooks?](#how-to-use-the-service-object-result-hooks)
     - [How to create a pipeline of Service Objects?](#how-to-create-a-pipeline-of-service-objects)
     - [What is a strict Service Object?](#what-is-a-strict-service-object)
@@ -44,7 +44,7 @@ Or install it yourself as:
 
 ## Usage
 
-### How to create a basic Service Object?
+### How to create a Service Object?
 
 ```ruby
 class Multiply < Micro::Service::Base
@@ -67,6 +67,10 @@ result = Multiply.call(a: 2, b: 2)
 p result.success? # true
 p result.value    # 4
 
+# Note:
+# The result of a Micro::Service#call
+# is an instance of Micro::Service::Result
+
 #----------------------------#
 # Calling a service instance #
 #----------------------------#
@@ -164,10 +168,13 @@ Add2ToAllNumbers = Micro::Service::Pipeline[
   Steps::Add2
 ]
 
-DoubleAllNumbers = Micro::Service::Pipeline[
-  Steps::ConvertToNumbers,
-  Steps::Double
-]
+# An alternative way to declare pipelines within classes.
+
+class DoubleAllNumbers
+  include Micro::Service::Pipeline
+
+  pipeline Steps::ConvertToNumbers, Steps::Double
+end
 
 result = Add2ToAllNumbers.call(relation: %w[1 1 2 2 3 4])
 
@@ -200,7 +207,7 @@ Double.call({})
 
 ### How to validate Service Object attributes?
 
-Note: To do this your application must have the (activemodel >= 3.2)(https://rubygems.org/gems/activemodel) as a dependency.
+Note: To do this your application must have the [activemodel >= 3.2](https://rubygems.org/gems/activemodel) as a dependency.
 
 ```ruby
 #
@@ -213,9 +220,9 @@ class Multiply < Micro::Service::Base
   validates :a, :b, presence: true, numericality: true
 
   def call!
-    return Success(number: a * b) if valid?
+    return Failure(errors: self.errors) unless valid?
 
-    Failure(errors: self.errors)
+    Success(number: a * b)
   end
 end
 

data/lib/micro/service/pipeline.rb

@@ -4,6 +4,17 @@ module Micro
   module Service
     module Pipeline
       class Reducer
+        INVALID_SERVICES =
+          'argument must be a collection of `Micro::Service::Base` classes'.freeze
+
+        def self.build(args)
+          services = Array(args)
+
+          raise ArgumentError, INVALID_SERVICES if services.any? { |klass| !(klass < ::Micro::Service::Base) }
+
+          new(services)
+        end
+
         def initialize(services)
           @services = services
         end
@@ -25,19 +36,33 @@ module Micro
 
       private_constant :Reducer
 
-      INVALID_SERVICES =
-        'argument must be a collection of `Micro::Service::Base` classes'.freeze
+      module Macros
+        def pipeline(*args)
+          @pipeline = Reducer.build(args)
+        end
 
-      def self.[](*args)
-        self.new(args)
+        def pipeline_call(options)
+          @pipeline.call(options)
+        end
+
+        def call(options={})
+          new(options).call
+        end
       end
 
-      def self.new(args)
-        services = Array(args)
+      private_constant :Macros
 
-        raise ArgumentError, INVALID_SERVICES if services.any? { |klass| !(klass < ::Micro::Service::Base) }
+      def self.[](*args)
+        Reducer.build(args)
+      end
+
+      def self.included(base)
+        base.extend(Macros)
+        base.class_eval('def initialize(options); @options = options; end')
+      end
 
-        Reducer.new(services)
+      def call
+        self.class.pipeline_call(@options)
       end
     end
   end

data/lib/micro/service/version.rb

@@ -2,6 +2,6 @@
 
 module Micro
   module Service
-    VERSION = '0.7.0'.freeze
+    VERSION = '0.8.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: u-service
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-06 00:00:00.000000000 Z
+date: 2019-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: u-attributes