Bi-directional RPC API on top of pyzmq
Project description
Pythonic bidirectional-rpc API built on top of ØMQ with pluggable encryption, authentication and heartbeating support.
Features
ØMQ transport layer.
All native python types supported (msgpack).
First citizen exceptions.
Bi-bidirectional (server can initiate calls to connected clients).
Encryption based on CURVE.
Pluggable Authentication.
Pluggable Heartbeating.
Pluggable Remote Call Routing.
Works with tornado ioloop or gevent.
Built-in proxy support. A server can delegate the work to another one.
SyncClient (using zmq.REQ) to use within non event based processes. (Heartbeating, Authentication and job execution are not supported with the SyncClient.)
Installation
Tornado
pip install -e .[Tornado]
Gevent
pip install -e .[Gevent]
Execution
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 script.py
Preview
# The server
# Assume tornado IOLoop is running
from pseud import Server
server = Server('service')
server.bind('tcp://127.0.0.1:5555')
@server.register_rpc
def hello(name):
return 'Hello {0}'.format(name)
server.start()
# The tornado client
# Assume tornado IOLoop is running
from pseud import Client
client = Client('service')
client.connect('tcp://127.0.0.1:5555')
# Assume we are inside a coroutine
response = yield client.hello('Charly')
assert response == 'Hello Charly'
# The gevent client
from pseud import Client
client = Client('service')
client.connect('tcp://127.0.0.1:5555')
assert client.hello('Charly').get() == 'Hello Charly'
Documentation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.