bytesize 2.5.0

Semantic wrapper for byte count representations
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

## ByteSize

<!-- prettier-ignore-start -->

[![crates.io](https://img.shields.io/crates/v/bytesize?label=latest)](https://crates.io/crates/bytesize)
[![Documentation](https://docs.rs/bytesize/badge.svg?version=2.5.0)](https://docs.rs/bytesize/2.5.0)
![Version](https://img.shields.io/badge/rustc-1.85+-ab6000.svg)
![Apache 2.0 licensed](https://img.shields.io/crates/l/bytesize.svg)
<br />
[![Dependency Status](https://deps.rs/crate/bytesize/2.5.0/status.svg)](https://deps.rs/crate/bytesize/2.5.0)
[![Download](https://img.shields.io/crates/d/bytesize.svg)](https://crates.io/crates/bytesize)

<!-- prettier-ignore-end -->

<!-- cargo-rdme start -->

`ByteSize` is a semantic wrapper for byte count representations.

Features:

- Pre-defined constants for various size units (e.g., B, KB, KiB, MB, MiB, ... EB, EiB).
- `ByteSize` type which presents size units convertible to different size units.
- Arithmetic operations for `ByteSize`.
- `FromStr` impl for `ByteSize`, allowing for parsing string size representations like "1.5KiB" and "521TiB".
- Serde support for binary and human-readable deserializers like JSON.

### Feature flags

- `std` (default): Enables the `alloc` feature and standard library optimizations.
- `alloc`: Enables parsing and formatting.
- `arbitrary`: Implements `arbitrary::Arbitrary` for [`ByteSize`].
- `serde`: Enables `alloc` and implements serialization and deserialization for [`ByteSize`].

Disable the default features to use only the core data types, conversions, and constants.

### Examples

Construction using SI or IEC helpers.

```rust
use bytesize::ByteSize;

assert!(ByteSize::kib(4) > ByteSize::kb(4));
```

Display as human-readable string.

```rust
use bytesize::ByteSize;

assert_eq!("518.0 GiB", ByteSize::gib(518).display().iec().to_string());
assert_eq!("556.2 GB", ByteSize::gib(518).display().si().to_string());
assert_eq!("518.0G", ByteSize::gib(518).display().iec_short().to_string());
```

Arithmetic operations are supported.

```rust
use bytesize::ByteSize;

let plus = ByteSize::mb(1) + ByteSize::kb(100);
println!("{plus}");

let minus = ByteSize::tb(1) - ByteSize::gb(4);
assert_eq!(ByteSize::gb(996), minus);
```

<!-- cargo-rdme end -->