evil_events 0.1.0rc4 → 0.1.0rc5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c736b2f681a527cc5c3f01b2463954b8206864a2
-  data.tar.gz: 5de17389672409a9a313820d9b1dbdbdbc86d17e
+  metadata.gz: 433dcd60c4b1a754d00e5a40051f8fce7f2b12c2
+  data.tar.gz: 01a0271699af053fdb782fc7cf45fa888ecb64bd
 SHA512:
-  metadata.gz: c570fc9dedbdf9b8ee66cbf735a59d89cfe2ffc33e70c6a0b1e6866388379a06acd9ccd836e718ab9530d4626e04cb0d679891dbdd97b66c69d28f6cf1207079
-  data.tar.gz: 0c65ec58f6114b0a469307920ba246eea79f0642b9e68ba8be75b2267886bb6778b1b9c2aeeb8b64b200ba4119c60cd5545b42ed0aabd5546adab7cff68fb848
+  metadata.gz: e1f5c5576c528da60b273de597037843801ba553e645895518595e8eeeb2b58b6c9136c392bdb12f657b813b755a4fc61d7f47fa9008a8b038d27b4f8b37f443
+  data.tar.gz: 1cb7b235ac6cbb07760cf6459f2e5848aabf35e9dcaf290b7c52d8d25c1a43ae313fe4706859c587f17745c66ea4792ac6b0c8fbebd781001aa4a8b4058d59f2

data/README.md

@@ -4,62 +4,10 @@
 [![Build Status](https://travis-ci.org/ergosploit/evil_events.svg?branch=master)](https://travis-ci.org/ergosploit/evil_events)
 [![Coverage Status](https://coveralls.io/repos/github/ergosploit/evil_events/badge.svg?branch=master)](https://coveralls.io/github/ergosploit/evil_events?branch=master)
 
-### Proof of Concept
-
-```ruby
-# 0. Subscribers:
-EventStore   = Concurrent::Array.new
-ElasticStore = Concurrent::Array.new
-
-# 1. Create events:
-class UserRegistered < EvilEvents::Event['user_registered']
-  payload :user_id,  EvilEvents::Types::Strict::Int
-  payload :ref_link, EvilEvents::Types::Strict::String.default('undefined')
-
-  metadata :uuid,      EvilEvents::Types::String.default('shared-uuid')
-  metadata :timestamp, EvilEvents::Types::Time.default { Time.now }
-
-  observe EventStore,   delegator: :push
-  observe ElasticStore, delegator: :<<
-
-  adapter :memory_async
-end
-
-MatchLost = EvilEvents::Event.define('match_lost') do
-  default_delegator :push
-
-  payload :player_id
-  payload :score
-
-  metadata :timestamp, EvilEvents::Types::Time.default { Time.now }
-
-  observe EventStore
-
-  adapter :memory_sync
-end
-
-# 2. Emit via object or via event attributes:
-UserRegistered.new(payload: { user_id: 1, ref_id: 5 }, metadata: { uuid: 1_111 }).emit!
-EvilEvents::Event.emit('user_registered', payload: { user_id: 2, ref_id: 7 })
-EvilEvents::Event.emit('match_lost', payload: { player_id: 5, score: '2-1' })
-
-# 3. Logs:
-# => INFO -- [EvilEvents:EventEmitted(memory_async)]: Type: user_registered :: Payload: {:user_id=>1, :ref_id=>5} :: Metadata: {:uuid=>1111, :timestamp=>2017-10-15 20:08:09 +0300}
-# => INFO -- [EvilEvents:EventEmitted(memory_async)]: Type: user_registered :: Payload: {:user_id=>2, :ref_id=>7} :: Metadata: {:uuid=>"shared-uuid", :timestamp=>2017-10-15 20:08:09 +0300}
-# => INFO -- [EvilEvents:EventEmitted(memory_sync)]: Type: match_lost :: Payload: {:player_id=>5, :score=>"2-1"} :: Metadata: {:timestamp=>2017-10-15 20:08:09 +0300}
-
-# 4. State of observers:
-EventStore   # => [#<UserRegistered...>, #<UserRegistered...>, <#MatchLost...>]
-ElasticStore # => [#<UserRegistered...>, #<UserRegistered...>]
-```
-
 ### ROADMAP
 - Basic documentation (README) (0.1.0)
 - FULL documentation (0.1.1)
 - Notifier abstraction (0.2.0)
 - Event sourcing (0.3.0)
-- RSpec matchers (separated gem)
 - Concrete error messages for exceptions (0.1.1)
 - Hooks (0.2.0)
-- Scheduling (0.2.0)
-- Event logic (0.2.0)

data/lib/evil_events/config/adapters.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.1.0
+module EvilEvents::Config::Adapters
+  class << self
+    # @api public
+    # @since 0.1.0
+    def register(adapter_name, adapter_object)
+      EvilEvents::BootPoint[:event_system].register_adapter(adapter_name, adapter_object)
+    end
+  end
+end

data/lib/evil_events/config.rb

@@ -34,4 +34,6 @@ module EvilEvents
 
     setting :logger, EvilEvents::Shared::Logger.new(STDOUT), reader: true
   end
+
+  require_relative 'config/adapters'
 end

data/lib/evil_events/core/broadcasting/adapters.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module EvilEvents::Core::Broadcasting
+  # @api private
   # @since 0.1.0
   class Adapters
     extend EvilEvents::Shared::DependencyContainer::Mixin

data/lib/evil_events/core/broadcasting/dispatcher/mixin.rb

@@ -2,13 +2,9 @@
 
 module EvilEvents::Core::Broadcasting
   class Dispatcher
-    # @api public
+    # @api private
     # @since 0.1.0
-    module Mixin
-      # @param event [EvilEvents::Core::Events::AbstractEvent]
-      # @return void
-      #
-      # @since 0.1.0
+    Mixin = EvilEvents::Shared::ClonableModuleBuilder.build do
       def dispatch(event)
         Dispatcher.dispatch(event)
       end

data/lib/evil_events/core/broadcasting.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module EvilEvents::Core
+  # @api private
   # @since 0.1.0
   module Broadcasting
     require_relative 'broadcasting/dispatcher'

data/lib/evil_events/core/events/abstract_event.rb

@@ -24,7 +24,8 @@ module EvilEvents::Core::Events
     # @since 0.1.0
     extend EvilEvents::Shared::CombinedContextMixin
 
-    # @param payload_attributes [Hash]
+    # @option payload [Hash]
+    # @option metadata [Hash]
     #
     # @since 0.1.0
     def initialize(payload: {}, metadata: {})

data/lib/evil_events/core/events/event_extensions/metadata_extendable/abstract_metadata.rb

@@ -1,25 +1,7 @@
 # frozen_string_literal: true
 
-# TODO: dry and refactor with AbstractPayload
 module EvilEvents::Core::Events::EventExtensions::MetadataExtendable
-  # @abstract
   # @api private
   # @since 0.1.0
-  class AbstractMetadata < EvilEvents::Shared::Structure
-    class << self
-      # @since 0.1.0
-      alias_method :_native_attribute, :attribute
-
-      # @param key [Symbol]
-      # @param type [EvilEvents::Shared::Types::Any]
-      #
-      # @since 0.1.0
-      def attribute(key, type = EvilEvents::Types::Any)
-        _native_attribute(key, type)
-      end
-    end
-
-    # NOTE: dry-struct API + dry-initializer API
-    constructor_type :strict_with_defaults
-  end
+  AbstractMetadata = Class.new(EvilEvents::Shared::Structure)
 end

data/lib/evil_events/core/events/event_extensions/metadata_extendable.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-# TODO: refactor with EvilEvents::Core::Events::EventExtensions::Payloadable
 module EvilEvents::Core::Events::EventExtensions
   # @api private
   # @since 0.1.0

data/lib/evil_events/core/events/event_extensions/payloadable/abstract_payload.rb

@@ -1,25 +1,7 @@
 # frozen_string_literal: true
 
-# TODO: dry and refactor with AbstractMetadata
 module EvilEvents::Core::Events::EventExtensions::Payloadable
-  # @abstract
   # @api private
   # @since 0.1.0
-  class AbstractPayload < EvilEvents::Shared::Structure
-    class << self
-      # @since 0.1.0
-      alias_method :_native_attribute, :attribute
-
-      # @param key [Symbol]
-      # @param type [EvilEvents::Shared::Types::Any]
-      #
-      # @since 0.1.0
-      def attribute(key, type = EvilEvents::Types::Any)
-        _native_attribute(key, type)
-      end
-    end
-
-    # NOTE: dry-struct API + dry-initializer API
-    constructor_type :strict_with_defaults
-  end
+  AbstractPayload = Class.new(EvilEvents::Shared::Structure)
 end

data/lib/evil_events/core/events/event_extensions/payloadable.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-# TODO: refactor with EvilEvents::Core::Events::EventExtensions::MetadataExtendable
 module EvilEvents::Core::Events::EventExtensions
   # @api private
   # @since 0.1.0

data/lib/evil_events/core/events/manager_factory.rb

@@ -6,7 +6,7 @@ module EvilEvents::Core::Events
   module ManagerFactory
     # @since 0.1.0
     ManagerFactoryError = Class.new(StandardError)
-    # @sicne 0.1.0
+    # @since 0.1.0
     IncorrectEventClassError = Class.new(ManagerFactoryError)
 
     class << self

data/lib/evil_events/core/events.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module EvilEvents::Core
+  # @api private
   # @since 0.1.0
   module Events
     require_relative 'events/serializers'

data/lib/evil_events/shared/clonable_module_builder.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module EvilEvents::Shared
+  # @api public
+  # @since 0.1.0
+  module ClonableModuleBuilder
+    class << self
+      # @param module_definitions [Proc]
+      # @return [Module]
+      #
+      # @since 0.1.0
+      def build(&module_definitions)
+        Module.new do
+          class_eval(&module_definitions) if block_given?
+
+          singleton_class.instance_eval do
+            define_method :module do
+              Module.new { class_eval(&module_definitions) if block_given? }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/evil_events/shared/combined_context.rb

@@ -46,6 +46,11 @@ module EvilEvents
       # @since 0.1.0
       attr_reader :__outer_context__
 
+      # @return [::Kernel]
+      #
+      # @since 0.1.0
+      attr_reader :__kernel_context__
+
       # @return [Proc]
       #
       # @since 0.1.0
@@ -60,6 +65,7 @@ module EvilEvents
 
         @__required_context__ = required_context
         @__outer_context__    = ::Kernel.eval('self', clojure.binding)
+        @__kernel_context__   = ::Kernel
         @__clojure__          = clojure
       end
 
@@ -81,8 +87,8 @@ module EvilEvents
           __outer_context__.public_send(method_name, *arguments, &block)
         when __required_context__.respond_to?(method_name)
           __required_context__.public_send(method_name, *arguments, &block)
-        when ::Kernel.respond_to?(method_name)
-          ::Kernel.public_send(method_name, *arguments, &block)
+        when __kernel_context__.respond_to?(method_name)
+          __kernel_context__.public_send(method_name, *arguments, &block)
         else
           super
         end
@@ -93,7 +99,8 @@ module EvilEvents
       # @since 0.1.0
       def respond_to_missing?(method_name, include_private = false)
         __outer_context__.respond_to?(method_name) ||
-          __required_context__.respond_to?(method_name) || super
+          __required_context__.respond_to?(method_name) ||
+          __kernel_context__.respond_to?(method_name) || super
       end
 
       # @see #method_missing
@@ -106,8 +113,8 @@ module EvilEvents
           __outer_context__.method(method_name)
         when __required_context__.respond_to?(method_name)
           __required_context__.method(method_name)
-        when ::Kernel.respond_to?(method_name)
-          ::Kernel.method(method_name)
+        when __kernel_context__.respond_to?(method_name)
+          __kernel_context__.method(method_name)
         else
           super
         end

data/lib/evil_events/shared/structure.rb

@@ -3,5 +3,21 @@
 module EvilEvents::Shared
   # @api public
   # @since 0.1.0
-  Structure = Dry::Struct
+  class Structure < Dry::Struct
+    class << self
+      # @since 0.1.0
+      alias_method :_native_attribute, :attribute
+
+      # @param key [Symbol]
+      # @param type [EvilEvents::Shared::Types::Any]
+      #
+      # @since 0.1.0
+      def attribute(key, type = EvilEvents::Shared::Types::Any)
+        _native_attribute(key, type)
+      end
+    end
+
+    # NOTE: dry-struct API + dry-initializer API
+    constructor_type :strict_with_defaults
+  end
 end

data/lib/evil_events/shared.rb

@@ -13,5 +13,6 @@ module EvilEvents
     require_relative 'shared/dependency_container'
     require_relative 'shared/mockable_class_builder'
     require_relative 'shared/combined_context_mixin'
+    require_relative 'shared/clonable_module_builder'
   end
 end

data/lib/evil_events/system/broadcaster.rb

@@ -38,5 +38,14 @@ class EvilEvents::System
     def resolve_adapter(adapter_name)
       EvilEvents::Core::Broadcasting::Adapters.resolve(adapter_name)
     end
+
+    # @param adapter_name [Symbol, String]
+    # @param adapter_object [Object]
+    # @return void
+    #
+    # @since 0.1.0
+    def register_adapter(adapter_name, adapter_object)
+      EvilEvents::Core::Broadcasting::Adapters.register(adapter_name, adapter_object)
+    end
   end
 end

data/lib/evil_events/system/event_builder.rb

@@ -11,9 +11,7 @@ class EvilEvents::System
       #
       # @since 0.1.0
       def define_event_class(event_type, &event_class_definitions)
-        EvilEvents::Core::Events::EventClassFactory.create(
-          event_type, &event_class_definitions
-        )
+        EvilEvents::Core::Events::EventClassFactory.create(event_type, &event_class_definitions)
       end
 
       # @param event_type [String]
@@ -21,25 +19,23 @@ class EvilEvents::System
       #
       # @since 0.1.0
       def define_abstract_event_class(event_type)
-        EvilEvents::Core::Events::EventClassFactory.create_abstract(
-          event_type
-        )
+        EvilEvents::Core::Events::EventClassFactory.create_abstract(event_type)
       end
 
       # @param serialized_event [String]
-      # @return [Class{EvilEvents::Core::Events::AbstractEvent}]
+      # @return [EvilEvents::Core::Events::AbstractEvent]
       #
       # @since 0.1.0
       def deserialize_from_json(serialized_event)
-        EvilEvents::Core::Events::Serializer.resolve[:json].deserialize(serialized_event)
+        EvilEvents::Core::Events::Serializers.resolve(:json).deserialize(serialized_event)
       end
 
       # @param serialized_event [Hash]
-      # @return [Class{EvilEvents::Core::Events::AbstractEvent}]
+      # @return [EvilEvents::Core::Events::AbstractEvent]
       #
       # @since 0.1.0
       def deserialize_from_hash(serialized_event)
-        EvilEvents::Core::Events::Serializer.resolve[:hash].deserialize(serialized_event)
+        EvilEvents::Core::Events::Serializers.resolve(:hash).deserialize(serialized_event)
       end
     end
   end

data/lib/evil_events/system/event_manager.rb

@@ -76,7 +76,8 @@ class EvilEvents::System
     end
 
     # @param event_type [String]
-    # @param event_attributes [Hash]
+    # @option payload [Hash]
+    # @option metadata [Hash]
     # @return [EvilEvents::Core::Events::AbstractEvent]
     #
     # @since 0.1.0

data/lib/evil_events/system/mock.rb

@@ -39,6 +39,10 @@ class EvilEvents::System
     # @since 0.1.0
     def resolve_adapter(adapter_name); end
 
+    # @see EvilEvents::System
+    # @since 0.1.0
+    def register_adapter(adapter_name, adapter_object); end
+
     # @see EvilEvents::System
     # @since 0.1.0
     def register_event_class(event_class); end

data/lib/evil_events/system.rb

@@ -19,7 +19,8 @@ class EvilEvents::System
   def_delegators :broadcaster,
                  :emit,
                  :raw_emit,
-                 :resolve_adapter
+                 :resolve_adapter,
+                 :register_adapter
 
   # @see EvilEvents::System::EventManager
   # @since 0.1.0

data/lib/evil_events/version.rb

@@ -3,5 +3,5 @@
 module EvilEvents
   # @api public
   # @since 0.1.0
-  VERSION = '0.1.0rc4'
+  VERSION = '0.1.0rc5'
 end

data/lib/evil_events.rb

@@ -23,6 +23,10 @@ module EvilEvents
   # @since 0.1.0
   Types = Shared::Types
 
+  # @api public
+  # @since 0.1.0
+  DispatcherMixin = EvilEvents::Core::Broadcasting::Dispatcher::Mixin.module
+
   # @api public
   # @since 0.1.0
   module Serializer
@@ -45,32 +49,34 @@ module EvilEvents
 
   # @api public
   # @since 0.1.0
-  module Event
+  module Emitter
     class << self
       # @see EvilEvents::System
       # @api public
       # @since 0.1.0
-      def [](event_type)
-        EvilEvents::BootPoint[:event_system].define_abstract_event_class(
-          event_type
-        )
+      def emit(event_type, **event_attributes)
+        EvilEvents::BootPoint[:event_system].raw_emit(event_type, **event_attributes)
       end
+    end
+  end
 
+  # @api public
+  # @since 0.1.0
+  module Event
+    class << self
       # @see EvilEvents::System
       # @api public
       # @since 0.1.0
-      def define(event_type, &event_class_definitions)
-        EvilEvents::BootPoint[:event_system].define_event_class(
-          event_type, &event_class_definitions
-        )
+      def [](event_type)
+        EvilEvents::BootPoint[:event_system].define_abstract_event_class(event_type)
       end
 
       # @see EvilEvents::System
       # @api public
       # @since 0.1.0
-      def emit(event_type, **event_attributes)
-        EvilEvents::BootPoint[:event_system].raw_emit(
-          event_type, **event_attributes
+      def define(event_type, &event_class_definitions)
+        EvilEvents::BootPoint[:event_system].define_event_class(
+          event_type, &event_class_definitions
         )
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: evil_events
 version: !ruby/object:Gem::Version
-  version: 0.1.0rc4
+  version: 0.1.0rc5
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-15 00:00:00.000000000 Z
+date: 2017-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-monads
@@ -229,7 +229,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
-- ".hound.yml"
 - ".jrubyrc"
 - ".rspec"
 - ".rubocop.yml"
@@ -246,6 +245,7 @@ files:
 - lib/evil_events.rb
 - lib/evil_events/boot_point.rb
 - lib/evil_events/config.rb
+- lib/evil_events/config/adapters.rb
 - lib/evil_events/core.rb
 - lib/evil_events/core/activity_logger.rb
 - lib/evil_events/core/broadcasting.rb
@@ -278,6 +278,7 @@ files:
 - lib/evil_events/core/events/subscriber.rb
 - lib/evil_events/core/events/subscriber/mixin.rb
 - lib/evil_events/shared.rb
+- lib/evil_events/shared/clonable_module_builder.rb
 - lib/evil_events/shared/combined_context.rb
 - lib/evil_events/shared/combined_context_mixin.rb
 - lib/evil_events/shared/configurable.rb

data/.hound.yml

@@ -1,2 +0,0 @@
-ruby:
-  config_file: .rubocop.yml