Effortless Python RPC with ZeroMQ
Project description
wirepickle
Effortless python remote procedure calling with pickle over ZeroMQ. Allows you to expose a single class instance as an API server over every transport layer that ZeroMQ provides.
Quick Setup
Install wirepickle using your favorite package manager:
$ pip install wirepickle
Server
Next, on your server, annotate the methods you want to expose with the @expose
decorator:
from wirepickle.server import expose, Server
class Foo:
@expose('bar')
def bar(self):
print('bar')
return 0
@expose('baz')
def baz(self, arg1, kwarg1='baz'):
print(kwarg1)
return self.bar() + arg1
Note that you can return anything that can be pickled as a return value, and that stdout will be mirrored to the client.
Then, pass an instance of the class to the Server
constructor to create the server.
To start listening, call the Server#listen()
method on the constructed server with
a bind URI:
if __name__ == '__main__':
instance = Foo()
Server(instance).listen('tcp://*:12345')
Client
Simply pass a URI to connect to and start using the methods.
from wirepickle.client import Client
foo = Client('tcp://127.0.0.1:12345')
foo.bar()
If desired, you can pass a timeout
kwarg to the Client
constructor:
foo = Client('tcp://127.0.0.1:12345', timeout=1_000) # milliseconds
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.
Source Distribution
Built Distribution
Hashes for wirepickle-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b2625e5330f22906b0c318bebad66b7c12661d2ac4e6615439d108dc5941e87d |
|
MD5 | 265bc1168460718fb99037db62b9bdc0 |
|
BLAKE2b-256 | 847beb1c815201692a54eb06e7df6401c3fbe3b8c340226bac985005784dab7b |