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.