RubyDoc.info: File: README – Documentation for pipa-statelogic (0.0.3)

Introduction

Hi there!

Features

State transitions validation.
State-scoped validations.
State-scoped lifecycle callbacks (before|after_save, etc)
???????
PROFIT!!!11

As a bonus you get multiple conditions in :if|:unless => [:one, :two, ...] callback and validation options (as in edge Rails).

Installation

gem install pipa-statelogic --source http://gems.github.com

Installable as a plugin too.

Bugs & such

pipa.lighthouseapp.com/projects/22857-statelogic

Example

class Order < ActiveRecord::Base
  ...
  statelogic do
    # you get methods +unpaid?+ and +was_unpaid?+.
    # may be more than one initial state.
    initial_state 'unpaid' do
      transitions_to 'ready', 'suspended' # won't let you change to wrong states
    end
    state 'ready' do # you get +ready?+, +was_ready?+
      transitions_to 'redeemed', 'suspended'
      validates_presence_of :txref # scoped validations
      before_save :prepare_for_plucking # scoped callbacks
    end
    state 'redeemed' do # likewise
      transitions_to 'suspended'
      validates_presence_of :txref, :redeemed_at, :facility_id # scoped validations
    end
    state 'suspended' do # you guess
      transitions_to 'unpaid', 'ready', 'redeemed'
    end
  end
  ...
end