decide.rb 0.5.2 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef8af0a9aa14ef5a19fce005eba64d4b4504277493434c4091510e49f1378a39
-  data.tar.gz: 4ca62248b625d9bc3926749565c0ac4ef066a7fb46bd3cf0ec605f0c72d3e4b1
+  metadata.gz: 67225cdb4ecbd0f8577bc2c9744e85958a6fc74252e29014bb957e0c927ee0d9
+  data.tar.gz: 62bf259ddc73c780bc7993e4b597c90e45a047a4981263e81afdc44dcf07399a
 SHA512:
-  metadata.gz: 2326979a7350bf881484052c80cba5147f160a923f41b39c80420da5424e9239b62b6758460efeef81198fb83aec4e026a933a503661cf2ced329bb83dbbd12d
-  data.tar.gz: 07d38ce7613facb15a5e553482cf7b43d05f8b2743c3cac9b26f1fc9ad909cd87e24c03b20fc0258b554a4d9c08fa03123c6f27a36f661d31db054cef52c5221
+  metadata.gz: d7e5a790ab4d45b0d73a189ecdb19907ca139742a61f02dd146c38aa8e61619c55f744095085d89292f3f53976f60ecec17799b3dcc58166a0e5201eb3b8641a
+  data.tar.gz: f27228fda1b9ca07c19cb01d004576ef106de6a2c96c7ce19a4a4b7976b4a5260dca7c91bb59d2404009387152ccd0ce10537e00fe9e76d0e8054992946055d3

data/CHANGELOG.md

@@ -1,3 +1,131 @@
+# 0.5.4
+
+* Add `lmap_on_event` and `rmap_on_event` extensions that takes proc that maps event in or out and returns a new decider
+
+```ruby
+decider = Decider.define do
+  initial_state 0
+
+  decide :increase do
+    :increased
+  end
+
+  evolve :increased do
+    state + 1
+  end
+end
+
+lmap = decider.lmap_on_event(->(event) { event.to_sym })
+lmap.evolve(0, "increased")
+# => 1
+
+rmap = decider.rmap_on_event(->(event) { event.to_s })
+rmap.decide(:increase, 0)
+# => "increased"
+```
+
+* Add `lmap_on_state` and `rmap_on_state` extensions that takes proc that maps state in or out and returns a new decider
+
+```ruby
+decider = Decider.define do
+  initial_state :symbol
+
+  decide :command, :state do
+    emit :called
+  end
+
+  evolve :state, :called do
+    :new_state
+  end
+end
+decider.initial_state
+# => :symbol
+
+lmap = decider.lmap_on_state(
+  ->(state) { state.to_sym }
+)
+lmap.initial_state
+# => :symbol
+lmap.decide(:command, "symbol")
+# => [:called]
+lmap.evolve("symbol", :called)
+# => :new_state
+
+rmap = inner.rmap_on_state(
+  ->(state) { state.to_s }
+)
+rmap.initial_state
+# => "symbol"
+rmap.decide(:command, :symbol)
+# => [:called]
+rmap.evolve(:symbol, :called)
+# => "new_state"
+```
+
+# 0.5.3
+
+* Add shortcut for evolving:
+
+```ruby
+# this three are the same now
+[event, event].reduce(state) { |s, e| decider.evolve(s, e) }
+[event, event].reduce(state, &decider.method(:evolve))
+
+# new
+[event, event].reduce(state, &decider.evolve)
+```
+
+# 0.5.2
+
+* Add `dimap_on_event` extension that takes procs that maps event in and out and returns a new decider
+
+```ruby
+inner = Decider.define do
+  initial_state 0
+
+  decide :increase do
+    :increased
+  end
+
+  evolve :increased do
+    state + 1
+  end
+end
+
+outer = inner.dimap_on_event(
+  fl: ->(event) { event.to_sym },
+  fr: ->(event) { event.to_s }
+)
+
+outer.decide(:increase, 0)
+# => "increased"
+
+outer.evolve(0, "increased")
+# => 1
+```
+
+# 0.5.1
+
+* Add `dimap_on_state` extension that takes procs that maps state in and out and returns a new decider
+
+```ruby
+inner = Decider.define do
+  initial_state :symbol
+end
+inner.initial_state
+# => :symbol
+
+outer = inner.dimap_on_state(
+  fl: ->(state) { state.to_sym },
+  fr: ->(state) { state.to_s }
+)
+outer.initial_state
+# => "symbol"
+
+# under the hood it will run inner.decide(:command, :symbol)
+outer.decide(:command, "symbol")
+```
+
 # 0.5.0
 
 * Support pattern matching for commands and events

data/examples/decide.md

@@ -18,7 +18,7 @@ decider = Decider.define do
 end
 
 decider.decide Command.new(value: 10), decider.initial_state
-#> [Event.new(value: 15)]
+#> [#<data Event value=15>]
 ```
 
 ## Match by command and state
@@ -138,7 +138,7 @@ decider = Decider.define do
     emit [:started, command.value]
   end
 
-  decide proc { [command, state] in [Stop, [:started, _]] } do
+  decide proc { [command, state] in [Stop, :started] } do
     emit :stopped
   end
 end

data/examples/evolve.md

@@ -1,25 +1,88 @@
 # Evolve
 
-## Handling unknown events
+## Match by event
 
 ```ruby
+Event = Data.define(:value)
+
 decider = Decider.define do
   initial_state :initial
+
+  evolve Event do
+    event.value
+  end
 end
+
+decider.evolve decider.initial_state, Event.new(value: :changed)
+#> :changed
 ```
 
-Return state (nothing changed) by default:
+## Match by state and event
 
 ```ruby
+decider = Decider.define do
+  initial_state :turned_off
+
+  evolve :turned_on, :turned_off do
+    event
+  end
+
+  evolve :turned_off, :turned_on do
+    event
+  end
+end
+
+decider.evolve decider.initial_state, :turned_on
+#> :turned_on
+decider.evolve :turned_on, :turned_off
+#> :turned_off
+decider.evolve :turned_on, :unknown
+#> :turned_on
+```
+
+## Match by pattern matching
+
+```ruby
+State = Data.define(:value)
+Event = Data.define(:value)
+
+decider = Decider.define do
+  initial_state State.new(value: :turned_off)
+
+  evolve proc { [state, event] in [State(value: :turned_off), Event(value: :turned_on)] } do
+    state.with(value: event.value)
+  end
+end
+
+decider.evolve decider.initial_state, Event.new(value: :turned_on)
+#> #<data State value=:turned_on>
 decider.evolve decider.initial_state, :unknown
+#> #<data State value=:turned_off>
+```
+
+## Handling unknown events
+
+```ruby
+decider = Decider.define do
+  initial_state :initial
+end
+
+decider.decide decider.initial_state, :initial
 #> :initial
 ```
 
-Raise error when using `evolve!`:
+If you want to raise error, define a catch-all as last one:
 
 ```ruby
-decider.evolve! decider.initial_state, :unknown
-#> raise ArgumentError, Unknown event
+decider = Decider.define do
+  initial_state :initial
+
+  evolve proc { true } do
+    raise ArgumentError, "Unknown event #{event}"
+  end
+end
+decider.evolve decider.initial_state, :unknown
+#> Unknown event unknown (ArgumentError)
 ```
 
 ## Events
@@ -30,11 +93,11 @@ Events can be primitives like symbols:
 decider = Decider.define do
   initial_state :initial
 
-  evolve :started do |state, event|
+  evolve :started do
     :started
   end
 
-  evolve :stopped do |state, event|
+  evolve :stopped do
     :stopped
   end
 end
@@ -50,13 +113,38 @@ Stopped = Data.define
 decider = Decider.define do
   initial_state State.new(speed: 0)
 
-  evolve Started do |state, event|
-    State.new(speed: event.speed)
+  evolve State, Started do
+    state.with(speed: event.speed)
   end
 
-  evolve Stopped do |state, event|
+  evolve State, Stopped do
     State.new(speed: 0)
   end
 end
 ```
 
+## Calculate state
+
+In most cases you want to take a collection of events and reduce them with `evolve` to calculate the state, like:
+
+```ruby
+decider = Decider.define do
+  initial_state 0
+
+  evolve :increased do
+    state + 1
+  end
+end
+
+[:increased, :increased].reduce(decider.initial_state) { |state, event| decider.evolve(state, event) }
+#> 2
+```
+
+You can shortcut that with `&`:
+
+```ruby
+[:increased, :increased].reduce(decider.initial_state, &decider.method(:evolve))
+#> 2
+[:increased, :increased].reduce(decider.initial_state, &decider.evolve)
+#> 2
+```

data/examples/state.md

@@ -8,11 +8,11 @@ State = Data.define(:value)
 decider = Decider.define do
   initial_state State.new(value: 0)
 
-  decide Commands::Command do |command, state|
-    [Events::Event.new(value: command.value)]
+  decide Commands::Command do
+    emit Events::Event.new(value: command.value)
   end
 
-  evolve Events::Event do |state, event|
+  evolve Events::Event do
     state.with(value: state.value + 1)
   end
 end
@@ -24,26 +24,16 @@ end
 decider = Decider.define do
   initial_state :turned_off
 
-  decide Commands::TurnOn do |_command, state|
-    case state
-    in :turned_off
-      [Events::TurnedOn.new]
-    else
-      []
-    end
+  decide Commands::TurnOn, :turned_off do
+    emit Events::TurnedOn.new
   end
 
-  decide Commands::TurnOff do |_command, state|
-    case state
-    in :turned_on
-      [Events::TurnedOn.new]
-    else
-      []
-    end
+  decide Commands::TurnOff, :turned_on do
+    emit Events::TurnedOff.new
   end
 
-  evolve Events::TurnedOn do |_state, _event|
-    :turned_off
+  evolve Events::TurnedOn do
+    :turned_on
   end
 end
 ```
@@ -54,12 +44,12 @@ end
 decider = Decider.define do
   initial_state []
 
-  decide Commands::Command do |command, _state|
-    [Events::Event.new(value: command.value)]
+  decide Commands::Command, [] do
+    emit Events::Event.new(value: command.value)
   end
 
-  evolve Events::Event do |state, event|
-    state = state + [event]
+  evolve Events::Event do
+    state + [event]
   end
 end
 ```

data/lib/decider/version.rb

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

data/lib/decider.rb

@@ -47,7 +47,11 @@ module Decider
         _events.push(*events)
       end
     end
-    Evolve = Data.define(:state, :event)
+    Evolve = Data.define(:state, :event) do
+      def self.build(state, event)
+        new(state: state, event: event)
+      end
+    end
     Terminal = Data.define(:state)
 
     def initialize(initial_state:, deciders:, evolutions:, terminal:)
@@ -75,23 +79,27 @@ module Decider
         context._events
       end
 
-      define_method(:evolve) do |state, event|
-        context = Evolve.new(state: state, event: event)
-
-        evolutions.find(EVOLVE_FALLBACK) do |args, _|
-          case args
-          in [Proc => fn]
-            context.instance_exec(&fn)
-          in [etype]
-            event in ^etype
-          in [stype, etype]
-            [state, event] in [^stype, ^etype]
-          else
-            false
-          end
-        end => [_, handler]
-
-        context.instance_exec(&handler)
+      define_method(:evolve) do |*args|
+        if args.empty?
+          ->(state, event) { evolve(state, event) }
+        else
+          context = Evolve.build(*args)
+
+          evolutions.find(EVOLVE_FALLBACK) do |args, _|
+            case args
+            in [Proc => fn]
+              context.instance_exec(&fn)
+            in [etype]
+              context.event in ^etype
+            in [stype, etype]
+              [context.state, context.event] in [^stype, ^etype]
+            else
+              false
+            end
+          end => [_, handler]
+
+          context.instance_exec(&handler)
+        end
       end
 
       define_method(:terminal?) do |state|
@@ -100,10 +108,26 @@ module Decider
         context.instance_exec(&terminal)
       end
 
+      define_method(:lmap_on_state) do |fn|
+        Decider.lmap_on_state(self, fn)
+      end
+
+      define_method(:rmap_on_state) do |fn|
+        Decider.rmap_on_state(self, fn)
+      end
+
       define_method(:dimap_on_state) do |fl:, fr:|
         Decider.dimap_on_state(self, fl: fl, fr: fr)
       end
 
+      define_method(:lmap_on_event) do |fn|
+        Decider.lmap_on_event(self, fn)
+      end
+
+      define_method(:rmap_on_event) do |fn|
+        Decider.rmap_on_event(self, fn)
+      end
+
       define_method(:dimap_on_event) do |fl:, fr:|
         Decider.dimap_on_event(self, fl: fl, fr: fr)
       end
@@ -203,6 +227,14 @@ module Decider
     end
   end
 
+  def self.lmap_on_state(decider, fn)
+    dimap_on_state(decider, fl: fn, fr: ->(state) { state })
+  end
+
+  def self.rmap_on_state(decider, fn)
+    dimap_on_state(decider, fl: ->(state) { state }, fr: fn)
+  end
+
   def self.dimap_on_state(decider, fl:, fr:)
     define do
       initial_state fr.call(decider.initial_state)
@@ -221,6 +253,14 @@ module Decider
     end
   end
 
+  def self.lmap_on_event(decider, fn)
+    dimap_on_event(decider, fl: fn, fr: ->(event) { event })
+  end
+
+  def self.rmap_on_event(decider, fn)
+    dimap_on_event(decider, fl: ->(event) { event }, fr: fn)
+  end
+
   def self.dimap_on_event(decider, fl:, fr:)
     define do
       initial_state decider.initial_state

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: decide.rb
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.4
 platform: ruby
 authors:
 - Jan Dudulski
 bindir: exe
 cert_chain: []
-date: 2025-04-12 00:00:00.000000000 Z
+date: 2025-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby