dry-facts 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b341b5c19a83f7f568b2cb9ad1b4f2caf14ec394d061c08509f0bc2940efd4c5
-  data.tar.gz: 36e9b955c5511f7ba03a0f6be0b682d79a1f3da410d77e2dfdced632f780a030
+  metadata.gz: 35e96fd751117a68e6492f8472722648f80a1cd49fa0830cdba2fb4b579b1fce
+  data.tar.gz: 2e2f7b7374ea7e141df10b332f04e836f2475423995ff0518d6b196bb3b18cb3
 SHA512:
-  metadata.gz: fbeaffa2e91b48af5c9304e2fda103cfb104b8830971599a1168c4ea5392bd478449e2092f920725f1db7e824b85c372de16215fdcdc1225d636149f4a663b8e
-  data.tar.gz: 7e6e32fac315907ad1a60f547fd9e9c012d59498892d1390a5af2afc6b31ec686c36dbde3324261ff2489dae86d7d8e7df5d41db805be1c7c69c544ad480eefe
+  metadata.gz: 4d1ee1eef74e2fdb5379777c8cb91b9c3bc6612543736e9687beb7c812b9210eb7c2722ec47a75c965ff2744efc592b643ff2ea46534ef1bbfdfdb9af7128145
+  data.tar.gz: 7eefafc1aa1bf0ce211b752cd6a26028506aaba9739ce51985cd40828ebf3e755dc1ab4f32194c0d33899127f621249944e76b5831e089eb09f78b85de826172

data/Gemfile

@@ -1,4 +1,5 @@
-source "https://rubygems.org"
+ruby    "2.5.0"
+source  "https://rubygems.org"
 
 git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dry-facts (0.2.0)
+    dry-facts (0.3.0)
       dry-equalizer (>= 0.0.11)
       dry-events (>= 0.1.0)
       dry-struct
@@ -66,5 +66,8 @@ DEPENDENCIES
   minitest (>= 5.0)
   rake (>= 10.0)
 
+RUBY VERSION
+   ruby 2.5.0p0
+
 BUNDLED WITH
    1.16.1

data/README.md

@@ -3,6 +3,13 @@
 EventSourcing ruby toolkit, somewhat based on dry-rb primitives.
 Opinionated. Raw.
 
+## Rationale
+
+People dont *know* or *understand* software projects, people navigate themselves through software projects.
+To effectively navigate through structure and mutable state of big systems - programmers need sub-systems to be isolated.
+Usable incapsulation - barriers have to be visible and hard to break.
+Readability matters - declarative readable code wins.
+
 ## Goals
 
 * General EventSourcing toolkit for Ruby

data/ROADMAP.md

@@ -1,33 +1,23 @@
 # Roadmap
 
-Big vision behind this project is to build powerful toolkit that would allow
-rapid application development using EventSourcing as a core architectural
-pattern.
+Goal is to build toolkit that would allow rapid application development using EventSourcing as a core architectural pattern.
 
-Being able to build core behaviors and exposing those through GraphQL to the
-customers is the basic idea.
+Being able to build core behaviors and exposing those through GraphQL to the customers is the basic idea.
 
 Goal is multidimensional:
-  GraphQL generation from bounded context code (?),
-  persistance,
-  serialization,
-  validations,
-  nested transactions,
-  async execution,
-  command composition
-
+  Autogenerated GraphQL schema
+  EventSourcing toolkit
+  Idiomatic, human-friendly DSL
 
 ## Top to bottom vision
-
-Autogenerated GraphQL used to invoke Commands and Queries, which read from Projections,
-Aggregates, generate and persist events. Events persisted in EventStore.
+Autogenerated GraphQL used to invoke Commands and Queries, which read from Projections, Aggregates, generate and persist events. Events persisted in EventStore.
 
 ## Approach
 
 Minimal prototypes of primitives
 Minimal prototype of integrated system
 Minimal prototype of application based on system
-Refactoring
+Refactoring-Improvement-Refactoring
 
 ## Challenges
 
@@ -35,6 +25,13 @@ Brain split,
 Deliver once,
 Transactional consistency,
 Nesting transactions,
+Persistence,
+Serialization,
+Validations,
+Command composition,
+Nested transactions,
+Async execution
+
 Event/Command/Schema evolution (behavior, naming, structure),
 Identity (Sequent -- Repository for aggregates.
 Implements the Unit-Of-Work and Identity-Map patterns to ensure each aggregate is only loaded once per transaction and that you always get the same aggregate instance back.)
@@ -46,6 +43,14 @@ No explicit types ?
 
 
 ## Checklist
+  * DX
+    - [x] Git Flow
+    - [ ] CI
+    - [ ] Ruby below 2.5.0 (yield_self usage)
+    - [ ] Linter  
+    - [ ] Dependency watcher
+    - [ ] Badges
+
   * Command
     - [x] Skeleton without any meaningful structure
     - [x] With inner class input contract
@@ -54,6 +59,7 @@ No explicit types ?
     - [x] With explicit method output contract
     - [x] Without input contract
     - [x] Without output contract
+    - [ ] Dry-transaction?
     - [ ] Unified result (Relay?)
     - [ ] Multistep
     - [ ] Composition
@@ -68,23 +74,27 @@ No explicit types ?
     - [x] In memory store
       - [ ] Serialization and typecasting?
       - [x] Aggregates
+      - [ ] Snapshots
       - [ ] Causality
       - [ ] Correlations
       - [ ] Transactions
-      - [ ] Snapshots
       - [ ] Projections
       - [ ] Versioning
       - [ ] Locking
+      - [ ] Blockchain?
       - [ ] Lifecycle and maintenance tasks
     - [ ] Sequel store
     - [ ] ActiveRecord store
     - [ ] Redis store
     - [ ] Kafka store
+    - [ ] IPFS store?
+    - [ ] IPDB store?
     - [ ] Docs from comments
   * Event
     - [ ] Hash?
     - [x] Object?
-    - [ ] Aggregate DSL
+    - [x] Immutability?
+    - [x] Aggregate DSL
     - [ ] Correlation DSL
     - [ ] Causation DSL
     - [ ] Module?
@@ -97,6 +107,8 @@ No explicit types ?
     - [x] Class instance
     - [x] With events
     - [x] Data transfer DSL
+    - [x] To hash
+    - [ ] Aggregate from namespaces (*::Events* ?)
     - [ ] Stream DSL
     - [ ] Projection DSL
     - [ ] Conversion to Hash
@@ -104,6 +116,8 @@ No explicit types ?
     - [ ] With contract?
     - [ ] Code & test generator
     - [ ] Docs from comments
+  * Projections
+    - [ ] Skeleton without any functionality
   * GraphQL
     - [x] Data type
     - [x] Query
@@ -115,7 +129,6 @@ No explicit types ?
     - [ ] Query generation
     - [ ] Mutation generation
     - [ ] Schema from hash?
-  * CI
   * JRuby tests
   * OpalRuby tests
 

data/lib/dry/facts/aggregate.rb

@@ -12,40 +12,39 @@ module Dry
       attr_accessor :uuid
 
       class << self
-        def build_one_from_events events
-          self
-          .new(events)
+        def aggregate_data_from_event_types *event_klasses
+          event_klasses.each do |klass|
+            define_event_type_handler klass, :_transfer_data_from_event
+          end
         end
 
         def build_all_from_events events
           events
-          .group_by {|e| e.aggregate_id }
-          .map {|_, g_events| build_one_from_events(g_events) }
+          .group_by {|e|            e.aggregate_id }
+          .map      {|_, g_events|  build_one_from_events(g_events) }
         end
 
-        def event_types
-          @event_handlers.keys
+        def build_one_from_events events
+          self
+          .new(events)
         end
 
-        def event_handlers
-          @event_handlers
+        def define_event_type_handler klass, method_name
+          @event_handlers ||= {}
+          @event_handlers[klass.name] = method_name
         end
 
-        def find_event_handler(key)
-          (@event_handlers)[key]
+        def event_handlers
+          @event_handlers
         end
 
-        def define_event_handler(name, method_name= :no_op)
-          @event_handlers ||= {}
-          @event_handlers[name] = method_name
+        def event_types
+          @event_handlers.keys
         end
 
-        def aggregate_data_from_event_types(*event_klasses)
-          event_klasses.each do |klass|
-            define_event_handler klass.name, :_transfer_data_from_event
-          end
+        def find_event_handler(key)
+          (@event_handlers)[key]
         end
-
       end
 
       def initialize(events)
@@ -59,9 +58,12 @@ module Dry
       end
 
       def to_h
-        {id: self.id, email: self.email}
+        self
+        .instance_variables
+        .map              {|ivar_name|  ivar_name.to_s.gsub(/@/, '')}
+        .yield_self       {|ivars|      ivars - ['events', 'uuid']}
+        .reduce(Hash.new) {|memo, obj|  memo[obj.to_sym] = self.send(obj); memo }
       end
-
       alias_method :to_hash, :to_h
 
       private
@@ -70,20 +72,22 @@ module Dry
         uuid = SecureRandom.uuid,
         { id:   uuid,
           uuid: uuid,
-          type: { name:    self.class.name,
-                  version: '0' } }
+          type: { name: self.class.name } }
       end
 
       def _handle_event event
         if self.uuid != event.metadata[:aggregate_id]
-          fail "Event don't belong to aggregate instance. Aggregate #{self.inspect}, Event: #{event.inspect}"
+          fail "Event don't belong to aggregate instance. \n
+                Aggregate #{self.inspect} \n
+                Event: #{event.inspect}"
         end
+
         handler_name =
           self
           .class
           .find_event_handler(event.metadata[:type][:name])
 
-        self.send(handler_name, event)
+        self.send(handler_name, event) if handler_name
       end
 
       def _transfer_data_from_event event

data/lib/dry/facts/command.rb

@@ -36,14 +36,14 @@ module Dry
         def define_input_contract &block
           @input_contract =
             Class
-            .new(Dry::Struct)
+            .new(Dry::Struct::Value)
             .yield_self { |k| k.instance_eval(&block) if block }
         end
 
         def define_output_contract &block
           @output_contract =
             Class
-            .new(Dry::Struct)
+            .new(Dry::Struct::Value)
             .yield_self { |k| k.instance_eval(&block) if block }
         end
 
@@ -54,7 +54,8 @@ module Dry
             self::InputContract
           else
             self.input_contract
-          end.yield_self {|c| _enforce_contract_if_present(c, input) }
+          end
+          .yield_self {|c| _enforce_contract_if_present(c, input) }
         end
 
         def _enforce_output_contract_on output
@@ -62,16 +63,17 @@ module Dry
             self::OutputContract
           else
             self.output_contract
-          end.yield_self {|c| _enforce_contract_if_present(c, output) }
+          end
+          .yield_self {|c| _enforce_contract_if_present(c, output) }
         end
 
         def _execute_with input
           self.new.call input
         end
 
-        def _enforce_contract_if_present(contract, data)
+        def _enforce_contract_if_present contract, data
           if contract
-            contract.new(**data)
+            contract.new **data
           else
             data
           end

data/lib/dry/facts/version.rb

@@ -1,5 +1,5 @@
 module Dry
   module Facts
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dry-facts
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Andriy Tyurnikov