Skip to main content

List processing tools and functional utilities (Ported to support async/await)

Project description

Build Status Coverage Status Version Status

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. It is pure Python and requires no dependencies beyond the standard library.

It is, in short, a lightweight dependency.

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.

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

aiotoolz-0.0.2.tar.gz (47.7 kB view details)

Uploaded Source

Built Distribution

aiotoolz-0.0.2-py3-none-any.whl (54.5 kB view details)

Uploaded Python 3

File details

Details for the file aiotoolz-0.0.2.tar.gz.

File metadata

  • Download URL: aiotoolz-0.0.2.tar.gz
  • Upload date:
  • Size: 47.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3

File hashes

Hashes for aiotoolz-0.0.2.tar.gz
Algorithm Hash digest
SHA256 bef891985afe10cbc38a4443c5e76447cc8ff89c9fc9639bf8c7d75f5ef4eeb7
MD5 28f8a2f4ef6befde17045f88713afbcb
BLAKE2b-256 6bd26946bc4c79d9f5061af9cd2a31c4796a91be890a5adee6bd5cc9b7fb8718

See more details on using hashes here.

File details

Details for the file aiotoolz-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: aiotoolz-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 54.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3

File hashes

Hashes for aiotoolz-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9c96a6fac2127594e70870dac74e5b84c4924f37133083f5ab813968e4a0a0a2
MD5 81ca906b7df6ddc89cf92b3bb1965bfe
BLAKE2b-256 5f7e293fdd74ec9e47727b07167930ed1e63c4d0c3f1ad1bc815bf019b82be6a

See more details on using hashes here.

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