evnt 3.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ef2fa95d09eb421d9912263783747d85451a4d5e
-  data.tar.gz: af36eef1ef9d3c940e68c2eb6ee0b35b3212964c
+  metadata.gz: 63694dd6640e60116fa220f26d2c5c534434f488
+  data.tar.gz: b8a2784a560444babd7ac31a9d43d4cf73b4be91
 SHA512:
-  metadata.gz: d40c2f8c4e51b0d505911f3059da2b2f4d4ade398131f20c38797da2e1f4ad370858b9dcf3843521ae91529ed0331cdf4a47fd6a6b2137a3751a5cd486bb5d61
-  data.tar.gz: ada5ce42640430d0f38c4773461be4edb5a012c64b20253e6a12a76cd3b0d5d47835100078e2645cfb2fd98d37c620e172cf44a53da1a3abdbddbffdea0d1728
+  metadata.gz: 4c1381e123afa1b6dfac53d92086102a5d57167d90dbfbaa5e72c59af1aff1bf71ccd48766d33841e265c8875db73812a582600eb192e2d35ea0cb324559c795
+  data.tar.gz: e1baebd245175ff2034607294c4e4836579d6f03148de64cbbc36b60211da29066dec7623263408799c5afbe1296d468f78c24628d614cf139a79ce2fb802252

data/README.md

@@ -34,6 +34,7 @@ Commands are used to run single tasks on the system. It's like a controller on a
 
 Every command has three steps to execute:
 
+- The params normalization which normalize the parameters used to run the command.
 - The params validation which validates the parameters used to run the command.
 - The logic validation which checks the command can be executed in compliance with the system rules.
 - The event intialization which initializes an event object used to save the command.
@@ -43,6 +44,10 @@ An example of command should be:
 ```ruby
 class CreateOrderCommand < Evnt::Command
 
+  to_normalize_params do
+    params[:quantity] = params[:quantity].to_i
+  end
+
   to_validate_params do
     # check params presence
     err 'User should be present' if params[:user_id].blank?

data/lib/evnt.rb

@@ -7,7 +7,7 @@ require 'evnt/handler'
 require 'evnt/validator'
 
 ##
-# Evnt is a gem developed to integrate a test driven development
+# Evnt is a gem developed to integrate a event driven development
 # and CQRS pattern inside a ruby project.
 # Evnt is developed to be used over all kinds of projects and
 # frameworks (like Ruby on Rails or Sinatra), so it contains

data/lib/evnt/command.rb

@@ -26,8 +26,8 @@ module Evnt
     #
     # * +exceptions+ - Boolean value used to activate the throw of excetions.
     ##
-    def initialize(params, _options: {})
-      _init_command_data(params, _options)
+    def initialize(params)
+      _init_command_data(params)
       _run_command_steps
     end
 
@@ -105,14 +105,15 @@ module Evnt
     private
 
     # This function initializes the command required data.
-    def _init_command_data(params, options)
+    def _init_command_data(params)
       # set state
       @state = {
         result: true,
         errors: []
       }
-
+      
       # set options
+      options = params[:_options] || {}
       @options = {
         exceptions: options[:exceptions] || false
       }
@@ -124,6 +125,7 @@ module Evnt
     # This function calls requested steps (callback) for the command.
     def _run_command_steps
       _validate_single_params
+      _normalize_params if @state[:result] && defined?(_normalize_params)
       _validate_params if @state[:result] && defined?(_validate_params)
       _validate_logic if @state[:result] && defined?(_validate_logic)
       _initialize_events if @state[:result] && defined?(_initialize_events)
@@ -144,7 +146,7 @@ module Evnt
         end
       end
 
-      @params.freeze
+      @params
     end
 
     # Class functions:
@@ -162,6 +164,11 @@ module Evnt
         instance_variable_set(:@_validations, validations)
       end
 
+      # This function sets the normalize params function for the command.
+      def to_normalize_params(&block)
+        define_method('_normalize_params', &block)
+      end
+
       # This function sets the validate params function for the command.
       def to_validate_params(&block)
         define_method('_validate_params', &block)

data/lib/evnt/event.rb

@@ -38,7 +38,13 @@ module Evnt
     #
     # ==== Attributes
     #
-    # * +params+ - The list of parameters for the command.
+    # * +params+ - The list of parameters for the event.
+    # * +_options+ - The list of options for the event.
+    #
+    # ==== Options
+    #
+    # * +silent+ - Boolean value used to avoid the call of the notify method of
+    # handlers.
     ##
     def initialize(params)
       _init_event_data(params)
@@ -71,6 +77,12 @@ module Evnt
         reloaded: !params[:evnt].nil?
       }
 
+      # set options
+      options = params[:_options] || {}
+      @options = {
+        silent: options[:silent] || false
+      }
+
       # set payload
       payload = params.reject { |k, _v| k[0] == '_' }
       @payload = @state[:reloaded] ? payload : _generate_payload(payload)
@@ -113,6 +125,7 @@ module Evnt
     # This function notify all handlers for the event.
     def _notify_handlers
       return unless self.class._handlers
+      return if @options[:silent]
 
       # notify every handler
       self.class._handlers.each do |handler|

data/lib/evnt/version.rb

@@ -5,6 +5,6 @@ module Evnt
   ##
   # Constant containing the current gem version.
   ##
-  VERSION = '3.0'
+  VERSION = '3.0.1'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: evnt
 version: !ruby/object:Gem::Version
-  version: '3.0'
+  version: 3.0.1
 platform: ruby
 authors:
 - Ideonetwork
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-17 00:00:00.000000000 Z
+date: 2018-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler