decide.rb 0.5.0 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41af414c2f92dc8e43dad1ac61cf6ffb939fa65bc7217223b29e9780067ce5d3
-  data.tar.gz: 96342dea929121644eca8d924fbcd1112fbb21ec34fb666c00e87261cf7d4dc1
+  metadata.gz: ef8af0a9aa14ef5a19fce005eba64d4b4504277493434c4091510e49f1378a39
+  data.tar.gz: 4ca62248b625d9bc3926749565c0ac4ef066a7fb46bd3cf0ec605f0c72d3e4b1
 SHA512:
-  metadata.gz: acec8f3699e15b22ee30780b2b2e30cc95950c9d18701dbcaddc5788723780e0d6c09e16066c000db8a24ec87e62eadf20469c391c5140af662b9b951b61e41b
-  data.tar.gz: b088dec6fb91fe9417f83b73ebe58dd638d31ffb78f1245e62afa826a5f416d1bede83c41cc0d612afa29d50afeb119703a42e5ec3570daad08003b1bb304eb0
+  metadata.gz: 2326979a7350bf881484052c80cba5147f160a923f41b39c80420da5424e9239b62b6758460efeef81198fb83aec4e026a933a503661cf2ced329bb83dbbd12d
+  data.tar.gz: 07d38ce7613facb15a5e553482cf7b43d05f8b2743c3cac9b26f1fc9ad909cd87e24c03b20fc0258b554a4d9c08fa03123c6f27a36f661d31db054cef52c5221

data/examples/decide.md

@@ -1,5 +1,76 @@
 # Decide
 
+## Match by command
+
+```ruby
+Command = Data.define(:value)
+State = Data.define(:value)
+
+decider = Decider.define do
+  initial_state State.new(value: 5)
+
+  decide Command do
+    # emit events
+    emit Event.new(
+      value: command.value + state.value
+    )
+  end
+end
+
+decider.decide Command.new(value: 10), decider.initial_state
+#> [Event.new(value: 15)]
+```
+
+## Match by command and state
+
+```ruby
+decider = Decider.define do
+  initial_state :turned_off
+
+  decide :turn_on, :turned_off do
+    emit :turned_on
+  end
+
+  decide :turn_off, :turned_on do
+    emit :turned_off
+  end
+end
+
+decider.decide :turn_on, decider.initial_state
+#> [:turned_on]
+decider.decide :turn_off, :turned_on
+#> [:turned_off]
+decider.decide :turn_on, :turned_on
+#> []
+```
+
+## Match by pattern matching
+
+State = Data.define(:status)
+TurnOn = Data.define
+TurnOff = Data.define
+
+```ruby
+decider = Decider.define do
+  initial_state State.new(status: :turned_off)
+
+  decide proc { [command, state] in [TurnOn, State(status: :turned_off)] } do
+    emit :turned_on
+  end
+
+  decide proc { [command, state] in [TurnOff, State(status: :turned_on)] } do
+    emit :turned_off
+  end
+end
+
+decider.decide :turn_on, decider.initial_state
+#> [:turned_on]
+decider.decide :turn_off, :turned_on
+#> [:turned_off]
+decider.decide :turn_on, :turned_on
+#> []
+```
+
 ## Handling unknown commands
 
 ```ruby
@@ -15,11 +86,18 @@ decider.decide :unknown, decider.initial_state
 #> []
 ```
 
-Raise error when using `decide!`:
+If you want to raise error, define a catch-all as last one:
 
 ```ruby
-decider.decide! :unknown, decider.initial_state
-#> raise ArgumentError, Unknown command
+decider = Decider.define do
+  initial_state :initial
+
+  decide proc { true } do
+    raise ArgumentError, "Unknown command #{command}"
+  end
+end
+decider.decide :unknown, decider.initial_state
+#> Unknown command unknown (ArgumentError)
 ```
 
 ## Commands
@@ -30,24 +108,21 @@ Commands can be primitives like symbols:
 decider = Decider.define do
   initial_state :initial
 
-  decide :start do |command, state|
-    case state
-    in :initial, :stopped
-      [:started]
-    else
-      []
-    end
+  decide proc { [command, state] in [:start, :initial | :stopped] } do
+    emit :started
   end
 
-  decide :stop do |command, state|
-    case state
-    in :started
-      [:stopped]
-    else
-      []
-    end
+  decide proc { [command, state] in [:stop, :started] } do
+    emit :stopped
   end
 end
+
+decider.decide :start, decider.initial_state
+#> [:started]
+decider.decide :stop, :started
+#> [:stopped]
+decider.decider :start, :started
+#> []
 ```
 
 Or any classes like [Dry::Struct](https://dry-rb.org/gems/dry-struct/) or [Data](https://rubyapi.org/3.3/o/data):
@@ -59,23 +134,47 @@ Stop = Data.define
 decider = Decider.define do
   initial_state :initial
 
-  decide Start do |command, state|
-    case state
-    in :initial, :stopped
-      [:started, command.value]
-    else
-      []
-    end
+  decide proc { [command, state] in [Start, :initial | :stopped] } do
+    emit [:started, command.value]
   end
 
-  decide Stop do |command, state|
-    case state
-    in :started
-      [:stopped]
-    else
-      []
-    end
+  decide proc { [command, state] in [Stop, [:started, _]] } do
+    emit :stopped
   end
 end
+
+decider.decide Start.new(value: 10), decider.initial_state
+#> [[:started, 10]]
+decider.decide Stop.new, [:started, 10]
+#> [:stopped]
 ```
 
+## Emitting Events
+
+Decide can emit 0, 1 or more events:
+
+```ruby
+decider = Decider.define do
+  initial_state :initial
+
+  decide :none do
+    # noop
+  end
+
+  decide :one do
+    emit :event
+  end
+
+  decide :multiple do
+    emit :one
+    emit :two
+  end
+end
+
+decider.decide :none, decider.initial_state
+#> []
+decider.decide :one, decider.initial_state
+#> [:event]
+decider.decide :multiple, decider.initial_state
+#> [:one, :two]
+```

data/examples/infra.md

@@ -0,0 +1,15 @@
+# Infra
+
+## In memory
+
+```ruby
+require "decider/in_memory"
+
+GLOBAL = Decider::InMemory.new(MyDecider)
+
+# returns list of events
+GLOBAL.handle(command)
+
+# returns current state
+GLOBAL.state
+```

data/lib/decider/event_sourcing.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Decider
+  class EventSourcing
+    def initialize(decider:, event_store:)
+      @decider = decider
+      @event_store = event_store
+    end
+
+    def call(command, stream_name:)
+      events = event_store.read.stream(stream_name)
+      state = events.reduce(decider.initial_state, &decider.method(:evolve))
+
+      new_events = decider.decide(command, state)
+
+      event_store.append(new_events, stream_name: stream_name, expected_version: events.count)
+
+      [new_events, events.count + new_events.count]
+    end
+
+    private
+
+    attr_reader :decider, :event_store
+  end
+end

data/lib/decider/in_memory.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "concurrent-ruby"
+
+module Decider
+  class InMemory
+    def initialize(decider)
+      @decider = decider
+      @atom = Concurrent::Atom.new(decider.initial_state)
+    end
+
+    def call(command)
+      events = decider.decide(command, state)
+      atom.swap { |state| events.reduce(state, &decider.method(:evolve)) }
+      events
+    end
+
+    def state
+      atom.value
+    end
+
+    private
+
+    attr_reader :decider, :atom
+  end
+end

data/lib/decider/state.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Decider
+  class State
+    def initialize(decider:, repository:)
+      @decider = decider
+      @repository = repository
+    end
+
+    def call(command, key:, etag: nil)
+      state, etag = repository.try_load(key: key, etag: etag)
+
+      events = decider.decide(command, state)
+      new_state = events.reduce(state, &decider.method(:evolve))
+
+      new_etag = repository.save(new_state, key: key, etag: etag)
+
+      [events, new_etag]
+    end
+
+    private
+
+    attr_reader :decider, :repository
+  end
+end

data/lib/decider/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Decider
-  VERSION = "0.5.0"
+  VERSION = "0.5.2"
 end

data/lib/decider.rb

@@ -99,6 +99,14 @@ module Decider
 
         context.instance_exec(&terminal)
       end
+
+      define_method(:dimap_on_state) do |fl:, fr:|
+        Decider.dimap_on_state(self, fl: fl, fr: fr)
+      end
+
+      define_method(:dimap_on_event) do |fl:, fr:|
+        Decider.dimap_on_event(self, fl: fl, fr: fr)
+      end
     end
   end
 
@@ -194,4 +202,42 @@ module Decider
       end
     end
   end
+
+  def self.dimap_on_state(decider, fl:, fr:)
+    define do
+      initial_state fr.call(decider.initial_state)
+
+      decide proc { true } do
+        decider.decide(command, fl.call(state)).each(&method(:emit))
+      end
+
+      evolve proc { true } do
+        fr.call(decider.evolve(fl.call(state), event))
+      end
+
+      terminal? do
+        decider.terminal?(fl.call(state))
+      end
+    end
+  end
+
+  def self.dimap_on_event(decider, fl:, fr:)
+    define do
+      initial_state decider.initial_state
+
+      decide proc { true } do
+        decider.decide(command, state).each do |event|
+          emit fr.call(event)
+        end
+      end
+
+      evolve proc { true } do
+        decider.evolve(state, fl.call(event))
+      end
+
+      terminal? do
+        decider.terminal?(state)
+      end
+    end
+  end
 end

metadata

@@ -1,15 +1,56 @@
 --- !ruby/object:Gem::Specification
 name: decide.rb
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.2
 platform: ruby
 authors:
 - Jan Dudulski
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-15 00:00:00.000000000 Z
-dependencies: []
+date: 2025-04-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+- !ruby/object:Gem::Dependency
+  name: ruby_event_store
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
 description: Functional Event Sourcing Decider in Ruby
 email:
 - jan@dudulski.pl
@@ -25,8 +66,12 @@ files:
 - Steepfile
 - examples/decide.md
 - examples/evolve.md
+- examples/infra.md
 - examples/state.md
 - lib/decider.rb
+- lib/decider/event_sourcing.rb
+- lib/decider/in_memory.rb
+- lib/decider/state.rb
 - lib/decider/version.rb
 - sig/decider.rbs
 homepage: https://github.com/jandudulski/decide.rb
@@ -39,7 +84,6 @@ metadata:
   documentation_uri: https://github.com/jandudulski/decide.rb
   homepage_uri: https://github.com/jandudulski/decide.rb
   source_code_uri: https://github.com/jandudulski/decide.rb
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -54,8 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Functional Event Sourcing Decider in Ruby
 test_files: []