readable 0.3.1

Human readable data formatting
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

# Readable
![Build](https://github.com/hinto-janai/readable/actions/workflows/build.yml/badge.svg)
[![crates.io](https://img.shields.io/crates/v/readable.svg)](https://crates.io/crates/readable)
[![docs.rs](https://docs.rs/readable/badge.svg)](https://docs.rs/readable)

Human **readable** data formatting.

This crate turns various data into human-readable strings.

For performance, the actual string used internally is not a [`String`](https://doc.rust-lang.org/std/string/struct.String.html), but a [`CompactString`](https://docs.rs/compact_str) so that any string 24 bytes (12 bytes on 32-bit) or less are _stack_ allocated instead of _heap_ allocated.

The documentation will still refer to the inner string as a [`String`]. Anything returned will also be a [`String`].

## Feature flags
| Flag             | Purpose |
|------------------|---------|
| `serde`          | Enable [`serde`](https://docs.rs/serde) on all types
| `ignore_nan_inf` | Disable checking `f64`'s for `f64::NAN`, `f64::INFINITY`, and `f64::NEG_INFINITY`

## Examples
#### Integers
```rust
let a = readable::Int::from(1000);
println!("{}", a);

> 1,000
```

#### Floats
```rust
let a = readable::Float::from(1000.123);
let b = readable::Float::percent(1000.123);
println!("{}", a);
println!("{}", b);

> 1,000.123
> 1,000.12%
```

#### Runtime
```rust
let a = readable::Runtime::from(11111.1);
println!("{}", a);

> 3:05:11
```

#### Time
```rust
let a = std::time::Duration::from_secs(86399);
let b = readable::Time::from(time);
println!("{}", b);

> 23 hours, 59 minutes, 59 seconds
```