metacosm 0.2.13 → 0.2.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f78fea361e727ab756d606811ca59e1f52a5b1e5
-  data.tar.gz: b6539a027a2cf2bac9270b3c60b8a3246b35c228
+  metadata.gz: 68f1b5dd4218a10775dfe6aae1afc0b4db1e295d
+  data.tar.gz: b6d7707b7b226b4d30a8f1d3a89e275aee2973b2
 SHA512:
-  metadata.gz: c34e16473d596582f095fa4785cb01e0de4f7a3436eae237b582ed504a1c9555950892afe4a643fbc85716cbb473d40b5d149778d0acbc4e2d7cc1f22f1a6ee4
-  data.tar.gz: 15c5c5734f37cd1a1c088822027127dedc861381a25d3934fc6d622905fdec38666c12c299eb3acdbf9e3cc23f7be77430ab6867502bf4cc1bf4c2e2269ec107
+  metadata.gz: f6aaa059326435c46219c6205a21892b999980d9fc40d1108e1ec7ed47052206698098f94b8e7ce40c5a009002f38ce15c081337b2eb4f08a95b67d119e05d42
+  data.tar.gz: 8653b0c85c98fa87b1e09036ecc01e7e5ede20696b56e57ba660843951bba77c63ad7ce48ed150c494185ffb3a339514f72b18ed4983cff08fd12675c072a1e6

data/README.md

@@ -10,181 +10,24 @@
 
 Metacosm is an awesome microframework for building reactive systems.
 
-The idea is to enable quick prototyping of command-query separated or event-sourced systems.
+## Goals
 
-One core concept is that we use commands to update "write-only" models, 
-which trigger events that update "read-only" view models that are used by queries. 
+Enable quick prototyping of command-query separated architectures, and empower development of event-sourced systems.
+
+## Background
+
+One core concept is that we use commands to update "write-only" models, which trigger events that update "read-only" view models that are used by queries. 
 
 Models only transform their state in response to commands, so their state can be reconstructed by replaying the stream of commands.
 
 ## Features
 
- - One interesting feature here is a sort of mock in-memory AR component called `Registrable` that is used for internal tests (note: this has been extracted to [PassiveRecord](http://github.com/deepcerulean/passive_record))
+ - Distributed simulations using Redis 
 
 ## Examples
 
-
-Below is a Fizzbuzz implementation contrived enough to show off many of the features of the framework.
-
-You may also want to [look at this repository](https://github.com/jweissman/gol) which implements Conway's game of life using metacosm and gosu.
-
-````ruby
-  require 'metacosm'
-  include Metacosm
-  
-  class Counter < Model
-    def initialize
-      @counter = 0
-      super
-    end
-  
-    def fizz!
-      emit fizz
-    end
-  
-    def buzz!
-      emit buzz
-    end
-  
-    def increment!(inc)
-      @counter += inc
-      emit(counter_incremented)
-    end
-  
-    protected
-    def fizz
-      FizzEvent.create
-    end
-  
-    def buzz
-      BuzzEvent.create
-    end
-  
-    def counter_incremented
-      CounterIncrementedEvent.create(
-        value: @counter,
-        counter_id: @id
-      )
-    end
-  end
-  
-  class CounterView < View
-    attr_accessor :value, :counter_id
-    def update_value(new_value)
-      @value = new_value
-      self
-    end
-  end
-  
-  class IncrementCounterCommand < Command
-    attr_accessor :increment, :counter_id
-  end
-  
-  class IncrementCounterCommandHandler
-    def handle(increment:,counter_id:)
-      counter = Counter.find(counter_id)
-      counter.increment!(increment)
-    end
-  end
-  
-  class CounterIncrementedEvent < Event
-    attr_accessor :value, :counter_id
-  end
-  
-  class CounterIncrementedEventListener < EventListener
-    def receive(value:,counter_id:)
-      update_counter_view(counter_id, value)
-  
-      fizz_buzz!(counter_id, value)
-      puts(value) unless fizz?(value) || buzz?(value)
-    end
-  
-    def update_counter_view(counter_id, value)
-      counter_view = CounterView.where(counter_id: counter_id).first_or_create
-      counter_view.update value: value
-    end
-  
-    private
-    def fizz_buzz!(counter_id, n)
-      fire(FizzCommand.create(counter_id: counter_id)) if fizz?(n)
-      fire(BuzzCommand.create(counter_id: counter_id)) if buzz?(n)
-    end
-  
-    def fizz?(n); n % 3 == 0 end
-    def buzz?(n); n % 5 == 0 end
-  end
-  
-  class FizzCommand < Command
-    attr_accessor :counter_id
-  end
-  
-  class FizzCommandHandler
-    def handle(counter_id:)
-      counter = Counter.find(counter_id)
-      counter.fizz!
-    end
-  end
-  
-  class BuzzCommand < Command
-    attr_accessor :counter_id
-  end
-  
-  class BuzzCommandHandler
-    def handle(counter_id:)
-      counter = Counter.find(counter_id)
-      counter.buzz!
-    end
-  end
-  
-  class FizzEvent < Event
-  end
-  
-  class FizzEventListener < EventListener
-    def receive
-      puts "fizz"
-    end
-  end
-  
-  class BuzzEvent < Event
-  end
-  
-  class BuzzEventListener < EventListener
-    def receive
-      puts "buzz"
-    end
-  end
-````
-
-  Given all this prelude we can run a fizzbuzz "simulation":
-
-````ruby
-  sim = Simulation.current
-  counter_model = Counter.create
-  counter_view = CounterView.find_by(counter_id: counter_model.id)
-  
-  counter_view.value # => 0
-
-  increment_counter_command = IncrementCounterCommand.create(
-    increment: 1, counter_id: counter_model.id
-  )
-  
-  sim.apply(increment_counter_command)
-
-  counter_view.value # => 1
-
-  100.times { sim.apply(increment_counter_command) }
-
-  sim.events.take(10)
-  # => [CounterCreatedEvent (id: 1, counter_id: 1),
-  #  CounterIncrementedEvent (id: 1, value: 1, counter_id: 1),
-  #  CounterIncrementedEvent (id: 2, value: 2, counter_id: 1),
-  #  CounterIncrementedEvent (id: 3, value: 3, counter_id: 1),
-  #  FizzEvent (id: 1),
-  #  CounterIncrementedEvent (id: 4, value: 4, counter_id: 1),
-  #  CounterIncrementedEvent (id: 5, value: 5, counter_id: 1),
-  #  BuzzEvent (id: 1),
-  #  CounterIncrementedEvent (id: 6, value: 6, counter_id: 1)]
-````
+- [Game of Life](https://github.com/jweissman/gol), which implements Conway's game of life using metacosm and gosu
+- [Socius](http://github.com/jweissman/socius), a civlike using the Redis integration to communicate with a game server running the sim
 
 ## Requirements
 

data/lib/metacosm/remote_simulation.rb

@@ -1,6 +1,8 @@
 module Metacosm
   class RemoteSimulation < Simulation
-    def initialize
+    def initialize(command_queue, event_stream)
+      @command_queue_name = command_queue
+      @event_stream_name  = event_stream
       setup_connection
     end
 
@@ -11,14 +13,14 @@ module Metacosm
     def fire(command)
       command_dto = command.attrs.merge(handler_module: command.handler_module_name, handler_class_name: command.handler_class_name)
       redis = redis_connection
-      redis.publish(:socius_command_queue, Marshal.dump(command_dto))
+      redis.publish(@command_queue_name, Marshal.dump(command_dto))
     end
 
     def setup_connection
       @remote_listener_thread = Thread.new do
         begin
           redis = redis_connection
-          redis.subscribe(:socius_event_stream) do |on|
+          redis.subscribe(@event_stream_name) do |on|
             on.subscribe do |channel, subscriptions|
               puts "Subscribed to remote simulation event stream ##{channel} (#{subscriptions} subscriptions)"
             end

data/lib/metacosm/version.rb

@@ -1,4 +1,4 @@
 module Metacosm
   # metacosm version
-  VERSION = "0.2.13"
+  VERSION = "0.2.14"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: metacosm
 version: !ruby/object:Gem::Version
-  version: 0.2.13
+  version: 0.2.14
 platform: ruby
 authors:
 - Joseph Weissman