https://github.com/cablehead/vanilla
Straightforward concurrency for Python
https://github.com/cablehead/vanilla
concurrency networking python
Last synced: 10 months ago
JSON representation
Straightforward concurrency for Python
- Host: GitHub
- URL: https://github.com/cablehead/vanilla
- Owner: cablehead
- License: mit
- Created: 2014-05-23T22:32:35.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2016-06-13T20:05:34.000Z (about 10 years ago)
- Last Synced: 2024-12-16T18:29:13.587Z (over 1 year ago)
- Topics: concurrency, networking, python
- Language: Python
- Homepage: http://vanillapy.readthedocs.org/
- Size: 455 KB
- Stars: 111
- Watchers: 10
- Forks: 11
- Open Issues: 17
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- License: LICENSE
Awesome Lists containing this project
README
|Vanilla| Welcome to Vanilla!
=============================
*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:
.. code:: python
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:
.. code:: python
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:
.. code:: python
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:
.. code:: python
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 Status|\ |Coverage Status|
.. _Read the Docs: http://vanillapy.readthedocs.org/
.. |Vanilla| image:: https://raw.githubusercontent.com/cablehead/vanilla/master/docs/_static/logo2.png
.. |Build Status| image:: https://img.shields.io/travis/cablehead/vanilla.svg?style=flat-square
:target: https://travis-ci.org/cablehead/vanilla
.. |Coverage Status| image:: https://img.shields.io/codecov/c/github/cablehead/vanilla.svg?style=flat-square
:target: https://codecov.io/github/cablehead/vanilla?branch=master