ferrin-provider-util 0.2.0

Ferrin provider utilities: HTTP transport trait, reqwest transport, SSE decoding, secure URL policy, settings.
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

//! Base URL validation.

use ferrin_spec::error::InvalidArgumentError;
use url::Url;

/// Parses a base URL: non-empty, absolute, trailing slash removed.
///
/// # Errors
///
/// Returns [`InvalidArgumentError`] (argument `base_url`) for empty or
/// unparsable input.
pub fn parse_base_url(base_url: &str) -> Result<Url, InvalidArgumentError> {
    if base_url.trim().is_empty() {
        return Err(InvalidArgumentError::new(
            "base_url",
            "base_url must be a non-empty string.",
        ));
    }
    let url = Url::parse(base_url.trim()).map_err(|error| {
        InvalidArgumentError::new("base_url", format!("base_url is not a valid URL: {error}"))
    })?;
    Ok(without_trailing_slash(url))
}

/// Removes one trailing slash from the path.
#[must_use]
pub fn without_trailing_slash(mut url: Url) -> Url {
    let path = url.path();
    if path.len() > 1 && path.ends_with('/') {
        let trimmed = path[..path.len() - 1].to_owned();
        url.set_path(&trimmed);
    }
    url
}

/// Joins `path` onto a base URL whose path is preserved (`/v1` + `/chat` →
/// `/v1/chat`).
#[must_use]
pub fn join_path(base: &Url, path: &str) -> Url {
    let mut url = base.clone();
    let base_path = base.path().trim_end_matches('/');
    let joined = format!("{base_path}/{}", path.trim_start_matches('/'));
    url.set_path(&joined);
    url.set_query(None);
    url
}