A set of utility functions for iterators, functions, and dictionaries.
See the PyToolz documentation at http://toolz.readthedocs.org
New BSD. See License File.
toolz
is on the Python Package Index (PyPi):
pip install toolz
or
easy_install toolz
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.
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
>>> wordcount = compose(frequencies, partial(map, stem), str.split)
>>> sentence = "This cat jumped over this other cat!"
>>> wordcount(sentence)
{'this': 2, 'cat': 2, 'jumped': 1, 'over': 1, 'other': 1}
toolz
supports Python 2.6+ and Python 3.2+ with a common codebase.
It is pure Python and requires no dependencies beyond the standard
library.
It is, in short, a light weight dependency.
- 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
toolz
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 and
encourage users to scrape their util.py
files for functions that are
broadly useful.
Please take a look at our issue page for contribution ideas.