uhttp_uri 0.5.0

Zero-allocation parser for HTTP URIs
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

# uhttp_uri -- HTTP URI parser

[Documentation](https://docs.rs/uhttp_uri)

This crate provides a barebone, zero-allocation parser for [HTTP
URIs](https://tools.ietf.org/html/rfc7230#section-2.7) as they appear in a request
header.

In general, components are extracted along defined delimiters, but further validation
and processing (such as percent decoding, query decoding, and punycode decoding) is
left to higher layers. In the pursuit of simplicity, this crate also contains no
support for generic and non-http URIs such as `file:` and `ftp://` – only the reduced
syntax for [`http://`](https://tools.ietf.org/html/rfc7230#section-2.7.1) and
[`https://`](https://tools.ietf.org/html/rfc7230#section-2.7.2) schemes is
implemented.

## Example

```rust
use uhttp_uri::{HttpUri, HttpResource, HttpScheme};

let uri = HttpUri::new("https://example.com:443/r/rarepuppers?k=v&v=k#top").unwrap();
assert_eq!(uri.scheme, HttpScheme::Https);
assert_eq!(uri.authority, "example.com:443");
assert_eq!(uri.resource.path, "/r/rarepuppers");
assert_eq!(uri.resource.query, Some("k=v&v=k"));
assert_eq!(uri.resource.fragment, Some("top"));

let res = HttpResource::new("/shittydogs?lang=en");
assert_eq!(res.path, "/shittydogs");
assert_eq!(res.query, Some("lang=en"));
assert_eq!(res.fragment, None);
```

## Usage

This [crate](https://crates.io/crates/uhttp_uri) can be used through cargo by adding
it as a dependency in `Cargo.toml`:

```toml
[dependencies]
uhttp_uri = "0.5.0"
```
and importing it in the crate root:

```rust
extern crate uhttp_uri;
```