decide.rb 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da945c90e06dab8eb7c391135319bf4f9e126fd2e1904ac4481aabfc4df8943a
-  data.tar.gz: 9e70f93d1ee072b555f7a44b8babc2c0fb0bef50df27949d3bd45654b8c05ed8
+  metadata.gz: 73423e6911201b60ed5a3333ef636880cc93751425e95b39e522bed75d9ca4a5
+  data.tar.gz: 2b352d0c34587f8dfe90e819504e3d07093de738ddde24cea4e96a152f09ce0d
 SHA512:
-  metadata.gz: 67a5f37bf266ce6ca5ca35820cc384fa502d33ca0dae794527d160dc7b247eb7e376c96f6dedfe204c348c25436d64db6c934d9fc407daf8e8421c38e23758bd
-  data.tar.gz: aea4f6f4de5a4509ce7b908fb04c59e6546f96c01502b762b564e5c8f44b7b235f380bf98631cf2f906d08eeaf210cde02564ce6060b5fbf9677fcbdd24b675f
+  metadata.gz: 8f2e2449fac23e3ae81014a6fd0cfefd5a2a888089c3c89b2072cb52592f6ba5bb659c9f2a816c6d8b13eb6082b463f42594dbffedb2add06469857b7bfe07d0
+  data.tar.gz: 1a310ac9f050f40ba09df6605860fc62b348e093133fd0237618726753d25f5c669f72b723b9072664862d1d80a01898dd963dbd323c97ef30c8533ed9f523e7

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+# Unreleased
+
+* Accept more data structures for commands and events
+
 # 0.3.0
 
 * Rename `Decider.state` to `Decider.initial_state`

data/examples/decide.md

@@ -21,3 +21,61 @@ Raise error when using `decide!`:
 decider.decide! :unknown, decider.initial_state
 #> raise ArgumentError, Unknown command
 ```
+
+## Commands
+
+Commands can be primitives like symbols:
+
+```ruby
+decider = Decider.define do
+  initial_state :initial
+
+  decide :start do |command, state|
+    case state
+    in :initial, :stopped
+      [:started]
+    else
+      []
+    end
+  end
+
+  decide :stop do |command, state|
+    case state
+    in :started
+      [:stopped]
+    else
+      []
+    end
+  end
+end
+```
+
+Or any classes like [Dry::Struct](https://dry-rb.org/gems/dry-struct/) or [Data](https://rubyapi.org/3.3/o/data):
+
+```ruby
+Start = Data.define(:value)
+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
+  end
+
+  decide Stop do |command, state|
+    case state
+    in :started
+      [:stopped]
+    else
+      []
+    end
+  end
+end
+```
+

data/examples/evolve.md

@@ -21,3 +21,42 @@ Raise error when using `evolve!`:
 decider.evolve! decider.initial_state, :unknown
 #> raise ArgumentError, Unknown event
 ```
+
+## Events
+
+Events can be primitives like symbols:
+
+```ruby
+decider = Decider.define do
+  initial_state :initial
+
+  evolve :started do |state, event|
+    :started
+  end
+
+  evolve :stopped do |state, event|
+    :stopped
+  end
+end
+```
+
+Or any classes like [Dry::Struct](https://dry-rb.org/gems/dry-struct/) or [Data](https://rubyapi.org/3.3/o/data):
+
+```ruby
+State = Data.define(:speed)
+Started = Data.define(:speed)
+Stopped = Data.define
+
+decider = Decider.define do
+  initial_state State.new(speed: 0)
+
+  evolve Started do |state, event|
+    State.new(speed: event.speed)
+  end
+
+  evolve Stopped do |state, event|
+    State.new(speed: 0)
+  end
+end
+```
+

data/lib/decider/version.rb

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

data/lib/decider.rb

@@ -29,7 +29,7 @@ module Decider
   end
 
   class Module < ::Module
-    def initialize(initial_state:, deciders:, evolvers:, terminal:)
+    def initialize(initial_state:, deciders:, evolutions:, terminal:)
       define_method(:initial_state) do
         initial_state
       end
@@ -39,39 +39,43 @@ module Decider
       end
 
       define_method(:events) do
-        evolvers.keys
+        evolutions.keys
       end
 
       define_method(:decide!) do |command, state|
-        handler = deciders.fetch(command.class) {
-          raise ArgumentError, "Unknown command: #{command.class}"
-        }
-
-        handler.call(command, state)
+        case deciders.find { |key, _| key === command }
+        in [_, handler]
+          handler.call(command, state)
+        else
+          raise ArgumentError, "Unknown command: #{command.inspect}"
+        end
       end
 
       define_method(:decide) do |command, state|
-        handler = deciders.fetch(command.class) {
-          return []
-        }
-
-        handler.call(command, state)
+        case deciders.find { |key, _| key === command }
+        in [_, handler]
+          handler.call(command, state)
+        else
+          []
+        end
       end
 
       define_method(:evolve!) do |state, event|
-        handler = evolvers.fetch(event.class) {
-          raise ArgumentError, "Unknown event: #{event.class}"
-        }
-
-        handler.call(state, event)
+        case evolutions.find { |key, _| key === event }
+        in [_, handler]
+          handler.call(state, event)
+        else
+          raise ArgumentError, "Unknown event: #{event.inspect}"
+        end
       end
 
       define_method(:evolve) do |state, event|
-        handler = evolvers.fetch(event.class) {
-          return state
-        }
-
-        handler.call(state, event)
+        case evolutions.find { |key, _| key === event }
+        in [_, handler]
+          handler.call(state, event)
+        else
+          state
+        end
       end
 
       define_method(:terminal?) do |state|
@@ -88,7 +92,7 @@ module Decider
     def initialize
       @initial_state = DEFAULT
       @deciders = {}
-      @evolvers = {}
+      @evolutions = {}
       @terminal = ->(_state) { false }
     end
 
@@ -102,7 +106,7 @@ module Decider
       @module = Module.new(
         initial_state: @initial_state,
         deciders: deciders,
-        evolvers: evolvers,
+        evolutions: evolutions,
         terminal: terminal
       )
 
@@ -113,7 +117,7 @@ module Decider
 
     private
 
-    attr_reader :deciders, :evolvers, :terminal
+    attr_reader :deciders, :evolutions, :terminal
 
     def initial_state(state)
       raise StateAlreadyDefined if @initial_state != DEFAULT
@@ -126,7 +130,7 @@ module Decider
     end
 
     def evolve(event, &block)
-      evolvers[event] = block
+      evolutions[event] = block
     end
 
     def terminal?(&block)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: decide.rb
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jan Dudulski