relhu 0.1.2

A library that can parse relative and/or human time duration 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

# relhu

<div align="center">
  <h1>relhu</h1>
  <p>
    relhu is a library that can parse <i><b>rel</b>ative and/or <b>hu</b>man</i> time duration strings.
  </p>

[<img src="https://img.shields.io/crates/v/relhu.svg?style=flat-square" alt="crates.io link">](https://crates.io/crates/relhu)
[<img src="https://docs.rs/relhu/badge.svg" alt="Documentation">](https://docs.rs/relhu)

</div>

## Usage

```rust
use std::time::{Duration, Instant};

fn main() {
    // Parsing to get a duration.
    assert_eq!(relhu::parse_duration("5s").unwrap(), Duration::from_secs(5));
    assert_eq!(relhu::parse_duration("100 us").unwrap(), Duration::from_micros(100));

    // Parsing to get an instant in the future.
    let now = Instant::now();
    assert_eq!(relhu::parse_with_instant("15m later", now).unwrap(), now + Duration::from_secs(15 * 60));
    assert_eq!(relhu::parse_with_instant("+55ms", now).unwrap(), now + Duration::from_millis(55));

    // Parsing to get an instant in the past.
    let now = Instant::now();
    assert_eq!(relhu::parse_with_instant("20ns ago", now).unwrap(), now - Duration::from_nanos(20));
    assert_eq!(relhu::parse_with_instant("- 5 days", now).unwrap(), now - Duration::from_secs(5 * 60 * 60 * 24));
}
```

## Licensing

relhu is dual-licensed under MIT or Apache-2.0 at your choice.