dry-facts 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e4989c09bf4471795f9770ae4c20bd9703198f557f1df1ec75e21bbbc390e51
-  data.tar.gz: 52fa236f7c4dca8c782e3671e0509ebb0e7965cd94453e4a16600cd814660f20
+  metadata.gz: b341b5c19a83f7f568b2cb9ad1b4f2caf14ec394d061c08509f0bc2940efd4c5
+  data.tar.gz: 36e9b955c5511f7ba03a0f6be0b682d79a1f3da410d77e2dfdced632f780a030
 SHA512:
-  metadata.gz: 44864e6199ee8c8d983af7c0c6335f66dec1d55f373d30d265fee97ca88aa541c0f2fa12baa52ee9b67a6543dde8d27ddf06453498da16f6649db17e6ece9e5d
-  data.tar.gz: fac80ac86674542a77946912b8d58b0f0176c033958e694ab334a99f9daece138b5ccd1012cfbebbae6a0224f4ed54af7fa4f9b8e7d6d8a382624f9c5c48bf7c
+  metadata.gz: fbeaffa2e91b48af5c9304e2fda103cfb104b8830971599a1168c4ea5392bd478449e2092f920725f1db7e824b85c372de16215fdcdc1225d636149f4a663b8e
+  data.tar.gz: 7e6e32fac315907ad1a60f547fd9e9c012d59498892d1390a5af2afc6b31ec686c36dbde3324261ff2489dae86d7d8e7df5d41db805be1c7c69c544ad480eefe

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dry-facts (0.1.0)
+    dry-facts (0.2.0)
       dry-equalizer (>= 0.0.11)
       dry-events (>= 0.1.0)
       dry-struct

data/README.md

@@ -3,6 +3,68 @@
 EventSourcing ruby toolkit, somewhat based on dry-rb primitives.
 Opinionated. Raw.
 
+## Goals
+
+* General EventSourcing toolkit for Ruby
+* Ability to generate GraphQL interface to Bounded Contexts
+* Idiomatic human-friendly API/DSL
+* Explore *data-primitives-first* approach minimize usage of Classes and inheritance
+
+## Basic concepts
+
+Example module structure:
+```ruby
+# Bounded Context - isolated autonomous module
+# it governs own state
+# and encapsulates interactions with outer world
+module AccountManagementContext
+  # State of the context is derived from persisted facts
+  module Events
+    Corrected
+    SignedUp
+    SignedIn
+    SignedOut
+    PasswordResetLinkRequested
+    PasswordResetLinkSent
+    PasswordUpdated
+  end
+
+  # Commands modify state by persisting events and
+  # encapsulate behaviors
+  module Commands
+    Correct
+    SignUp                    
+    SignIn                    
+    SignOut                   
+    PasswordResetTokenRequest
+    PasswordResetTokenSend    
+    PasswordReset
+  end
+
+  # Queries allow read access of context's state
+  # for inner and outer usage
+  # multiple storages of various types may be used
+  module Queries
+    IsEmailAvialable
+    AccountByUUID
+    AccountByEmail
+    AccountByPasswordResetToken
+    AccountByEmailAndEncryptedPassword
+
+    IsValidAuthTokenForAccount            
+    IsValidPasswordResetTokenForAccount   
+  end
+
+  # Aggregates are optionally post-processed
+  # collections of events, used for representation of data
+  module Aggregates
+    Account
+  end
+
+end
+```
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -21,7 +83,7 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+See example usage in `test/dummy_app`
 
 ## Development
 
@@ -30,7 +92,7 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
-
+Active development is visible in `develop` branch.
 Bug reports and pull requests are welcome on GitHub at https://github.com/andriytyurnikov/dry-facts.
 
 ## License

data/ROADMAP.md

@@ -7,16 +7,15 @@ pattern.
 Being able to build core behaviors and exposing those through GraphQL to the
 customers is the basic idea.
 
-Final solution is multifaceted:
-  GraphQL generation (?),
+Goal is multidimensional:
+  GraphQL generation from bounded context code (?),
   persistance,
   serialization,
   validations,
-  transactions,
-  composition - all of those are hard topics.
+  nested transactions,
+  async execution,
+  command composition
 
- In order to achieve such a goal
- I'll try to coordinate'Breadth-first' & 'Depth first' design strategies
 
 ## Top to bottom vision
 
@@ -72,7 +71,11 @@ No explicit types ?
       - [ ] Causality
       - [ ] Correlations
       - [ ] Transactions
-      - [ ] Lifecycle and maintenance tasks (snapshots (rolling, deployment) and versioning)
+      - [ ] Snapshots
+      - [ ] Projections
+      - [ ] Versioning
+      - [ ] Locking
+      - [ ] Lifecycle and maintenance tasks
     - [ ] Sequel store
     - [ ] ActiveRecord store
     - [ ] Redis store
@@ -94,18 +97,24 @@ No explicit types ?
     - [x] Class instance
     - [x] With events
     - [x] Data transfer DSL
-    - [ ] Hash instance
+    - [ ] Stream DSL
+    - [ ] Projection DSL
+    - [ ] Conversion to Hash
+    - [ ] Hash instance?
     - [ ] With contract?
     - [ ] Code & test generator
     - [ ] Docs from comments
-  * GraphQL generation
-    - [x] Skeleton without generation
-    - [ ] Type generation
-    - [ ] Mutation generation
+  * GraphQL
+    - [x] Data type
+    - [x] Query
+    - [ ] Paginated query
+    - [ ] Cursor paginated query
+    - [x] Mutation
+    - [ ] Unified mutation result (Relay?)
+    - [ ] Data generation
     - [ ] Query generation
-    - [ ] From hash
-    - [ ] Naive generation
-    - [ ] Customizable & helpers
+    - [ ] Mutation generation
+    - [ ] Schema from hash?
   * CI
   * JRuby tests
   * OpalRuby tests

data/lib/dry/facts/aggregate.rb

@@ -8,8 +8,8 @@ module Dry
       @event_handlers = Hash.new
 
       attr_reader :events
-      attr_reader :id
-      attr_reader :uuid
+      attr_accessor :id
+      attr_accessor :uuid
 
       class << self
         def build_one_from_events events
@@ -23,6 +23,10 @@ module Dry
           .map {|_, g_events| build_one_from_events(g_events) }
         end
 
+        def event_types
+          @event_handlers.keys
+        end
+
         def event_handlers
           @event_handlers
         end
@@ -46,12 +50,20 @@ module Dry
 
       def initialize(events)
         @events = events || []
-        @uuid = @id = if @events.first
+        first_event_aggregate_id= if @events.first
           @events.first.aggregate_id
         end
+        @uuid = @id = first_event_aggregate_id
+
         @events.each {|e| self.send :_handle_event, e}
       end
 
+      def to_h
+        {id: self.id, email: self.email}
+      end
+
+      alias_method :to_hash, :to_h
+
       private
 
       def _default_aggregate_metadata
@@ -64,7 +76,7 @@ module Dry
 
       def _handle_event event
         if self.uuid != event.metadata[:aggregate_id]
-          fail "This event is not mine!"
+          fail "Event don't belong to aggregate instance. Aggregate #{self.inspect}, Event: #{event.inspect}"
         end
         handler_name =
           self
@@ -76,7 +88,11 @@ module Dry
 
       def _transfer_data_from_event event
         event.data.keys.each do |key|
-          self.send "#{key}=", event.data[key]
+          if :id == key.to_sym
+            self.send "#{key}=", event.aggregate_id
+          else
+            self.send "#{key}=", event.data[key]
+          end
         end
       end
 

data/lib/dry/facts/event_store.rb

@@ -7,15 +7,32 @@ module Dry
           @serialized_events = []
         end
 
+        def delete_all
+          @serialized_events = []
+        end
+
+        def aggregate_by_id(klass, id)
+          get_events_by_aggregate_id(id)
+          .yield_self {|events| klass.build_one_from_events(events)}
+        end
+
+        def aggregates_by_ids(klass, ids)
+          get_events_by_aggregate_ids(ids)
+          .yield_self {|events| klass.build_all_from_events(events)}
+        end
+
+        def all_aggregates_of(klass)
+          get_events_by_types(klass.event_types)
+          .yield_self {|events| klass.build_all_from_events(events)}
+        end
+
         def aggregate_from_event(klass, event)
-          get_events_by_key(
-            key:    :aggregate_id,
-            value:  event.to_h[:data][:aggregate_id])
-          .yield_self {|events| klass.new(events)}
+          get_events_by_aggregate_id(event.to_h[:metadata][:aggregate_id])
+          .yield_self {|events| klass.build_one_from_events(events)}
         end
 
-        # persist_event_and_return(event)
-        def persist_event_and_return(event)
+        # commit(event)
+        def commit(event)
           # validate & fail
           @serialized_events << event.to_h
           event
@@ -28,16 +45,28 @@ module Dry
           # fail if many events found?
           @serialized_events
           .find_all   {|f|  fact_id == (f && f[:metadata] && f[:metadata][:id])}
-          .yield_self {|it| (0 == it.length) ? fail("No fact found") : it }
-          .yield_self {|it| (1 <  it.length) ? fail("Too may facts") : it }
+          .yield_self {|it| (0 == it.length) ? fail("No event found") : it }
+          .yield_self {|it| (1 <  it.length) ? fail("Too may events") : it }
           .first
           .yield_self {|it| deserialize_event(it)}
         end
 
-        # get_events_by_key(key: 'aggregate-id', value: 42)
-        def get_events_by_key(key:, value:)
+        def get_events_by_aggregate_id(value)
+          @serialized_events
+          .find_all   {|e|  value == e[:metadata][:aggregate_id]}
+          .map        {|it| deserialize_event(it)}
+        end
+
+        def get_events_by_aggregate_ids(value)
+          @serialized_events
+          .find_all   {|e|  [value].flatten.include? e[:metadata][:aggregate_id]}
+          .map        {|it| deserialize_event(it)}
+        end
+
+
+        def get_events_by_types(types)
           @serialized_events
-          .find_all   {|f|  value == f[key]}
+          .find_all   {|f| [types].flatten.include? f[:metadata][:type][:name]}
           .map        {|it| deserialize_event(it)}
         end
 

data/lib/dry/facts/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dry-facts
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andriy Tyurnikov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-02-20 00:00:00.000000000 Z
+date: 2018-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: require_all