restapi 1.1.14

A secure-by-default rest api using hyper, tokio, bb8, kafka-threadpool, postgres, and prometheus for monitoring
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

//! Module for getting url query params and storing them in a:
//! ``HashMap<String, String>``
//!
use std::collections::HashMap;

use url::Url;

/// get_query_params_from_url
///
/// parse a url's query parameters and return as a
/// [`HashMap`](std::collections::HashMap)
/// where: key as a `String` => value as a `String`
///
/// please be warned that duplicate query parameter `keys` are
/// not supported correctly. this function will only work
/// with unique query_parameters at this time
///
/// credit source to:
///
/// <https://stackoverflow.com/questions/43272935/how-do-i-decode-a-url-and-get-the-query-string-as-a-hashmap>
///
/// # Arguments
///
/// * `tracking_label` - `&str` - logging label for caller
/// * `url` - `&str` - url to process
///
/// # Errors
///
/// `String` - error message
///
/// # Examples
///
/// ```
/// use restapi::utils::get_query_params_from_url::get_query_params_from_url;
/// let hash_map = tokio_test::block_on(
///     get_query_params_from_url(
///         "test-url",
///         "https://mydomain.io/user?key1=value1&key2=value2")
///     ).unwrap();
/// println!("{:?}", hash_map);
/// ```
pub async fn get_query_params_from_url(
    tracking_label: &str,
    url: &str,
) -> Result<HashMap<String, String>, String> {
    let url_len = url.len();
    if url_len == 0 {
        return Err("get_query_params_from_url - no url set".to_string());
    } else if url_len > 512 {
        return Err("get_query_params_from_url - url is too long".to_string());
    }
    let parsed_url = match Url::parse(url) {
        Ok(parsed_url) => parsed_url,
        Err(e) => {
            let err_msg = format!("{e}");
            error!(
                "{tracking_label} - \
                get_query_params_from_url failed to parse \
                {url} with err='{err_msg}'"
            );
            return Err(err_msg);
        }
    };
    let query_params_hash_map: HashMap<String, String> =
        parsed_url.query_pairs().into_owned().collect();
    /*
    info!("{tracking_label} - \
        found hash map - hash_map {url}");
    */
    Ok(query_params_hash_map)
}