uriproxy 0.1.2

internal upub crate to handle remote uris
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

use base64::Engine;

#[derive(Clone, Copy, Debug)]
pub enum UriClass {
	Actor,
	Object,
	Activity,
	Hashtag,
	List,
}

impl AsRef<str> for UriClass {
	fn as_ref(&self) -> &str {
		match self {
			Self::Actor => "actors",
			Self::Object => "objects",
			Self::Activity => "activities",
			Self::Hashtag => "tags",
			Self::List => "lists",
		}
	}
}

/// unpack uri in id if valid, otherwise compose full uri with "{base}/{entity}/{id}"
pub fn uri(base: &str, entity: UriClass, id: &str) -> String {
	if id.starts_with("https://") || id.starts_with("http://") {
		return id.to_string();
	}

	if id.starts_with('+') { // ready-to-use base64-encoded id
		if let Some(expanded) = expand(id) {
			return expanded;
		}
	}

	format!("{}/{}/{}", base, entity.as_ref(), id)
}

/// decompose local id constructed by uri() fn
pub fn decompose(full_id: &str) -> String {
		full_id       //  https://example.org/actors/test/followers/page?offset=42
			.replace("https://", "")
			.replace("http://", "")
			.split('/') //  ['example.org', 'actors', 'test', 'followers', 'page?offset=42' ]
			.nth(2)     //  'test'
			.unwrap_or("")
			.to_string()
}

pub fn expand(uri: &str) -> Option<String> {
	if let Ok(bytes) = base64::prelude::BASE64_URL_SAFE_NO_PAD.decode(uri.replacen('+', "", 1)) {
		if let Ok(uri) = std::str::from_utf8(&bytes) {
			return Some(uri.to_string());
		}
	}
	None
}

/// encode with base64 remote url and prefix it with +
pub fn compact(uri: &str) -> String {
	let encoded = base64::prelude::BASE64_URL_SAFE_NO_PAD.encode(uri.as_bytes());
	format!("+{encoded}")
}