tobogganSe connecter

packages

The Louise packages, each released on its own

Clone avec HTTPS, un jeton personnel en mot de passe, ou avec SSH, une clé ajoutée dans vos paramètres.

NomDernier commitDate
src/packages/url: parse, resolve and write URLs with a host (ADR 0079)il y a 2 sem.
test/packages/url: parse, resolve and write URLs with a host (ADR 0079)il y a 2 sem.
CHANGELOG.mdA repository of its own: README, CI, release checks, fixturesil y a 4 j
louise.tomlVersion every package 0.21.0, on louise 0.22.0il y a 4 j
README.mdpackages/url: parse, resolve and write URLs with a host (ADR 0079)il y a 2 sem.
README.MD

url

URLs (RFC 3986) with a host, in pure Louise: parse one, resolve a link against it, write it back, and get the request target an HTTP client sends. packages/fetch builds on it (ADR 0079).

import url.{type Url, Url}

url.parse "https://Example.com:8443/a/b?x=1#top"
// Ok(Url("https", "example.com", Some(8443), "/a/b", Some("x=1"), Some("top")))

use page <- result.try (url.parse "https://example.com/blog/post")
url.resolve page "../about"            // Ok: https://example.com/about
url.resolve page "//cdn.example/i.png" // Ok: https://cdn.example/i.png
url.request_target page                // "/blog/post"
url.port_or_default page               // Some(443)
url.to_string page                     // "https://example.com/blog/post"

The type

pub type Url
{ Url(scheme: String, host: String, port: Option<Int>, path: String,
      query: Option<String>, fragment: Option<String>) }
  • The scheme and the host are lowercased. An IPv6 host keeps its brackets ("[::1]"), so to_string and a Host header can use it as it is.
  • port is None when the URL names none; port_or_default gives 80 for http/ws, 443 for https/wss, None for another scheme.
  • query and fragment are None when absent and Some("") after a bare ? or #.
  • The path is "" or starts with /, with its . and .. segments removed. Percent escapes are kept as written: nothing is decoded.
  • parse (to_string u) == Ok(u) for a parsed u.

What is refused

parse and resolve answer Error(reason) for:

  • text with no scheme, or no //host after it (mailto:, urn:, http:g): this package only represents URLs with a host;
  • a user name or password (https://user:pass@host/), which a link should never carry and which hides the real host from a reader;
  • a host that is not ASCII. There is no IDNA (punycode) here: write the xn-- form;
  • a host with a character outside A-Z a-z 0-9 - . _ ~ (no percent escapes, no sub-delimiters), or an empty one;
  • a port that is not 0 to 65535;
  • a control character anywhere (a CR or LF cannot reach a request line).

Resolving

resolve base reference is RFC 3986's §5.2, with remove_dot_segments. It is tested against every example of §5.4.1 and §5.4.2, except the two whose result has no host (g:h and the strict http:g), which are refused.

The request target

request_target url is the path (/ when empty) and ?query, without the fragment. A byte that cannot appear there as it is — a space, ", <, \, a byte of a non-ASCII character, a % not followed by two hex digits — is percent-encoded; escapes already written are kept. A Url built by hand with a CR or LF in its path still gives a single line.