low_state 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 529a5fa5c7b7aa94d9df0d5bab5cb409970206f6d4f0e41cafb370fcee8788f3
-  data.tar.gz: c3f2a4bfb4fa7c32be0731e0fe37e0befd93a112932ba7283940d57c3fd1a2b1
+  metadata.gz: a7f8551226b4f95f7ef5778fb8e83cc7580007ccf9d463d151311203a6427dc3
+  data.tar.gz: 88a706762b5372cf69b96a043db9b29f24766652b560aba8843355190d8cb6e9
 SHA512:
-  metadata.gz: 0a96425242664f4438c6b59febcdc55a287237a9b30a5883f94a7dc31e69cfabcdae52f48a29427583d6bf7f585c7076c9bf14f9fed9d0a0151ace5c3e376e89
-  data.tar.gz: a686f5c2a10f54e4878fc15cb2b0ba8ca8453b5f968e299183166ec105d8c992fcc81e24a7fa676b669d9363132e630ff21532d4c64b9f1e3e4a7b94c8056ec6
+  metadata.gz: 3633447429803efb5bc09b8c228ca84c105b3123824031786e437c91ee9c48b47da04810ef2c9096001f5098b7f5a4ad00dc12e00e2eec90e0dcd5fb2775b539
+  data.tar.gz: ef99c7f8107902aa4026063898e86f0fdc9fd5e0de6702f18c642d90495a3993fe67c4e94c66293c3ba3a84d0a46f7463915705d564e420195dc8d483d6461b2

data/lib/low_state.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+
+module LowState
+  class StateChangeError < StandardError; end
+
+  def current_state
+    @current_state ||= states.keys.first
+  end
+
+  def change_state(new_state, *args)
+    state = states[new_state]
+    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
+      # Class level variables because we want states to be accessed by any other included module or subclass.
+      @@states = {}
+
+      def states
+        @@states
+      end
+    end
+
+    base.extend ClassMethods
+  end
+
+  module ClassMethods
+    def low_state(state)
+      class_states = class_variable_get :@@states
+
+      if state.is_a?(Symbol)
+        class_states[state] = State.new(state:)
+      elsif state.is_a?(Hash)
+        state_name = state.keys.first
+        class_states[state_name] = State.new(state:, from: [*state[state_name]])
+      elsif state.is_a?(State)
+        class_states[state.state] = state
+      end
+
+      class_variable_set :@@states, class_states
+    end
+  end
+
+  class State
+    attr_reader :state, :from, :before, :after
+
+    def initialize(state:, from: nil, 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.nil? || @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.1.3'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: low_state
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - maedi
@@ -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: