= Acts As State Machine Hacks

I dig acts_as_state_machine (http://elitists.textdriven.com/svn/plugins/acts_as_state_machine/trunk/) and use it in 
almost all of my apps.  The biggest thing that bugged me was:

When you call a method like object.event! it writes to the database, instead of updating the current state, which makes 
it hard to set a state before validation.

== Installation

  script/plugin install http://elitists.textdriven.com/svn/plugins/acts_as_state_machine/trunk/
  script/plugin install git://github.com/zilkey/acts_as_state_machine_hacks.git

== What this plugin does

This plugin hack adds new methods without the exclamation point - it just updates the attribute.  So if you have:

  class Conversation < ActiveRecord::Base
    acts_as_state_machine :initial => :open
    state :opened
    state :closed

    event :open do
      transitions :to => :opened,   :from => :closed
    end
  end

ActsAsStateMachine would give you:

  conversation.open!
  
That uses update_attribute under the hood.  This plugin adds:

  conversation.open
  
Which just sets state to opened, without touching the database.  Suitable for calling before you save, like:

  def create
    @conversation = Conversation.new(params[:conversation])
    @conversation.open if params[:conversation][:publish] == "open"
    if @conversation.save
      ...
    else
      ...
    end
  end

  def update
    @conversation = Conversation.find(params[:id])
    @conversation.open if params[:conversation][:publish] == "open"
    if @conversation.update_attributes(params[:conversation]) # => if this doesn't validate, the state column will not 
    have been written
      ...
    else
      ...
    end
  end

I wrote this primarily because I often change state based on fields in the model - like if you check a "published" check 
box that changes a state from pending to published.

This also allows the possibility of adding a dropdown list to an admin screen where admins can set the status, while 
maintaining the integrity by still relying on events.

== Requirements

You must have the acts_as_state_machine plugin installed and the acts_as_state_machine directory must be named 
"acts_as_state_machine".

== Warning

This copies methods directly from acts_as_state_machine.  If acts_as_state_machine is updated, this plugin hack will 
likely break.

== For developers

If you want to add your own hacks, you can fork this project on 
http://github.com/zilkey/acts_as_state_machine_hacks/tree/master

It includes working tests, which can be the hardest part of testing a plugin.