Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A hierarchical finite state machine library

Project Description

Copyright (c) 2009 Joseph Lisee All rights reserved.

License information

The OSI BSD License is used. Please See the file “LICENSE” for information on the history of this software, terms & conditions for usage, and a DISCLAIMER OF ALL WARRANTIES.

Quick Install

Run “python install” to install to the directory or “python install –prefix=<install_directory>” for the directory of your choice.

What is StatePy anyways?

StatePy is an event driven hierarchical finite state machine library that lets you easily design, build, and analyze state machines. It represents individuals states as classes, and by default uses static transition tables. The tables are simple python dicts maping events, which can be any hashable type, to the next state. Member functions of the state classes are called upon entering, upon exiting, and on every transition. To learn more check out the documentation.


See the docs folder for examples of StatePy’s features.

Web site

Check out for the latest releases and news.

Bug reports

To report or search for a bug please use the BitBucket based bug tracker at:


StatePy comes with a relatively complete, ~95% line coverage, set of unit tests which can be run with the simple command “python test”. If you have installed StatePy already you can use the function “statepy.test.runTests()” to run the tests at any time you desire. If you submit a feature/patch, you should include a tests for it as well.

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
StatePy-0.3.0.tar.gz (18.7 kB) Copy SHA256 Checksum SHA256 Source Dec 28, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting