Crate idna

This Rust crate implements IDNA per the WHATWG URL Standard.

It also exposes the underlying algorithms from Unicode IDNA Compatibility Processing (Unicode Technical Standard #46) and Punycode (RFC 3492).

Quoting from UTS #46’s introduction:

Initially, domain names were restricted to ASCII characters. A system was introduced in 2003 for internationalized domain names (IDN). This system is called Internationalizing Domain Names for Applications, or IDNA2003 for short. This mechanism supports IDNs by means of a client software transformation into a format known as Punycode. A revision of IDNA was approved in 2010 (IDNA2008). This revision has a number of incompatibilities with IDNA2003.

The incompatibilities force implementers of client software, such as browsers and emailers, to face difficult choices during the transition period as registries shift from IDNA2003 to IDNA2008. This document specifies a mechanism that minimizes the impact of this transition for client software, allowing client software to access domains that are valid under either system.

Re-exports

• pub use uts46::AsciiDenyList;

Modules

• deprecated 🔒
  Deprecated API for Unicode IDNA Compatibility Processing (Unicode Technical Standard #46)
• punycode
  Punycode (RFC 3492) implementation.
• uts46
  This module provides the lower-level API for UTS 46.

Structs

• ConfigDeprecated
  Deprecated configuration API.
• Errors
  Type indicating that there were errors during UTS #46 processing.
• IdnaDeprecated
  Deprecated. Use the crate-top-level functions or Uts46.

Functions

• domain_to_ascii
  The domain to ASCII algorithm; version returning String and no ASCII deny list (i.e. UseSTD3ASCIIRules=false).
• domain_to_ascii_cow
  The domain to ASCII algorithm; version returning a Cow.
• domain_to_ascii_strict
  The domain to ASCII algorithm, with the beStrict flag set.
• domain_to_unicode
  The domain to Unicode algorithm; version returning String and no ASCII deny list (i.e. UseSTD3ASCIIRules=false).