hex_str 0.3.0

A library that helps handle hexadecimal strings
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

# `hex_str`
Handle and parse hex strings of constant and variable lengths

## Example:

Example hex string, an md5 of an empty file:
```text
d41d8cd98f00b204e9800998ecf8427e
```
```rust
use hex_str::HexString;

let s = "d41d8cd98f00b204e9800998ecf8427e";

// constant length, encoded in the type system
let u = HexStringN::<16>::try_parse(s).unwrap();
assert_eq!(u, "d41d8cd98f00b204e9800998ecf8427e");

// variable length
let v = HexString::try_parse(s).unwrap();
assert_eq!(v, "d41d8cd98f00b204e9800998ecf8427e");
```

## Feature flags:
- `serde` - adds the ability to serialize, and deserialize `HexString`'s, and `HexStringN`'s using `serde`.
- `rand` - adds implementation of `rand`'s [`Standard`](https://docs.rs/rand/0.8.4/rand/distributions/struct.Standard.html)
distribution, which enables random generation of `HexStringN`'s directly.

#### Using `serde` feature:
```rust
use hex_str::HexString;
use serde::{Deserialize, Serialize};

#[derive(Deserialize, Serialize)]
struct Example {
    md5: HexString<16>,
}

let s = r#"
    {
        "md5": "d41d8cd98f00b204e9800998ecf8427e"
    }
"#;

let example: Example = serde_json::from_str(s).unwrap();
assert_eq!(example.md5, "d41d8cd98f00b204e9800998ecf8427e");

serde_json::to_string(&example).unwrap();
```

#### Using `rand` feature:
```rust
use hex_str::HexString;

let _: HexString<16> = rand::random();
```