midnight-business_logic 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 24cfcc468f4e7e48f77e50e2728017a106ea7a07703aa11d939781766eb5ad61
+  data.tar.gz: 36e4bcb84ec676b5cdb6ddd3523ec08d43630573bc9bf9602315c01db1694f75
+SHA512:
+  metadata.gz: 0ab18cc817a8aaf3d1bbc3d4d1b7bf389de5bc91f1bbb33d673571c1402c7503b1b636316e8c846770f60d8b7a7ce8486d1fe9bb47683c282b7c94bb3006b026
+  data.tar.gz: fa3cdba82a930e1759665d7e13f287001f589fbdbcc84fed14625007fba5c289dc4270c4a56d70a620de2d7a6580d90c8796c5eb4e1e2a9c6a39632b5604dabc

data/lib/midnight/business_logic.rb

@@ -0,0 +1,19 @@
+require 'active_support/dependencies/autoload'
+require_relative 'business_logic/version'
+
+module Midnight
+  module Commons
+    extend ::ActiveSupport::Autoload
+
+    autoload :ConcurrentWriteError
+    autoload :NULL_EVENT_HANDLER, 'midnight/commons/constants'
+  end
+
+  module BusinessLogic
+    extend ::ActiveSupport::Autoload
+
+    autoload :AggregateRoot
+    autoload :Event
+    autoload :EventDispatcher
+  end
+end

data/lib/midnight/business_logic/aggregate_root.rb

@@ -0,0 +1,46 @@
+require 'active_support/concern'
+
+module Midnight
+  module BusinessLogic
+    module AggregateRoot
+      class UnknownCommand < ArgumentError
+      end
+
+      extend ::ActiveSupport::Concern
+
+      def dispatch(_command)
+        raise UnknownCommand
+      end
+
+      def state
+        @state ||= {}
+      end
+
+      def pending_events
+        @pending_events ||= []
+      end
+
+      class_methods do
+        attr_accessor :_event_handlers
+
+        private
+
+        def on(event_class, &block)
+          self._event_handlers ||= {}
+          self._event_handlers[event_class] = block
+        end
+      end
+
+      private
+
+      def apply(*events)
+        handlers = self.class._event_handlers || {}
+        events.each do |event|
+          handler = handlers[event.class]
+          instance_exec(event, &handler) if handler
+          pending_events << event
+        end
+      end
+    end
+  end
+end

data/lib/midnight/business_logic/event.rb

@@ -0,0 +1,47 @@
+require 'time'
+require 'active_support/core_ext/time'
+
+module Midnight
+  module BusinessLogic
+    class Event
+      class SchemaViolation < ArgumentError
+      end
+
+      DEFAULT_METADATA_GENERATOR = lambda do
+        {
+          occurred_at: ::Time.current.iso8601(6)
+        }
+      end
+
+      def initialize(data: {}, metadata: nil)
+        @data = data
+        @metadata = metadata || DEFAULT_METADATA_GENERATOR.call
+        freeze
+      end
+
+      attr_reader :data, :metadata
+
+      class << self
+        def strict(data: {}, metadata: nil)
+          ensure_schema(data)
+          new(
+            data: data,
+            metadata: metadata
+          )
+        end
+
+        private
+
+        def ensure_schema(_data)
+          raise NotImplementedError
+          # example
+          # @data_schema ||= ::Dry::Schema.Params do
+          #   required(:example_field).filled(:string)
+          # end
+          # result = @data_schema.call(data)
+          # raise SchemaViolation unless result.success?
+        end
+      end
+    end
+  end
+end

data/lib/midnight/business_logic/event_dispatcher.rb

@@ -0,0 +1,69 @@
+require 'active_support/core_ext/object/blank'
+
+module Midnight
+  module BusinessLogic
+    class EventDispatcher
+      class InvalidHandlerSupplied < ArgumentError
+      end
+
+      def initialize(handlers_map = {})
+        handlers_map.each do |_event_class, handler_list|
+          handler_list.each do |handler|
+            raise InvalidHandlerSupplied unless handler.respond_to?(:call)
+            # correct construction example:
+            # EventDispatcher.new(SomeEvent => [
+            #   method(:puts)
+            # ])
+          end
+        end
+        @_handlers_map = handlers_map
+        freeze
+      end
+
+      def once(event)
+        handler_list = @_handlers_map[event.class]
+        unless handler_list.blank?
+          handler_list.each do |handler|
+            handler.call(event)
+          end
+        end
+      end
+
+      def batch(events)
+        events.each(&method(:once))
+      end
+    end
+
+    class CompositeEventDispatcher # quack like EventDispatcher
+      def initialize(*dispatchers)
+        @_dispatchers = dispatchers
+        freeze
+      end
+
+      def once(event)
+        @_dispatchers.each do |dispatcher|
+          dispatcher.once(event)
+        end
+      end
+
+      def batch(events)
+        events.each(&method(:once))
+      end
+    end
+    private_constant :CompositeEventDispatcher
+
+    class EventDispatcher
+      class InvalidDispatcherSupplied < ArgumentError;
+      end
+
+      class << self
+        def merge(*dispatchers)
+          raise InvalidDispatcherSupplied unless dispatchers.all? do |dispatcher|
+            dispatcher.respond_to?(:once)
+          end
+          CompositeEventDispatcher.new(*dispatchers)
+        end
+      end
+    end
+  end
+end

data/lib/midnight/business_logic/version.rb

@@ -0,0 +1,5 @@
+module Midnight
+  module BusinessLogic
+    VERSION = '0.0.1'
+  end
+end

data/lib/midnight/commons/concurrent_write_error.rb

@@ -0,0 +1,8 @@
+# just a convenient marker
+
+module Midnight
+  module Commons
+    module ConcurrentWriteError
+    end
+  end
+end

data/lib/midnight/commons/constants.rb

@@ -0,0 +1,5 @@
+module Midnight
+  module Commons
+    NULL_EVENT_HANDLER = lambda { |*_args| }
+  end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: midnight-business_logic
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Sarun Rattanasiri
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Midnight::BusinessLogic is a toolkit for writing clean and robust business
+  logics agnostic to frameworks, user interfaces, and data storage. Make the business
+  logic fully testable and provides isolation from external side effects.
+email: midnight_w@gmx.tw
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/midnight/business_logic.rb
+- lib/midnight/business_logic/aggregate_root.rb
+- lib/midnight/business_logic/event.rb
+- lib/midnight/business_logic/event_dispatcher.rb
+- lib/midnight/business_logic/version.rb
+- lib/midnight/commons/concurrent_write_error.rb
+- lib/midnight/commons/constants.rb
+homepage: https://gitlab.com/slime-systems/midnight-enterprise-toolkit/tree/master/midnight-business_logic
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: A toolkit for writing enterprise business logic
+test_files: []