Twistar is a Python implementation of the active record pattern (also known as an object-relational mapper or ORM) that uses the Twisted framework's RDBMS support to provide a non-blocking interface to relational databases.
Since Twistar uses Twisted, most method and function calls will return a twisted.internet.defer.Deferred
object. You must understand the propper use of these objects before most of this documentation will make sense.