Add a function pipe alongside methods

[mjkanji]

I didn't know quite how to word the title, but I'm basically suggesting a way to write streams of transformations in a style similar to this example in the Expression package.

In other words, consider the following:

my_list = list(Stream(it.product(*my_arrays)).truncate(some_limit).group(5))

Many Python formatters (like Ruff) will put the entire expressiion on one line, until it's total length would exceed some max line limit. This severely affects the readability of the code. It's better than nested function calls, but not by very much.

Until they resolve that (e.g., see astral-sh/ruff#8598), I'd like to be able to write the following:

my_list = stream_pipe(
    it.product(*my_arrays),
    truncate(some_list),
    group(5),
    list,
)

The comma after list would prevent the formatter from trying to put everything on the same line, which is crucial for readability.

[ebonnal]

Hey @mjkanji. You are right that is so sad... It feels even sadder to introduce an alternative API just to compensate for that formatting issue 😢

What do you think about this hack:

my_list = list(
    Stream(it.product(*my_arrays))  #
    .truncate(some_limit)  #
    .group(5)
)