Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Asynchronous `zip` like aggregator for `async for`

Project Description

AsyncZip is a simple zip like function working with asynchronous iterables. It look, in many aspects, like asyncio.wait.


Given n asynchronous iterables, AsyncZip(*aiterables) gives a new asynchronous iterable iterating over all of them. Like asyncio.wait, it’s possible to wait for any iterable to yield something using the option FIRST_COMPLETED, or to wait for all of them using the option ALL_COMPLETED.

class AsyncZip

def __init__(self, *asynchronous_iterables, loop=None, yield_when=FIRST_COMPLETED):
  • asynchronous_iterables: A collection of asynchronous iterables
  • loop: Optional named parameter, to give an specific event loop
  • yield_when: Like return_when from asyncio.wait, FIRST_COMPLETED or ALL_COMPLETED.


The two values yield_when can take, FIRST_COMPLETED and ALL_COMPLETED tell, like for asyncio.wait, when AsyncZip should yield. Defaults to FIRST_COMPLETED.


Like select, where AsyncZip yields each time any iterable yields, as soon as possible.


It’s the classical zip mode, where AsyncZip waits for a value for each iterator before yielding them all in a single loop.

Example usage

import asyncio
from asynczip import AsyncZip

class DummyAsyncIterable:
    def __init__(self, items):
        self.items = items

    async def __aiter__(self):
        return self

    async def __anext__(self):
            return self.items.pop(0)
        except IndexError:
            raise StopAsyncIteration

async def test():
    async for items in AsyncZip(DummyAsyncIterable(list("foo")),



[<Task finished coro=<DummyAsyncIterable.__anext__() done, defined at> result='f'>,<Task finished coro=<DummyAsyncIterable.__anext__() done, defined at> result='b'>]
[<Task finished coro=<DummyAsyncIterable.__anext__() done, defined at> result='o'>, <Task finished coro=<DummyAsyncIterable.__anext__() done, defined at> result='a'>]
[<Task finished coro=<DummyAsyncIterable.__anext__() done, defined at> result='o'>, <Task finished coro=<DummyAsyncIterable.__anext__() done, defined at> result='r'>]
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
asynczip-1.0.7.tar.gz (3.4 kB) Copy SHA256 Checksum SHA256 Source Apr 20, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting