Class: Gold::Machine

Inherits:
Object
  • Object
show all
Includes:
Statesman::Machine
Defined in:
app/models/gold/machine.rb

Overview

This is the finite state machine specification that governs how shops may transition from one state to another.

Constant Summary collapse

ACCEPTANCE_STATES =

These are stable states that a store can be in for an indefinite amount of time. Any watchdog task should ignore these states.

%i[affiliate billing done staff].freeze

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.ensure_min_days_in_state(duration_in_days) ⇒ Object

Ensure that a shop has been in a current state for longer than number of days



130
131
132
133
134
135
136
 
# File 'app/models/gold/machine.rb', line 130

def self.ensure_min_days_in_state(duration_in_days)
  test = proc { |billing|
    billing.state_machine.last_transition.updated_at < duration_in_days.days.ago
  }
  test.define_singleton_method(:to_s) { "After #{duration_in_days} days?" }
  test
end

.ensure_plan_is(query_method) ⇒ Object

Ensure that a shop has a certain type of plan before allowing a transition.



123
124
125
126
127
 
# File 'app/models/gold/machine.rb', line 123

def self.ensure_plan_is(query_method)
  test = proc { |billing| billing.shopify_plan.send(query_method) }
  test.define_singleton_method(:to_s) { "Billing is #{query_method}" }
  test
end

.require_metadata(*properties) ⇒ Object

Ensure that certain metadata properties are set before allowing a transition.



140
141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'app/models/gold/machine.rb', line 140

def self.require_metadata(*properties)
  proc do |_, transition|
    properties.each do |property|
      # rubocop:disable Style/Next
      unless transition.metadata.key?(property.to_sym) ||
             transition.metadata.key?(property.to_s)
        message = "Transition to #{transition.to_state} needs to have #{property} set"
        raise Gold::Exceptions::MetadataMissing, message
      end
      # rubocop:enable Style/Next
    end
  end
end

Instance Method Details

#accepted? ⇒ Boolean

Whether this state machine is currently in an acceptance state.

Returns:

  • (Boolean) 


112
113
114
 
# File 'app/models/gold/machine.rb', line 112

def accepted?
  ACCEPTANCE_STATES.include?(current_state.to_sym)
end

#current_state ⇒ Object 



116
117
118
 
# File 'app/models/gold/machine.rb', line 116

def current_state
  super.to_sym
end

#last_transition_to(*states) ⇒ Object

Like ‘last_transition` but returns the last transition to one of the states provided as arguments. Returns nil if no transitions match.



288
289
290
 
# File 'app/models/gold/machine.rb', line 288

def last_transition_to(*states)
  history.reverse.find { |t| states.include?(t.to_state.to_sym) }
end

#transition_to_or_stay_in(state, metadata = nil) ⇒ Object

Soft transition only if different from the current state



298
299
300
 
# File 'app/models/gold/machine.rb', line 298

def transition_to_or_stay_in(state, metadata = nil)
  current_state == state ? true : transition_to(state, metadata)
end

#transition_to_or_stay_in!(state, metadata = nil) ⇒ Object

Transition only if different from the current state



293
294
295
 
# File 'app/models/gold/machine.rb', line 293

def transition_to_or_stay_in!(state, metadata = nil)
  transition_to!(state, metadata) unless current_state == state
end