low_state 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e28def9de139dd9c0e35741ab9b81370e64517e2964e47bd4ae5ede805cdc8e9
-  data.tar.gz: 8a864615d7515de0c2bd13c62a662b80f6fc1f8b305d2d292fcdbcc937b1cbdd
+  metadata.gz: a7f8551226b4f95f7ef5778fb8e83cc7580007ccf9d463d151311203a6427dc3
+  data.tar.gz: 88a706762b5372cf69b96a043db9b29f24766652b560aba8843355190d8cb6e9
 SHA512:
-  metadata.gz: 2c04141ffe236e8257bc4f6249fffb819214a166868a9aea57f7f8f55bb0ff67862c5b685c0aa4aefb0f64ffef98dd5a79f0dd407246ffbc6c11fdc5b5f99ebb
-  data.tar.gz: 4e26ed60e3bebaf742b30fd3db4bae22efe272c4fe6a495a2f723e83534e64111c4c47dad9a2602a38414113177d8ea5d6e587e66d543f980846def0c5286ba6
+  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.1
+  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: