Skip to main content

Module url

Module url 

Source
Expand description

Parser for the s3+https / s3+http / az+https / az+http URL grammar.

The parser strips the backend prefix (s3+ or az+), parses the remainder as an RFC 3986 URL via the url crate, then layers cleartext-HTTP gating, backend-specific name validation, addressing-style detection, and query-flag extraction on top. The user-facing grammar reference is docs/getting-started.md.

Structs§

RemoteFlags
Query-string flags described in §3.2 / §3.3.

Enums§

AzureAddressing
Azure Blob addressing style (§3.4).
BackendKind
Which backend a URL (or error) refers to.
ParseError
Errors produced by parse.
RemoteUrl
A parsed remote URL.
S3Addressing
S3 addressing style (§3.4).
StorageEngine
Identifies the on-bucket storage format / serialisation engine.

Constants§

ENV_ALLOW_HTTP
Environment override that allows cleartext *+http:// URLs against non-loopback hosts. Accepted when set to any of the truthy values recognised by [parse_bool_value] (1, true, yes, on, case-insensitive). Any other value — including the empty string, 0, false, no, off, or any unrecognised token — is treated as “not set” and the cleartext-HTTP gate stays closed.

Functions§

parse
Parse a remote URL.