Crate fluent_uri

A generic URI/IRI handling library compliant with RFC 3986 and RFC 3987.

Examples: Parsing. Building. Reference resolution. Normalization. Percent-decoding. Percent-encoding.

Terminology

A URI reference is either a URI or a relative reference. If it starts with a scheme (like http, ftp, mailto, etc.) followed by a colon (:), it is a URI. For example, http://example.com/ and mailto:user@example.com are URIs. Otherwise, it is a relative reference. For example, //example.org/, /index.html, ../, foo, ?bar, and #baz are relative references.

An IRI (reference) is an internationalized version of URI (reference) which may contain non-ASCII characters.

Guidance for crate users

Advice for designers of new URI schemes can be found in RFC 7595. Guidance on the specification of URI substructure in standards can be found in RFC 8820. The crate author recommends RFC 9413 for further reading as the long-term interoperability of URI schemes may be of concern.

Crate features

• std (default): Enables std support. Required for Error implementations and Authority::socket_addrs.

• net: Enables std::net or core::net support. Required for IP address fields in Host, for Builder::host to take an IP address as argument, and for Authority::socket_addrs. Disabling std while enabling net requires a minimum Rust version of 1.77.

• serde: Enables serde support. Required for Serialize and Deserialize implementations.

Modules

component

URI/IRI components.

encoding

Percent-encoding utilities.

error

Error types.

Structs

Builder

A builder for URI/IRI (reference).

Iri

An IRI.

IriRef

An IRI reference, i.e., either a IRI or a relative reference.

Uri

A URI.

UriRef

A URI reference, i.e., either a URI or a relative reference.