Debian Codegraph @

net/uri/fmt.ha

raw
1 // SPDX-License-Identifier: MPL-2.0
2 // (c) Hare authors <https://harelang.org>
3
4 use ascii;
5 use encoding::utf8;
6 use fmt;
7 use io;
8 use memio;
9 use net::ip;
10 use strings;
11
12
13 // Extract from RFC3986 ABNF
14 // URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
15 // unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
16 // sub-delims = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="
17 // reg-name = *( unreserved / pct-encoded / sub-delims )
18 // host = IP-literal / IPv4address / reg-name
19 // pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
20 // query = *( pchar / "/" / "?" )
21 // fragment = *( pchar / "/" / "?" )
22
23 def unres_host: str = "-._~!$&'()*+,;=";
24 def unres_query_frag: str = "-._~!$&'()*+,;=:@/?";
25 def unres_path: str = "-._~!$&'()*+,;=:@/";
26
27 // Writes a formatted [[uri]] to an [[io::handle]]. Returns the number of bytes
28 // written.
29 export fn fmt(out: io::handle, u: *const uri) (size | io::error) = {
30 let n = 0z;
31 let slashes_w = false;
32 let has_host = false;
33 if (u.scheme != "") {
34 n += fmt::fprintf(out, "{}:", u.scheme)?;
35 };
36 if (len(u.userinfo) > 0) {
37 assert(!(u.host is str) || len(u.host as str) > 0);
38 n += fmt::fprintf(out, "//{}@", u.userinfo)?;
39 slashes_w = true;
40 };
41 match (u.host) {
42 case let host: str =>
43 // file scheme is allowed an empty host
44 if (len(host) > 0 || u.scheme == "file") {
45 has_host = true;
46 if (!slashes_w) {
47 n += fmt::fprint(out, "//")?;
48 };
49 let unres = if(u.scheme == "file") {
50 yield unres_path;
51 } else {
52 yield unres_host;
53 };
54 n += percent_encode(out, host, unres)?;
55 };
56 case let addr: ip::addr =>
57 has_host = true;
58 if (!slashes_w) {
59 n += fmt::fprint(out, "//")?;
60 };
61 n += fmtaddr(out, addr)?;
62 };
63 if (u.port != 0) {
64 n += fmt::fprintf(out, ":{}", u.port)?;
65 };
66 if (has_host && len(u.path) > 0 && !strings::hasprefix(u.path, '/')) {
67 n += fmt::fprint(out, "/")?;
68 };
69 n += percent_encode(out, u.path, unres_path)?;
70 if (len(u.query) > 0) {
71 // Always percent-encoded, see parse and encodequery/decodequery
72 n += fmt::fprintf(out, "?{}", u.query)?;
73 };
74 if (len(u.fragment) > 0) {
75 n += fmt::fprint(out, "#")?;
76 n += percent_encode(out, u.fragment, unres_query_frag)?;
77 };
78
79 return n;
80 };
81
82 fn fmtaddr(out: io::handle, addr: ip::addr) (size | io::error) = {
83 let n = 0z;
84 match (addr) {
85 case let addr: ip::addr4 =>
86 n += ip::fmt(out, addr)?;
87 case let addr: ip::addr6 =>
88 n += fmt::fprintf(out, "[")?;
89 n += ip::fmt(out, addr)?;
90 n += fmt::fprintf(out, "]")?;
91 };
92 return n;
93 };
94
95 fn percent_encode(out: io::handle, src: str, allowed: str) (size | io::error) = {
96 let iter = strings::iter(src);
97 let n = 0z;
98 for (let r => strings::next(&iter)) {
99 if (ascii::isalnum(r) || strings::contains(allowed, r)) {
100 n += fmt::fprint(out, r)?;
101 } else {
102 const en = utf8::encoderune(r);
103 for (let elem .. en) {
104 n += fmt::fprintf(out, "%{:X}", elem)?;
105 };
106 };
107 };
108 return n;
109 };
110
111 // Formats a [[uri]] into a string. The result must be freed by the caller.
112 export fn string(u: *const uri) (str | nomem) = {
113 const st = memio::dynamic();
114 match (fmt(&st, u)) {
115 case size => void;
116 case let e: io::error =>
117 assert(e is nomem);
118 return nomem;
119 };
120 return memio::string(&st)!;
121 };