aiotoolz
An async port of the wonderful pytoolz/toolz library.
See the PyToolz documentation at https://toolz.readthedocs.io and the github page at https://github.com/pytoolz/toolz.
LICENSE
New BSD. See License File.
Install
aiotoolz
is not yet on the Python Package Index (PyPI), but soon you can install it like so:
pip install aiotoolz
Currently, you can install it like so:
pip install git+https://github.com/eabrouwer3/aiotoolz.git
Structure and Heritage
toolz
is implemented in three parts:
itertoolz
, for operations on iterables. Examples: groupby
,
unique
, interpose
,
functoolz
, for higher-order functions. Examples: memoize
,
curry
, compose
,
dicttoolz
, for operations on dictionaries. Examples: assoc
,
update-in
, merge
.
These functions come from the legacy of functional languages for list processing. They interoperate well to accomplish common complex tasks.
Read our API Documentation for more details.
Example
This builds a standard wordcount function from pieces within toolz
:
>>> def stem(word):
... """ Stem word to primitive form """
... return word.lower().rstrip(",.!:;'-\"").lstrip("'\"")
>>> from toolz import compose, frequencies, partial
>>> from toolz.curried import map
>>> wordcount = compose(frequencies, map(stem), str.split)
>>> sentence = "This cat jumped over this other cat!"
>>> wordcount(sentence)
{'this': 2, 'cat': 2, 'jumped': 1, 'over': 1, 'other': 1}
Dependencies
aiotoolz
supports Python 3.5+ with a common codebase. There is one
dependency, Paco, for async versions of
python's map
, partial
, reduce
etc. functions.
See Also
- Underscore.js: A similar library for JavaScript
- Enumerable: A similar library for Ruby
-
Clojure: A functional language whose
standard library has several counterparts in
toolz
- itertools: The Python standard library for iterator tools
- functools: The Python standard library for function tools
Contributions Welcome
aiotoolz
aims to be a repository for utility functions, particularly
those that come from the functional programming and list processing
traditions. We welcome contributions that fall within this scope.
We also try to keep the API small to keep aiotoolz
manageable. The ideal
contribution is significantly different from existing functions and has
precedent in a few other functional systems.
Please take a look at our issue page for contribution ideas.
Community
See our toolz
mailing list.
We're friendly.