2018-06-27 02:56:33 +00:00
|
|
|
|
aioitertools
|
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
|
|
itertools for AsyncIO and mixed iterables.
|
|
|
|
|
|
|
|
|
|
|
|
[](https://travis-ci.org/jreese/aioitertools)
|
|
|
|
|
|
[](https://pypi.org/project/aioitertools)
|
|
|
|
|
|
[](https://github.com/jreese/aioitertools/blob/master/LICENSE)
|
|
|
|
|
|
[](https://github.com/ambv/black)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Install
|
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
|
|
aioitertools requires Python 3.6 or newer.
|
|
|
|
|
|
You can install it from PyPI:
|
|
|
|
|
|
|
|
|
|
|
|
$ pip3 install aioitertools
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Usage
|
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
|
|
aioitertools shadows the standard library whenever possible to provide
|
|
|
|
|
|
asynchronous version of the modules and functions you already know. It's
|
|
|
|
|
|
fully compatible with standard iterators and async iterators alike, giving
|
|
|
|
|
|
you one unified, familiar interface for interacting with iterable objects:
|
|
|
|
|
|
|
|
|
|
|
|
from aioitertools import iter, next, map, zip
|
|
|
|
|
|
|
|
|
|
|
|
something = iter(...)
|
|
|
|
|
|
first_item = await next(something)
|
|
|
|
|
|
|
|
|
|
|
|
async for item in iter(something):
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
async def fetch(url):
|
|
|
|
|
|
response = await aiohttp.request(...)
|
|
|
|
|
|
return response.json
|
|
|
|
|
|
|
|
|
|
|
|
async for value in map(fetch, MANY_URLS):
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
async for a, b in zip(something, something_else):
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-06-28 06:25:54 +00:00
|
|
|
|
aioitertools emulates the entire `itertools` module, offering the same
|
|
|
|
|
|
function signatures, but as async generators. All functions support
|
|
|
|
|
|
standard iterables and async iterables alike, and can take functions or
|
|
|
|
|
|
coroutines:
|
2018-06-27 02:56:33 +00:00
|
|
|
|
|
2018-06-28 06:25:54 +00:00
|
|
|
|
from aioitertools import chain, islice
|
|
|
|
|
|
|
|
|
|
|
|
async def generator1(...):
|
|
|
|
|
|
yield ...
|
|
|
|
|
|
|
|
|
|
|
|
async def generator2(...):
|
|
|
|
|
|
yield ...
|
|
|
|
|
|
|
|
|
|
|
|
async for value in chain(generator1(), generator2()):
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
|
|
async for value in islice(generator1(), 2, None, 2):
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
See [builtins.py][builtins] and [itertools.py][itertools] for full documentation
|
|
|
|
|
|
of functions and abilities.
|
2018-06-27 02:56:33 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
License
|
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
|
|
aioitertools is copyright [John Reese](https://jreese.sh), and licensed under
|
|
|
|
|
|
the MIT license. I am providing code in this repository to you under an open
|
|
|
|
|
|
source license. This is my personal repository; the license you receive to
|
|
|
|
|
|
my code is from me and not from my employer. See the `LICENSE` file for details.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[builtins]: https://github.com/jreese/aioitertools/blob/master/aioitertools/builtins.py
|
2018-06-28 06:25:54 +00:00
|
|
|
|
[itertools]: https://github.com/jreese/aioitertools/blob/master/aioitertools/itertools.py
|
