Skip to main content

ZeroMQ integration with asyncio.

Project description

asyncio (PEP 3156) support for ZeroMQ.

https://travis-ci.org/aio-libs/aiozmq.svg?branch=master

Documentation

See http://aiozmq.readthedocs.org

Simple high-level client-server RPC example:

import asyncio
import aiozmq.rpc


class ServerHandler(aiozmq.rpc.AttrHandler):

    @aiozmq.rpc.method
    def remote_func(self, a:int, b:int) -> int:
        return a + b


@asyncio.coroutine
def go():
    server = yield from aiozmq.rpc.serve_rpc(
        ServerHandler(), bind='tcp://127.0.0.1:5555')
    client = yield from aiozmq.rpc.connect_rpc(
        connect='tcp://127.0.0.1:5555')

    ret = yield from client.call.remote_func(1, 2)
    assert 3 == ret

    server.close()
    client.close()

asyncio.get_event_loop().run_until_complete(go())

Low-level request-reply example:

import asyncio
import aiozmq
import zmq

@asyncio.coroutine
def go():
    router = yield from aiozmq.create_zmq_stream(
        zmq.ROUTER,
        bind='tcp://127.0.0.1:*')

    addr = list(router.transport.bindings())[0]
    dealer = yield from aiozmq.create_zmq_stream(
        zmq.DEALER,
        connect=addr)

    for i in range(10):
        msg = (b'data', b'ask', str(i).encode('utf-8'))
        dealer.write(msg)
        data = yield from router.read()
        router.write(data)
        answer = yield from dealer.read()
        print(answer)
    dealer.close()
    router.close()

asyncio.get_event_loop().run_until_complete(go())

Requirements

License

aiozmq is offered under the BSD license.

CHANGES

0.7.1 (2015-09-20)

  • Fix monitoring events implementation

  • Make the library compatible with Python 3.5

0.7.0 (2015-07-31)

  • Implement monitoring ZMQ events #50

  • Do deeper lookup for inhereted classes #54

  • Relax endpont check #56

  • Implement monitoring events for stream api #52

0.6.1 (2015-05-19)

  • Dynamically get list of pyzmq socket types

0.6.0 (2015-02-14)

  • Process asyncio specific exceptions as builtins.

  • Add repr(exception) to rpc server call logs if any

  • Add transport.get_write_buffer_limits() method

  • Add __repr__ to transport

  • Add zmq_type to tr.get_extra_info()

  • Add zmq streams

0.5.2 (2014-10-09)

  • Poll events after sending zmq message for eventless transport

0.5.1 (2014-09-27)

  • Fix loopless transport implementation.

0.5.0 (2014-08-23)

  • Support zmq devices in aiozmq.rpc.serve_rpc()

  • Add loopless 0MQ transport

0.4.1 (2014-07-03)

  • Add exclude_log_exceptions parameter to rpc servers.

0.4.0 (2014-05-28)

  • Implement pause_reading/resume_reading methods in ZmqTransport.

0.3.0 (2014-05-17)

  • Add limited support for Windows.

  • Fix unstable test execution, change ZmqEventLoop to use global shared zmq.Context by default.

  • Process cancellation on rpc servers and clients.

0.2.0 (2014-04-18)

  • msg in msg_received now is a list, not tuple

  • Allow to send empty msg by trsansport.write()

  • Add benchmarks

  • Derive ServiceClosedError from aiozmq.rpc.Error, not Exception

  • Implement logging from remote calls at server side (log_exceptions parameter).

  • Optimize byte counting in ZmqTransport.

0.1.3 (2014-04-10)

  • Function default values are not passed to an annotaion. Add check for libzmq version (should be >= 3.0)

0.1.2 (2014-04-01)

  • Function default values are not passed to an annotaion.

0.1.1 (2014-03-31)

  • Rename plural module names to single ones.

0.1.0 (2014-03-30)

  • Implement ZmqEventLoop with create_zmq_connection method which operates on zmq transport and protocol.

  • Implement ZmqEventLoopPolicy.

  • Introduce ZmqTransport and ZmqProtocol.

  • Implement zmq.rpc with RPC, PUSHPULL and PUBSUB protocols.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiozmq-0.7.1.tar.gz (28.1 kB view details)

Uploaded Source

Built Distribution

aiozmq-0.7.1-py3-none-any.whl (37.2 kB view details)

Uploaded Python 3

File details

Details for the file aiozmq-0.7.1.tar.gz.

File metadata

  • Download URL: aiozmq-0.7.1.tar.gz
  • Upload date:
  • Size: 28.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for aiozmq-0.7.1.tar.gz
Algorithm Hash digest
SHA256 b41d589a715acc0d42b525ef7084bbcdc03c986ef5a90e212ee7f086125cf6c0
MD5 8b09d01d5544bbbc12d8a9319a8d7587
BLAKE2b-256 e28b319fc94958c387c8ed8ad03b7f235df58a0aef484d74959d10c4e72a750c

See more details on using hashes here.

Provenance

File details

Details for the file aiozmq-0.7.1-py3-none-any.whl.

File metadata

File hashes

Hashes for aiozmq-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8bbbac6aedf25c89f96cfbfa0b5b2d08e28eabd79a81f8ca854ed5b757343cde
MD5 5f03b52c72d72abb664be7d832caaeca
BLAKE2b-256 c85b4ce8584fcd676664ba43170d9871ae177837fa72f59c08766bc0c589e177

See more details on using hashes here.

Provenance

Supported by

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