yuri 0.1.0

no_std alloc-free URI Parser
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

//! URI Authority types

/// Authority
#[derive(Clone, Debug, PartialEq)]
pub struct Authority<'uri> {
    /// Userinfo
    pub userinfo: Option<UserInfo<'uri>>,
    /// Raw unparsed host
    pub raw_host: &'uri str,
    /// Port if supplied, otherwise default by scheme
    pub port: Option<u16>,
}

use crate::error::AuthorityError;

impl<'uri> Authority<'uri> {
    /// Construct new with host
    #[cfg(feature = "builder")]
    pub fn from_host_str(host: &'uri str) -> Result<Self, AuthorityError<'uri>> {
        Ok(Self {
            userinfo: None,
            raw_host: host,
            port: None,
        })
    }
}

/// Authority userinfo
#[derive(Clone, Debug, PartialEq)]
pub struct UserInfo<'uri> {
    /// Raw user part
    pub raw_user: &'uri str,
    /// Raw authorisation part
    /// **Warning** claertext password is deprecated & insecure
    pub(crate) raw_authorization: Option<&'uri str>,
}

impl<'uri> UserInfo<'uri> {
    /// Get raw authorization part
    /// **NOTE**: RFC has deprecated this field for cleartext passwords which are insecure.
    pub fn raw_authorization(&self) -> Option<&'uri str> {
        self.raw_authorization
    }
    /// Set raw authorization part
    /// **NOTE**: RFC has deprecated this field for cleartext passwords which are insecure.
    #[cfg(feature = "builder")]
    pub fn set_authorization(&mut self, user: &'uri str, auth: Option<&'uri str>) {
        self.raw_user = user;
        self.raw_authorization = auth;
    }
}