Stateful

• Classes gain the capacity of creating "states"
• States can override instance methods and create new ones
• States are inherited by subclasses
• States are stackable - the state on the top of the stack is the most prioritary
• There are callback functions invoked automatically when a state is entered, exited, pushed, popped ...

Example

localclass=require'middleclass'localStateful=require'stateful'localEnemy=class('Enemy')
Enemy:include(Stateful)
functionEnemy:initialize(health)
self.health=healthendfunctionEnemy:speak()
return'My health is' ..tostring(self.health)
endlocalImmortal=Enemy:addState('Immortal')
-- overriden functionfunctionImmortal:speak()
return'I am UNBREAKABLE!!'end-- added functionfunctionImmortal:die()
return'I can not die now!'endlocalpeter=Enemy:new(10)
peter:speak() -- My health is 10peter:gotoState('Immortal')
peter:speak() -- I am UNBREAKABLE!!peter:die() -- I can not die now!peter:gotoState(nil)
peter:speak() -- My health is 10

Installation

First, make sure that you have downloaded and installed middleclass

Just copy the stateful.lua file wherever you want it (for example on a lib/ folder). Then write this in any Lua file where you want to use it:

localclass=require'middleclass'localStateful=require'stateful'

The package.path variable must be configured so that the folder in which stateful.lua is copied is available, of course.

Specs

This project uses busted for its specs. In order to run them, install busted, and then execute it on the top folder:

busted