Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Spinoff is a framework for writing distributed, fault tolerant and scalable applications in Python. Spinoff is based on the Actor Model and borrows from Akka (location transparency, actor references, etc) and Erlang (process-like actors).
Python

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
spinoff
twisted/plugins
.coveragerc
.gitignore
LICENSE
MANIFEST.in
README
README.rst
requirements.txt
setup.cfg
setup.py
twistd-autoreload.py

README.rst

Overview

Spinoff is a framework for writing distributed, fault tolerant and scalable applications in Python. Spinoff is based on the Actor Model and borrows from Akka (location transparency, actor references, etc) and Erlang (processes, nodename@hosthost style node references (not implemented yet)).

Spinoff has been built using Twisted as the underlying framework and ZeroMQ (via pyzmq and a fork of txzmq) for remoting.

Spinoff is currently under continuous development but is nevertheless usable for writing real applications—its fault tolerance features also protect it against bugs in its own code.

Example

The following is only a very small "peek preview" style example of what the framework can do. More examples and full documentation will follow soon.

# spinoff/examples/example1.py

from spinoff.actor import Actor
from spinoff.actor.process import Process
from spinoff.util.logging import dbg
from spinoff.util.async import sleep, with_timeout


class ExampleProcess(Process):
    def run(self):
        child = self.spawn(ExampleActor)

        while True:
            dbg("sending greeting to %r" % (child,))
            child << ('hello!', self.ref)

            dbg("waiting for ack from %r" % (child,))
            yield with_timeout(5.0, self.get('ack'))

            dbg("got 'ack' from %r; now sleeping a bit..." % (child,))
            yield sleep(1.0)


class ExampleActor(Actor):
    def pre_start(self):
        dbg("starting")

    def receive(self, msg):
        content, sender = msg
        dbg("%r from %r" % (content, sender))
        sender << 'ack'

    def post_stop(self):
        dbg("stopping")

The example can be run using the following command:

twistd --nodaemon startnode --actor spinoff.examples.example1.ExampleProcess
Something went wrong with that request. Please try again.