Workflow engine
Premises
- ActiveRecord
- Each state is a separate object.
Features
- State can be as rich in functionality was wanted.
- No data is ever lost. History is always saved.
- It is possible to track every single transition done in the workflow.
- Advancing a state is as easy as creating a state object and calling "save".
- Can transition to same state.
- Minimal code to define workflow and states.
Simple example for a Bulb with two states:
class Bulb < ActiveRecord::Base
include Control::Workflow
has_many :ons
has_many :offs
end
class On < ActiveRecord::Base
include Control::State
belongs_to :bulb
end
class Off < ActiveRecord::Base
include Control::State
belongs_to :bulb
next_states :on # optional, to constrain possible next states, can also specify :none to make a state final
end
def example
my_bulb = Bulb.new
my_on = On.new do |o|
o.bulb = my_bulb
end
my_off = Off.new do |o|
o.bulb = my_bulb
end
# Check possible states for my bulb. (On, Off)
my_bulb.states
# Transitions the bulb to the "On" state
my_on.save
# Transitions the bulb to the "Off" state
my_off.save
# Every transition is recorded. (On -> Off)
my_bulb.transitions
# Bulb knows which state is current. (Off)
my_bulb.current_state
end
Installing:
- Add control gem to gemfile.
gem 'control'or
gem 'control', :git => 'git://github.com/zeto/control.git' # Edge- Generate tables (run rake db:migrate after)
$ rails generate control_installTesting the gem:
$ bundle
$ rake