Skip to main content

Extended pipes for functional programming

Project description

morepipes

Based on the pipe library, adding more utilities and pipes to it

Some pipes are inspired by other programming languages (eg Rust)

Installation

pip install morepipes

Examples

Consume iterable

range(9) | where(lambda x: x % 2) | collect
# List of odd numbers

Cut iterables

range(9) | take(5) | drop(2) | collect
# [2, 3, 4]

Remove duplicates

a = [1, 3, 3, 1, 2, 4, 4, 2, 2, 2, 1, 4, 4, 3, 3, 1]
b = a | squeeze | collect
# [1, 3, 1, 2, 4, 2, 1, 4, 3, 1], remove consecutive duplicates
c = b | unique | collect
# [1, 3, 2, 4]

Manipulate iterations

range(9) | chunks(4)
# [[0, 1, 2, 3], [4, 5, 6, 7]]
range(9) | alternate
# [0, 2, 4, 6, 8]

Side effects

range(9) | ... | inspect | ...
# Prints out each object received on evaluation

Or, more generally

range(9) | ... | foreach(print) | ...

There's also bindings for builtins and itertools

[1, 2, 3] | combinations(2)
[1, 2, 3] | permutations
[1, 2, 3] | cycle
[1, 2, 3] | imap(iseven)

[1, 2, 3] | isum # 6, equivalent to sum([1, 2, 3])
[1, 2, 3] | iall(iseven) # equivalent to all(iseven(x) for x in [1, 2, 3])
[1, 2, 3] | iany(iseven) # equivalent to any(iseven(x) for x in [1, 2, 3])
[1, 2, 3] | ilen # 3, equivalent to len([1, 2, 3])

isum, iall, iany, ilen is useful when working with long pipe chains (no messy parentheses)

New: Partial Pipes

Creating a partial pipe

reverse_sort = P | reverse | sort
# P is a special object placeholder

Using a partial pipe

[1, 3, 4, 2] | reverse_sort
# Just like any other pipe
# Strictly equivalent to:
[1, 3, 4, 2] | reverse | sort
# as if P is replaced by [1, 3, 4, 2]

Have fun!


Todos

  • add full type annotation support
    • piping (dunder ror) can be typed easily
    • there is seemingly no way to type varargs currying (supported by the original pipe library)
    • use classes instead of functions for full type support??
  • alternative implementation on chunk for sequences (supports slicing)

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

morepipes-1.0.4.tar.gz (5.7 kB view hashes)

Uploaded Source

Built Distribution

morepipes-1.0.4-py3-none-any.whl (6.4 kB view hashes)

Uploaded Python 3

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