1 unstable release
0.1.0 | Feb 11, 2023 |
---|
#2459 in Parser implementations
463 downloads per month
36KB
963 lines
url-lite
Port of the URL parser from nodejs/http-parser to Rust
Features
#[no_std]
- No heap allocations, returns a struct of
&str
- Never panics(tested by dtolnay/no-panic)
Installation
cargo add url_lite
Example
use url_lite::{Url, ParseError};
// Note that ParseError doesn't implement the Error trait unless the `unstable`
// feature is enabled
assert!(Url::parse("not-an-url") == Err(ParseError::Invalid))
let input = "https://usr:pass@example.com:8080/some%20path?foo=bar#zzz";
let url = Url::parse(input).expect("Invalid URL");
assert_eq!(url.schema, Some("https"));
assert_eq!(url.host, Some("example.com"));
assert_eq!(url.port, Some("8080"));
assert_eq!(url.path, Some("/some%20path"));
assert_eq!(url.query, Some("foo=bar"));
assert_eq!(url.fragment, Some("zzz"));
assert_eq!(url.userinfo, Some("usr:pass"));
Features
unstable
- Implementscore::error::Error
forParseError
. Requires nightly due to error_in_core
Caveats
Although this is a port of the URL parser from http-parser and it passes all the tests, it has not been used in production. It is also not a generic parser, may not support all URLs, only returns slices, and performs no decoding.
If you need a robust URL parser and are okay with std/alloc dependency, use servo/rust-url instead.
Dependencies
~240–690KB
~16K SLoC