toolchest 0.0.1

Essential utility collection for Rust - the missing complement to itertools
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

# toolchest - Essential Utility Collection for Rust


[![Crates.io](https://img.shields.io/crates/v/toolchest.svg)](https://crates.io/crates/toolchest)
[![Documentation](https://docs.rs/toolchest/badge.svg)](https://docs.rs/toolchest)
[![CI](https://github.com/danjloveless/toolchest/workflows/CI/badge.svg)](https://github.com/danjloveless/toolchest/actions)
[![Coverage](https://codecov.io/gh/danjloveless/toolchest/branch/main/graph/badge.svg)](https://codecov.io/gh/danjloveless/toolchest)

Your essential collection of Rust utilities - everything `itertools` doesn't do.

## Why toolchest?


Every craftsperson needs a well-organized toolchest. In Rust, you need two utility crates:
- `itertools` - for collection/iterator operations
- `toolchest` - for everything else

Together, they provide a complete utility toolkit without scattered dependencies.

## Quick Start


```rust
use itertools::Itertools;     // For collections
use toolchest::prelude::*;    // For everything else

// String manipulation
let snake = strings::to_snake_case("HelloWorld");  // "hello_world"

// Math utilities
let rounded = math::round(3.14159, 2);  // 3.14
let clamped = math::clamp(15, 0, 10);   // 10

// Deep operations
// let merged = deep::merge(&default_config, &user_config);

// Function combinators
// let search = functions::debounce(expensive_search, Duration::from_millis(300));

// Type utilities
let is_empty = types::is_empty::<Vec<i32>>(&vec![]);
```

## Installation


Add to your `Cargo.toml`:

```toml
[dependencies]
toolchest = "1.0"
```

## Modules at a Glance


For full API details, see the docs: https://docs.rs/toolchest

### Strings

- case conversion/manipulation/escape/words/slug/validators and more

### Math

- rounding/stats/ranges/numeric helpers/primes/vectors/distances

### Deep

- clone/merge/equal/path and JSON path (feature: `json`)

### Functions

- debounce/throttle/memoize/retry/backoff/compose/rate-limiters/timeout

### Types

- checking/conversions/non-empty and helpers

### Collections

- chunk/uniq/set ops/grouping/windows/cartesian/transpose/sort/find

### Time

- humanize/parse/stopwatch/backoff/cron-lite

### Random

- ranges/choices/uuid/bytes

### Hash

- djb2/fnv1a/murmur3/consistent hash

### IO (feature: `fs`)

- read/write/dirs/find files

### Validation

- Luhn, ascii/utf8

### Encoding

- hex, rot13/caesar


## Performance


- Zero runtime dependencies
- Zero-cost abstractions
- Optimized for common cases
- Optional `no_std` support

## Migration from Common Crates


Replacing multiple utility crates with `toolchest`:

```toml
# Before

[dependencies]
convert_case = "0.6"
heck = "0.4"
stringcase = "0.2"

# After

[dependencies]
toolchest = "1.0"
```

## Contributing


See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License


Licensed under either of:
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE))
- MIT license ([LICENSE-MIT](LICENSE-MIT))

at your option.