#pipe #pipeop #pipe-operator #pipe-op

tuppipe

A simple pipe operator-like implementation using tuples in Rust

4 releases

0.1.3 Apr 29, 2024
0.1.2 Apr 28, 2024
0.1.1 Apr 28, 2024
0.1.0 Apr 28, 2024

#665 in Rust patterns

Download history 257/week @ 2024-04-22 197/week @ 2024-04-29

454 downloads per month

MIT license

13KB
253 lines

A pipe operator-like experience in Rust.

This crate provides a handy Pipe trait that you can implement for arbitrary types to use them as pipes in a pipeline.

Usage

In the example below the pipe function generates a PartialPipe which can be used to "complete" (invoke) any type that implements Pipe using the shift right (>>) operator.

use tuppipe::pipe;

const fn add_one(to: i32) -> i32 {
    to + 1
}

assert_eq!(2, pipe(0) >> (add_one, add_one));

The first element in the tuple (the tuple being the pipeline) after >>, will receive the 0i32 that you see in the pipe invocation. The second element in the pipeline will receive the output from the first element in the pipeline, and so on.

Default implementations of Pipe

Note that Pipe is currently implemented for both, anything that implements FnOnce from the standard library and for any tuple with up to 16 elements where each element in the tuple itself implements Pipe itself as well.

This means that if you really want a pipeline that's longer than a tuple of 16 elements, you can pretty much infinitely nest tuples in one another.


You can check out the docs for more documentation and examples.

Dependencies