Skip to main content
WARNING: PyPI Phishing attack ongoing. Please check that you are on the correct domain - PyPI dot org - before continuing  PyPI

Straightforward concurrency for Python http://vanillapy.readthedocs.org/

Project description

If Go and ZeroMQ had a baby, and that baby grew up and started dating PyPy, and they had a baby, it might look like Vanilla.

Overview

Vanilla allows you to build concurrent software in Python. Vanilla programs are structured around independent coroutines (greenlets) which communicate with each other via Pipes. Pipes are similar to channels in Go programming.

There’s no callback crazyness and no monkey patching. Vanilla strives to be as explict and straightforward as possible.

Documentation

Read the Docs

Here’s how it looks:

You spawn coroutines:

h = vanilla.Hub()

def beat(message):
    while True:
        print(message)
        h.sleep(1000)

h.spawn(beat, 'Tick')
h.spawn_later(500, beat, 'Tock')
# Tick / Tock / Tick / Tock

Coroutines communicate via Pipes:

h = vanilla.Hub()
sender, recver = h.pipe()
h.spawn(sender.send, 'Hello World')
recver.recv()
# 'Hello World'

Pipe-fu; inspired by reactive functional patterns, Pipes can be chained:

h = vanilla.Hub()
p = h.pipe().map(lambda x: x*2)
h.spawn(p.send, 4)
p.recv()
# 8

In Vanilla, everything is a Pipe. Here’s how TCP looks:

h = vanilla.Hub()

server = h.tcp.listen(port=9000)
# server is a Recver which dispenses new TCP connections

conn = server.recv()
# conn is a Pipe you can recv and send on

message = conn.recv()
conn.send("Echo: " + message)

Installation

Vanilla works with Python 2.6 - 2.9 and PyPy.

pip install vanilla

Status

Build StatusCoverage Status

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page