skip to navigation
skip to content

pseud 0.0.5

Bidirectionnal RPC Api on top of pyzmq

Latest Version: 1.0.0a1

Pythonic bidirectional-rpc API built on top of ØMQ with pluggable encryption, authentication and heartbeating support.


  1. ØMQ transport layer.
  2. All native python types supported (msgpack).
  3. First citizen exceptions.
  4. Bi-bidirectional (server can initiate calls to connected clients).
  5. Encryption based on CURVE.
  6. Pluggable Authentication.
  7. Pluggable Heartbeating.
  8. Pluggable Remote Call Routing.
  9. Works with tornado ioloop or gevent.
  10. Built-in proxy support. A server can delegate the work to another one.
  11. SyncClient (using zmq.REQ) to use within non event based processes. (Heartbeating, Authentication and job execution are not supported with the SyncClient.)


Dependencies are declared in and all automatically installed, but, pyzmq might build libzmq from bundled folder OR from your system wide libzmq. In later case you should make sure libzmq has been compiled with libsodium to take advantage of curve security features.

We recommend to install pyzmq with bundled libzmq explicitely if libzmq is already installed on your system.

$ pip install pyzmq --install-option='--zmq=bundled'


$ pip install -e .[Tornado]


$ pip install -e .[Gevent]


If both backends are installed, tornado is used by default. To force gevent over tornado, set the environment variable $NO_TORNADO to something.

$ NO_TORNADO=1 python


The tornado Server

from pseud import Server

server = Server('service')

def hello(name):
    return 'Hello {0}'.format(name)

server.start()  # this will block forever

The tornado Client

# Assume the tornado IOLoop is running
from pseud import Client

client = Client('service', identity='client1', io_loop=loop)

# Assume we are inside a coroutine
response = yield client.hello('Charly')
assert response == 'Hello Charly'

def sheep():
    return 'beeeh'

The gevent Client

from pseud import Client

client = Client('service')

assert client.hello('Charly').get() == 'Hello Charly'

The SyncClient

# to use within a non-asynchronous process or in a command interpreter
from pseud import SyncClient

client = SyncClient()

assert client.hello('Charly') == 'Hello Charly'

The Server send a command to the client

# assume we are inside a coroutine
sheep = yield server.send_to('client1')
assert sheep == 'beeeh'


Pseud on Readthedocs

File Type Py Version Uploaded on Size
pseud-0.0.5-py2-none-any.whl (md5, pgp) Python Wheel 2.7 2014-08-27 17KB
pseud-0.0.5.tar.gz (md5, pgp) Source 2014-08-27 13KB