functionality 1.0.2

Rust |> Functional programming = 💖. Useful traits, functions and macros for prettier code.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# Functionality

[![Test](https://github.com/yonatan-reicher/functionality/workflows/Test/badge.svg)](https://github.com/yonatan-reicher/functionality/actions?query=workflow%3ATest)
[![Crates.io Version](https://img.shields.io/crates/v/functionality?logo=rust)](https://crates.io/crates/functionality)

Adds support for chaining functions in a functional way.

## Pipe

The following 9 methods are added to all types:

|       pipe syntax      |  traditional syntax equivalent |
|:----------------------:|:------------------------------:|
| `x.pipe(f)`            | `f(x)`                         |
| `x.pipe_ref(f)`        | `f(&x)`                        |
| `x.pipe_mut(f)`        | `f(&mut x)`                    |
| `x.pipe_as_ref(f)`     | `f(x.as_ref())`                |
| `x.pipe_as_mut(f)`     | `f(x.as_mut())`                |
| `x.pipe_deref(f)`      | `f(&x)`                        |
| `x.pipe_deref_mut(f)`  | `f(&mut x)`                    |
| `x.pipe_borrow(f)`     | `f(x.borrow())`                |
| `x.pipe_borrow_mut(f)` | `f(x.borrow_mut())`            |

These are imported directly from [the pipe-trait crate](https://github.com/KSXGitHub/pipe-trait).

### Example

```rust
use functionality::prelude::*;

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);
```

## Mutate

The method `.mutate(..)` is also added to all types.

### Example

```rust
use functionality::prelude::*;

let sorted = vec![3, 2, 1].mutate(|v| v.sort());
assert_eq!(sorted, vec![1, 2, 3]);
```

## Future Plans

I plan on coming back to this crate and adding more useful things to it. If you have any ideas, please send them to me!
Contact me at yony252525@gmail.com.

I do want to only put important, useful things in this crate. For example, I thought about adding a macro to make piping
easier (something like `pipe! { input |> f1 |> f2 |> ... }`) but it sounded not nearly as essential as `.pipe` and `.mutate`
for my kind of programing.