rok-utils 0.2.0

Laravel/AdonisJS-inspired utility helpers for the Rok ecosystem
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
60
61

# Array/Collection Utilities (`arr`)

Laravel Collection-inspired array manipulation with generic operations.

## Features

- **Transformation**: `map`, `filter`, `reduce`, `chunk`, `flatten`, `compact`
- **Query**: `first`, `last`, `find`, `get`, `some`, `every`, `contains`
- **Set operations**: `unique`, `diff`, `intersect`, `without`, `merge`
- **Shuffling**: `shuffle` (feature: `random`)

## Quick Start

```rust
use rok_utils::arr::{map, filter, find};

let numbers = [1, 2, 3, 4, 5];

let doubled = map(&numbers, |x| x * 2);
// [2, 4, 6, 8, 10]

let evens = filter(&numbers, |x| x % 2 == 0);
// [2, 4]

let found = find(&numbers, |x| *x == 3);
// Some(3)
```

## Set Operations

```rust
use rok_utils::arr::{unique, diff, intersect};

let a = [1, 2, 3, 2, 1];

unique(&a);     // [1, 2, 3]
diff(&a, &[2]); // [1, 3]
intersect(&a, &[2, 3]); // [2, 3]
```

## Chunking and Flipping

```rust
use rok_utils::arr::{chunk, reverse};

let numbers = [1, 2, 3, 4, 5, 6];

chunk(&numbers, 2);  // [[1, 2], [3, 4], [5, 6]]
reverse(&numbers);   // [6, 5, 4, 3, 2, 1]
```

## Feature Flags

| Feature | Description |
|---------|-------------|
| `full` | Enable all features |
| `random` | Enable `shuffle` function |

## See Also

- [Main examples](../docs/examples.md)