Skip to main content

List processing tools and functional utilities

Project description

Build Status Coverage Status Version Status Downloads

A set of utility functions for iterators, functions, and dictionaries.

See the PyToolz documentation at http://toolz.readthedocs.org

LICENSE

New BSD. See License File.

Install

toolz is on the Python Package Index (PyPI):

pip install toolz

or

easy_install toolz

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
>>> 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}

Dependencies

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.

CyToolz

The toolz project has been reimplemented in Cython. The cytoolz project is a drop-in replacement for the Pure Python implementation. See CyToolz Github Page for more details.

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

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.

Community

See our mailing list. We’re friendly.

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

toolz-0.7.0.tar.gz (18.7 kB view details)

Uploaded Source

File details

Details for the file toolz-0.7.0.tar.gz.

File metadata

  • Download URL: toolz-0.7.0.tar.gz
  • Upload date:
  • Size: 18.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for toolz-0.7.0.tar.gz
Algorithm Hash digest
SHA256 8f88590f960c16db2146b6ecae31f9d048865612b69e197907e886c963fad6f3
MD5 85cb593e0ee192556b8ac901bc30a5ca
BLAKE2b-256 7d0af95eed1d076f441981ab01cd1c57fd44d03d5811f476c0c9d5a07b04739c

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