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.8+ 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
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.
We also try to keep the API small to keep ``toolz`` 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 <https://github.com/pytoolz/toolz/issues>`__
for contribution ideas.
Community
---------
See our `mailing list <https://groups.google.com/forum/#!forum/pytoolz>`__.
We're friendly.
.. |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
Raw data
{
"_id": null,
"home_page": "https://github.com/pytoolz/toolz/",
"name": "toolz",
"maintainer": "Erik Welch",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "erik.n.welch@gmail.com",
"keywords": "functional utility itertools functools",
"author": "https://raw.github.com/pytoolz/toolz/master/AUTHORS.md",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/8a/0b/d80dfa675bf592f636d1ea0b835eab4ec8df6e9415d8cfd766df54456123/toolz-1.0.0.tar.gz",
"platform": null,
"description": "Toolz\n=====\n\n|Build Status| |Coverage Status| |Version Status|\n\nA set of utility functions for iterators, functions, and dictionaries.\n\nSee the PyToolz documentation at https://toolz.readthedocs.io\n\nLICENSE\n-------\n\nNew BSD. See `License File <https://github.com/pytoolz/toolz/blob/master/LICENSE.txt>`__.\n\nInstall\n-------\n\n``toolz`` is on the Python Package Index (PyPI):\n\n::\n\n pip install toolz\n\nStructure and Heritage\n----------------------\n\n``toolz`` is implemented in three parts:\n\n|literal itertoolz|_, for operations on iterables. Examples: ``groupby``,\n``unique``, ``interpose``,\n\n|literal functoolz|_, for higher-order functions. Examples: ``memoize``,\n``curry``, ``compose``,\n\n|literal dicttoolz|_, for operations on dictionaries. Examples: ``assoc``,\n``update-in``, ``merge``.\n\n.. |literal itertoolz| replace:: ``itertoolz``\n.. _literal itertoolz: https://github.com/pytoolz/toolz/blob/master/toolz/itertoolz.py\n\n.. |literal functoolz| replace:: ``functoolz``\n.. _literal functoolz: https://github.com/pytoolz/toolz/blob/master/toolz/functoolz.py\n\n.. |literal dicttoolz| replace:: ``dicttoolz``\n.. _literal dicttoolz: https://github.com/pytoolz/toolz/blob/master/toolz/dicttoolz.py\n\nThese functions come from the legacy of functional languages for list\nprocessing. They interoperate well to accomplish common complex tasks.\n\nRead our `API\nDocumentation <https://toolz.readthedocs.io/en/latest/api.html>`__ for\nmore details.\n\nExample\n-------\n\nThis builds a standard wordcount function from pieces within ``toolz``:\n\n.. code:: python\n\n >>> def stem(word):\n ... \"\"\" Stem word to primitive form \"\"\"\n ... return word.lower().rstrip(\",.!:;'-\\\"\").lstrip(\"'\\\"\")\n\n >>> from toolz import compose, frequencies\n >>> from toolz.curried import map\n >>> wordcount = compose(frequencies, map(stem), str.split)\n\n >>> sentence = \"This cat jumped over this other cat!\"\n >>> wordcount(sentence)\n {'this': 2, 'cat': 2, 'jumped': 1, 'over': 1, 'other': 1}\n\nDependencies\n------------\n\n``toolz`` supports Python 3.8+ with a common codebase.\nIt is pure Python and requires no dependencies beyond the standard\nlibrary.\n\nIt is, in short, a lightweight dependency.\n\n\nCyToolz\n-------\n\nThe ``toolz`` project has been reimplemented in `Cython <http://cython.org>`__.\nThe ``cytoolz`` project is a drop-in replacement for the Pure Python\nimplementation.\nSee `CyToolz GitHub Page <https://github.com/pytoolz/cytoolz/>`__ for more\ndetails.\n\nSee Also\n--------\n\n- `Underscore.js <https://underscorejs.org/>`__: A similar library for\n JavaScript\n- `Enumerable <https://ruby-doc.org/core-2.0.0/Enumerable.html>`__: A\n similar library for Ruby\n- `Clojure <https://clojure.org/>`__: A functional language whose\n standard library has several counterparts in ``toolz``\n- `itertools <https://docs.python.org/2/library/itertools.html>`__: The\n Python standard library for iterator tools\n- `functools <https://docs.python.org/2/library/functools.html>`__: The\n Python standard library for function tools\n\nContributions Welcome\n---------------------\n\n``toolz`` aims to be a repository for utility functions, particularly\nthose that come from the functional programming and list processing\ntraditions. We welcome contributions that fall within this scope.\n\nWe also try to keep the API small to keep ``toolz`` manageable. The ideal\ncontribution is significantly different from existing functions and has\nprecedent in a few other functional systems.\n\nPlease take a look at our\n`issue page <https://github.com/pytoolz/toolz/issues>`__\nfor contribution ideas.\n\nCommunity\n---------\n\nSee our `mailing list <https://groups.google.com/forum/#!forum/pytoolz>`__.\nWe're friendly.\n\n.. |Build Status| image:: https://github.com/pytoolz/toolz/actions/workflows/test.yml/badge.svg?branch=master\n :target: https://github.com/pytoolz/toolz/actions\n.. |Coverage Status| image:: https://codecov.io/gh/pytoolz/toolz/graph/badge.svg?token=4ZFc9dwKqY\n :target: https://codecov.io/gh/pytoolz/toolz\n.. |Version Status| image:: https://badge.fury.io/py/toolz.svg\n :target: https://badge.fury.io/py/toolz\n\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "List processing tools and functional utilities",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/pytoolz/toolz/"
},
"split_keywords": [
"functional",
"utility",
"itertools",
"functools"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0398eb27cc78ad3af8e302c9d8ff4977f5026676e130d28dd7578132a457170c",
"md5": "bddc0e41344ae22152489f1b7d33f6dc",
"sha256": "292c8f1c4e7516bf9086f8850935c799a874039c8bcf959d47b600e4c44a6236"
},
"downloads": -1,
"filename": "toolz-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bddc0e41344ae22152489f1b7d33f6dc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 56383,
"upload_time": "2024-10-04T16:17:01",
"upload_time_iso_8601": "2024-10-04T16:17:01.533319Z",
"url": "https://files.pythonhosted.org/packages/03/98/eb27cc78ad3af8e302c9d8ff4977f5026676e130d28dd7578132a457170c/toolz-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8a0bd80dfa675bf592f636d1ea0b835eab4ec8df6e9415d8cfd766df54456123",
"md5": "e5573ee464e6498cad2c6b3fe17fa9f5",
"sha256": "2c86e3d9a04798ac556793bced838816296a2f085017664e4995cb40a1047a02"
},
"downloads": -1,
"filename": "toolz-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "e5573ee464e6498cad2c6b3fe17fa9f5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 66790,
"upload_time": "2024-10-04T16:17:04",
"upload_time_iso_8601": "2024-10-04T16:17:04.001748Z",
"url": "https://files.pythonhosted.org/packages/8a/0b/d80dfa675bf592f636d1ea0b835eab4ec8df6e9415d8cfd766df54456123/toolz-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-04 16:17:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pytoolz",
"github_project": "toolz",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "toolz"
}
JSON
