#back-end #idna #unicode #dns

no-std idna_adapter

Back end adapter for idna

4 releases (stable)

new 1.2.0 Oct 29, 2024
1.1.0 Oct 29, 2024
1.0.0 Oct 29, 2024
0.0.0 Jul 3, 2024

#393 in Internationalization (i18n)

Download history 7/week @ 2024-07-29 6/week @ 2024-09-16 7/week @ 2024-09-23 445/week @ 2024-10-28

445 downloads per month
Used in 26,538 crates (via idna)

Apache-2.0 OR MIT

15KB
180 lines

idna_adapter

This crate abstracts over a Unicode back end for the idna crate.

To work around the lack of global-features in Cargo, this crate allows the top level Cargo.lock to choose an alternative Unicode back end for the idna crate by pinning a version of this crate.

idna depends on version 1 of this crate. The version stream 1.2.x uses ICU4X, the version stream 1.1.x uses unicode-rs, and the version stream 1.0.x has a stub implementation without an actual Unicode back end.

It is generally a good idea to refer to the README of the latest version instead of the guidance below for up-to-date information about what options are available.

ICU4X as the default

If you take no action, Cargo will choose the 1.2.x version stream i.e. ICU4X.

Opting to use unicode-rs

To choose unicode-rs, run cargo update -p idna_adapter --precise 1.1.0 in the top-level directory of your application.

Compared to ICU4X, this makes build times faster, MSRV lower, binary size larger, and run-time performance slower.

Turning off IDNA support

Since the ability to turn off actual IDNA processing has been requested again and again, an option to have no Unicode back end is provided. Choosing this option obviously breaks the idna crate in the sense that it cannot provide a proper implementation of UTS 46 without any Unicode data. Choosing this option makes your application reject non-ASCII domain name inputs and will fail to enforce the UTS 46 requirements on domain names that have labels in the Punycode form.

Using this option is not recommended, but to make the idna crate not actually support IDNA, run cargo update -p idna_adapter --precise 1.0.0 in the top-level directory of your application.

License

Apache-2.0 OR MIT

Dependencies

~1.9–2.9MB
~52K SLoC