# toolz

> List processing tools and functional utilities

- **URL**: https://www.freshcrate.ai/projects/toolz
- **Author**: PyToolz Contributors
- **Category**: RAG & Memory
- **Latest version**: `1.1.0` (2026-04-21)
- **License**: Unknown
- **Source**: https://github.com/pytoolz/toolz/releases
- **Homepage**: https://pypi.org/project/toolz/
- **Language**: Python
- **GitHub**: 5,139 stars, 270 forks
- **Registry**: pypi (`toolz`)
- **Tags**: `functional`, `functools`, `itertools`, `pypi`, `utility`

## Description

Toolz
=====

|Build Status| |Coverage Status| |Version Status|

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

See the PyToolz documentation at https://toolz.readthedocs.io

LICENSE
-------

New BSD. See `License File <https://github.com/pytoolz/toolz/blob/master/LICENSE.txt>`__.

Install
-------

``toolz`` is on the Python Package Index (PyPI):

::

    pip install toolz

Structure and Heritage
----------------------

``toolz`` is implemented in three parts:

|literal itertoolz|_, for operations on iterables. Examples: ``groupby``,
``unique``, ``interpose``,

|literal functoolz|_, for higher-order functions. Examples: ``memoize``,
``curry``, ``compose``,

|literal dicttoolz|_, for operations on dictionaries. Examples: ``assoc``,
``update-in``, ``merge``.

.. |literal itertoolz| replace:: ``itertoolz``
.. _literal itertoolz: https://github.com/pytoolz/toolz/blob/master/toolz/itertoolz.py

.. |literal functoolz| replace:: ``functoolz``
.. _literal functoolz: https://github.com/pytoolz/toolz/blob/master/toolz/functoolz.py

.. |literal dicttoolz| replace:: ``dicttoolz``
.. _literal dicttoolz: https://github.com/pytoolz/toolz/blob/master/toolz/dicttoolz.py

These functions come from the legacy of functional languages for list
processing. They interoperate well to accomplish common complex tasks.

Read our `API
Documentation <https://toolz.readthedocs.io/en/latest/api.html>`__ for
more details.

Example
-------

This builds a standard wordcount function from pieces within ``toolz``:

.. code:: python

    >>> def stem(word):
    ...     """ Stem word to primitive form """
    ...     return word.lower().rstrip(",.!:;'-\"").lstrip("'\"")

    >>> from toolz import compose, frequencies
    >>> 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
------------

``toolz`` supports Python 3.9+ with a common codebase.
It is pure Python and requires no dependencies beyond the standard
library.

It is, in short, a lightweight dependency.


CyToolz
-------

The ``toolz`` project has been reimplemented in `Cython <http://cython.org>`__.
The ``cytoolz`` project is a drop-in replacement for the Pure Python
implementation.
See `CyToolz GitHub Page <https://github.com/pytoolz/cytoolz/>`__ for more
details.

See Also
--------

-  `Underscore.js <https://underscorejs.org/>`__: A similar library for
   JavaScript
-  `Enumerable <https://ruby-doc.org/core-2.0.0/Enumerable.html>`__: A
   similar library for Ruby
-  `Clojure <https://clojure.org/>`__: A functional language whose
   standard library has several counterparts in ``toolz``
-  `itertools <https://docs.python.org/2/library/itertools.html>`__: The
   Python standard library for iterator tools
-  `functools <https://docs.python.org/2/library/functools.html>`__: The
   Python standard library for function tools

Project Status
--------------

**This project is alive but inactive.**

The original maintainers have mostly moved on to other endeavors.  We're still
around for critical bug fixes, Python version bumps, and security issues and
will commit to keeping the project alive (it's highly depended upon).
However, beyond that we don't plan to spend much time reviewing contributions.
We view Toolz as mostly complete.

We encourage enthusiasts to innovate in new and wonderful places 🚀

.. |Build Status| image:: https://github.com/pytoolz/toolz/actions/workflows/test.yml/badge.svg?branch=master
   :target: https://github.com/pytoolz/toolz/actions
.. |Coverage Status| image:: https://codecov.io/gh/pytoolz/toolz/graph/badge.svg?token=4ZFc9dwKqY
   :target: https://codecov.io/gh/pytoolz/toolz
.. |Version Status| image:: https://badge.fury.io/py/toolz.svg
   :target: https://badge.fury.io/py/toolz

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `1.1.0` | 2026-04-21 | Low | Imported from PyPI (1.1.0) |
| `1.0.1a0` | 2025-10-17 | Low | _**This is a pre-release**_  - Support Python 3.14 - Drop support for Python 3.8 - Package and CI modernization  Full release notes will be included for 1.0.1. |
| `1.0.0` | 2024-10-04 | Low | ## What's Changed * Test fixes for changes in recent upstream Python (#581) by @AdamWill in https://github.com/pytoolz/toolz/pull/582 * Drop Python 3.7 by @jrbourbeau in https://github.com/pytoolz/toolz/pull/586 * Test against Python 3.13 by @jrbourbeau in https://github.com/pytoolz/toolz/pull/587 * Update docs by @jrbourbeau in https://github.com/pytoolz/toolz/pull/590  ## New Contributors * @AdamWill made their first contribution in https://github.com/pytoolz/toolz/pull/582 * @jrbourbe |
| `0.12.1` | 2024-01-24 | Low | - Add support for Python 3.12 and PyPy 3.10 - Drop support for Python 3.5 and 3.6 - Fix typos (#565, #568) - Use codecov for coverage instead of coveralls |
| `0.12.1a0` | 2024-01-24 | Low | _**This is a pre-release**_  - Support Python 3.12 - Drop support for Python 3.5 and 3.6 |
| `0.12.0` | 2022-07-10 | Low | - Add `apply` (#411) - Support newer Python versions--up to Python 3.11-alpha (#525, #527, #533) - Improve warning when using `toolz.compatibility` (#485) - Improve documentation (#507, #524, #526, #530) - Improve performance of `merge_with` (#532) - Improve import times (#534) - Auto-upload new releases to PyPI (#536, #537) |
| `0.11.2` | 2021-11-06 | Low | - Support Python 3.10 |
| `0.11.1` | 2020-09-24 | Low | - Importing `toolz` no longer warns (by importing `.compatibility`) |
| `0.11.0` | 2020-09-23 | Low | - Drop Python 2.7 support! - Give deprecation warning on using `toolz.compatibility` - Some doc fixes - First time using auto-deployment.  Fingers crossed!  Next release will probably be 1.0.0 :) |

## Citation

- HTML: https://www.freshcrate.ai/projects/toolz
- Markdown: https://www.freshcrate.ai/projects/toolz.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/toolz/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._
