Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

AASM - State machines for Ruby classes

branch: multiplesm

This branch is 3 commits ahead and 138 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time


AASM - Ruby state machines

This package contains AASM, a library for adding finite state machines to Ruby classes.

AASM started as the acts_as_state_machine plugin but has evolved into a more generic library that no longer targets only ActiveRecord models.

AASM has the following features:

  • States

  • Machines

  • Events

  • Transitions


The latest AASM can currently be pulled from the git repository on github.

A release and a gem are forthcoming.


From GitHub hosted gems

% sudo gem sources -a # (you only need to do this once)
% sudo gem install rubyist-aasm

Building your own gems

% rake gem
% sudo gem install pkg/aasm-0.0.2.gem

Simple Example

Here's a quick example highlighting some of the features.

class Conversation
  include AASM

  aasm_initial_state :new

  aasm_state :new
  aasm_state :read
  aasm_state :closed

  aasm_event :view do
    transitions :to => :read, :from => [:new]

  aasm_event :close do
    transitions :to => :closed, :from => [:read, :new]

Other Stuff


Scott Barron <scott at elitists dot net>


Copyright 2006, 2007, 2008 by Scott Barron. Released under an MIT-style license. See the LICENSE file included in the distribution.


This software is provided “as is” and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.

Something went wrong with that request. Please try again.