web-url 0.10.0

This library aids in processing web-based URLs.
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

use crate::parse::path_plus::{parse_fragment, parse_path, parse_query};
use crate::parse::Error;

/// The parsing data for a web-based URL from the path to the end.
#[derive(Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash, Debug)]
pub struct PathPlus {
    pub path_len: usize,  // length of the path including the '/' (will be 1+)
    pub query_len: usize, // length of query including the '?' (will be 0+)
}

/// Parses the `path_plus`.
///
/// The path, query, and fragment will be validated.
pub fn parse_path_plus(path_plus: &str) -> Result<PathPlus, Error> {
    let (path, after_path) = parse_path(path_plus)?;
    let (query, after_query) = parse_query(after_path)?;
    parse_fragment(after_query)?;

    let path_len: usize = path.as_str().len();
    let query_len: usize = query.map(|q| q.as_str().len()).unwrap_or(0);

    Ok(PathPlus {
        path_len,
        query_len,
    })
}