#pipe #trait #fp #pipeline

no-std pipe-trait

Make it possible to chain regular functions

13 releases

0.2.1 Nov 7, 2020
0.2.0 May 26, 2020
0.1.11 May 23, 2020

#37 in No standard library

Download history 103/week @ 2020-08-10 39/week @ 2020-08-17 100/week @ 2020-08-24 139/week @ 2020-08-31 718/week @ 2020-09-07 198/week @ 2020-09-14 120/week @ 2020-09-21 283/week @ 2020-09-28 148/week @ 2020-10-05 111/week @ 2020-10-12 148/week @ 2020-10-19 67/week @ 2020-10-26 101/week @ 2020-11-02 394/week @ 2020-11-09 80/week @ 2020-11-16 98/week @ 2020-11-23

746 downloads per month
Used in less than 6 crates

MIT license

10KB
123 lines

Pipe Trait

Test Travis Build Status Crates.io Version

Make it possible to chain regular functions.

APIs

By adding use pipe_trait::*, 3 methods are added to all types:

identifier pipe syntax traditional syntax
Pipe::pipe x.pipe(f) f(x)
Pipe::pipe_ref x.pipe_ref(f) f(&x)
Pipe::pipe_mut x.pipe_mut(f) f(&mut x)

Read the docs for more information.

Usage Examples

Same type

use pipe_trait::*;
let inc = |x| x + 1;
let double = |x| x + x;
let square = |x| x * x;
let a = (123i32).pipe(inc).pipe(double).pipe(square);
let b = square(double(inc(123i32)));
assert_eq!(a, b);

Type transformation

use pipe_trait::*;
let x = 'x';
let a = x
    .pipe(|x| (x, x, x)) // (char, char, char)
    .pipe(|x| [x, x]) // [(char, char, char); 2]
    .pipe(|x| format!("{:?}", x)); // String
let b = "[('x', 'x', 'x'), ('x', 'x', 'x')]";
assert_eq!(a, b);

Pipe amongst method chain

use pipe_trait::*;
fn log<X: Debug>(x: X) -> X {
    println!("value: {:?}", x);
    x
}
my_future
    .pipe(log)
    .await
    .pipe(log)
    .inc()
    .pipe(log)
    .double()
    .pipe(log)
    .square()
    .pipe(log)
    .get()
    .pipe(log);

Explicit type annotation

use pipe_trait::*;
let x = "abc".to_string();
let a = x
    .pipe_ref::<&str, _>(AsRef::as_ref)
    .chars()
    .pipe::<Box<_>, _>(Box::new)
    .collect::<Vec<_>>();
let b = vec!['a', 'b', 'c'];
assert_eq!(a, b);

License

MIT © Hoàng Văn Khải

No runtime deps