locale-match

A small library for matching a locale from a list of available locales to the user's preferred locales.

Examples

BCP 47

use locale_match::bcp47::best_matching_locale;


let available_locales = vec!["en-US", "en-GB", "ru-UA", "fr-FR", "it"];
let user_locales = vec!["ru-RU", "ru", "en-US", "en"];

let best_match = best_matching_locale(available_locales.iter(), user_locales.iter());

// "ru-UA" is the best match for the highest-priority user locale "ru-RU"
assert_eq!(best_match, Some("ru-UA".to_string()));


let available_locales = vec!["en", "pt-BR", "pt-PT", "es"];
let user_locales = vec!["pt", "en"];

let best_match = best_matching_locale(available_locales.iter(), user_locales.iter());

// "pt-BR" is the first best match for the highest-priority user locale "pt"
assert_eq!(best_match, Some("pt-BR".to_string()));


let available_locales = vec!["zh", "zh-cmn", "zh-cmn-Hans"];
let user_locales = vec!["zh-Hans"];

let best_match = best_matching_locale(available_locales.iter(), user_locales.iter());

// Empty extended language subtag in "zh-Hans" matches any extended language, e.g. "cmn"
assert_eq!(best_match, Some("zh-cmn-Hans".to_string()));

POSIX

use locale_match::posix::best_matching_locale;


let available_locales = vec!["en_US", "en_GB", "ru_UA", "fr_FR", "it"];
let user_locales = vec!["ru_RU", "ru", "en_US", "en"];

let best_match = best_matching_locale(available_locales.iter(), user_locales.iter());

// "ru_UA" is the best match for the highest-priority user locale "ru_RU"
assert_eq!(best_match, Some("ru_UA"));


let available_locales = vec!["en", "pt_BR", "pt_PT", "es"];
let user_locales = vec!["pt", "en"];

let best_match = best_matching_locale(available_locales.iter(), user_locales.iter());

// "pt_BR" is the first best match for the highest-priority user locale "pt"
assert_eq!(best_match, Some("pt_BR"));


let available_locales = vec!["fr", "fr_FR", "fr_CA.UTF-8"];
let user_locales = vec!["fr.UTF-8"];

let best_match = best_matching_locale(available_locales.iter(), user_locales.iter());

// Empty territory in "fr.UTF-8" matches any territory, e.g. "CA"
assert_eq!(best_match, Some("fr_CA.UTF-8"));

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Copyright

2024 Petr Alexandrovich Sabanov

Metrics