Skip to main content

pelper - python helper functions

Project description

build status coverage read the docs

pelper – python helper functions to ease measuring, ignoring, caching, piping, functional helpers, and more for python 2.7, 3.4, and 3.5.

pelper contains useful helper functions, decorators, context managers - all the things that make your python life a tiny bit easier. pelper has no dependencies, has a coverage of 100%, and is well documented.

Examples

Pipe data through unix-like/elixir-like pipes:

>>> from pelper import pipe
>>> pipe("some datat, some data",
>>>      set,
>>>      (sorted, {"reverse": True}))
['t', 's', 'o', 'm', 'e', 'd', 'a', ',', ' ']

Take n elements from iterables (useful if you can’t use the square bracket notation, e.g., if you’re using pipe)

>>> from pelper import take
>>> take("hello world", 5)
'hello'

Take the n-th elements from iterables (useful if you can’t use the square bracket notation, e.g., if you’re using pipe)

>>> from pelper import nth
>>> nth(range(5), 2)
2

Flatten arbitrarily nested lists:

>>> from pelper import flatten
>>> flatten([1, [2, 2, [3, 3]]])
[1, 2, 2, 3, 3]

Measure the duration of a function:

>>> from pelper import print_duration
>>> @print_duration()
>>> def f(n):
>>>     pass

Measure the duration of a context:

>>> from pelper import print_duration
>>> with print_duration():
>>>     range(4)

Ignore exceptions:

>>> from pelper import ignored
>>> with ignored(OSError):
>>>     raise OSError()  # this is ignored

Cache already computed results of functions:

>>> from pelper import cache
>>> @cache
>>> def fib(n):
>>>     return 1 if n < 2 else fib(n-1) + fib(n-2)
>>> f(500)  # this would run for quite a wile without the cache decorator

Installation

pelper is only one file and has no dependencies. You can simply drop pelper.py into your project and use it.

Or install it from pypi by running:

pip install pelper

Or install it from source by running:

pip install .

Tests

pelper uses doctest extensively and has coverage. You can run the tests with:

python pelper/pelper.py

or:

python -m doctest pelper/pelper.py

or:

python3 pelper/pelper.py

or:

python3 -m doctest pelper/pelper.py

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

pelper-0.0.3.tar.gz (5.0 kB view hashes)

Uploaded source

Built Distribution

pelper-0.0.3-py2.py3-none-any.whl (7.0 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page