low_state 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 529a5fa5c7b7aa94d9df0d5bab5cb409970206f6d4f0e41cafb370fcee8788f3
-  data.tar.gz: c3f2a4bfb4fa7c32be0731e0fe37e0befd93a112932ba7283940d57c3fd1a2b1
+  metadata.gz: 0a89a7e89f29c28b76d0b8a6ffc54ec2fa5fbf5eb9e6511b2a58505f4f75e3cd
+  data.tar.gz: 79b05d82e962249e9e5e341d1fcdd2cf7878388a2894f42fef37730ed42fa458
 SHA512:
-  metadata.gz: 0a96425242664f4438c6b59febcdc55a287237a9b30a5883f94a7dc31e69cfabcdae52f48a29427583d6bf7f585c7076c9bf14f9fed9d0a0151ace5c3e376e89
-  data.tar.gz: a686f5c2a10f54e4878fc15cb2b0ba8ca8453b5f968e299183166ec105d8c992fcc81e24a7fa676b669d9363132e630ff21532d4c64b9f1e3e4a7b94c8056ec6
+  metadata.gz: 4ff419f702882cae619b45fc478a01c402bad30422f95152d1ef44acda50f931c6bf4ce13132c2a66d38285c4395600cbf41eae0bb1318d200b0471cb28229ed
+  data.tar.gz: 82c52726c0739ac33117dbc217ea2ef41d389f45373aa054302fc8e55b84130978f425ebef059ca65cb4173caca6ac680027c5b4719cea806b1343e3335504ff

data/lib/low_state.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+
+module LowState
+  class StateChangeError < StandardError; end
+  class MissingStateError < StandardError; end
+
+  def current_state
+    @current_state ||= states.keys.first
+  end
+
+  def change_state(new_state, *args)
+    state = states[new_state]
+    raise MissingStateError, "State :#{new_state} missing in #{states.keys}" if state.nil?
+
+    before_result = state.has_before_callback?(self.class) ? send(state.before, *args) : true
+
+    if before_result != false && state.can_change_state?(current_state)
+      @current_state = new_state
+    elsif before_result != false && !state.can_change_state?(current_state) && state.can_error?
+      raise StateChangeError, "State did not change from :#{current_state} to :#{new_state}"
+    end
+
+    send(state.after, *args) if state.has_after_callback?(self.class)
+  end
+
+  def states
+    self.class.states
+  end
+
+  def self.included(base)
+    class << base
+      def states
+        @states ||= {}
+      end
+
+      def set_states(states)
+        @states = states
+      end
+
+      def low_state(state, **args)
+        class_states = states
+
+        if state.is_a?(Symbol)
+          class_states[state] = State.new(state:, **args)
+        elsif state.is_a?(State)
+          class_states[state.state] = state
+        end
+
+        set_states(class_states)
+      end
+    end
+  end
+
+  class State
+    attr_reader :state, :from, :before, :after
+
+    def initialize(state:, from: [], before: nil, after: nil, error: true)
+      @state = state
+      @from = [*from]
+      @before = before || "#{@state}_state_before"
+      @after = after || "#{@state}_state_after"
+      @error = error
+    end
+
+    def can_change_state?(current_state)
+      if @from.empty? || @from.include?(current_state)
+        return true
+      end
+
+      false
+    end
+
+    def can_error?
+      @error
+    end
+
+    def has_before_callback?(klass)
+      @has_before_callback ||= klass.method_defined?(@before)
+    end
+
+    def has_after_callback?(klass)
+      @has_after_callback ||= klass.method_defined?(@after)
+    end
+  end
+end

data/lib/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module LowState
+  VERSION = '0.2.0'
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: low_state
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - maedi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-24 00:00:00.000000000 Z
+date: 2025-09-25 00:00:00.000000000 Z
 dependencies: []
 description: A very fast low-level state machine. Uses no events for simplicity and
   speed, it just changes state.
@@ -17,7 +17,9 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- lib/low_state.rb
+- lib/version.rb
 homepage: https://codeberg.org/maedi/low_state
 licenses: []
 metadata: