/ 
Getopt-EX-i18n-1.01
⭐ Starred 0 / README.md

Actions Status MetaCPAN Release

NAME

Getopt::EX::i18n - General i18n module

SYNOPSIS

command -Mi18n [ options ]

DESCRIPTION

This module i18n provide an easy way to set locale environment before executing arbitrary command. Locale list is taken from the system by locale -a command. Next list is a sample locales available on macOS 10.15 (Catalina).

af_ZA    Afrikaans / South Africa
am_ET    Amharic / Ethiopia
be_BY    Belarusian / Belarus
bg_BG    Bulgarian / Bulgaria
ca_ES    Catalan; Valencian / Spain
cs_CZ    Czech / Czech Republic
da_DK    Danish / Denmark
de_AT    German / Austria
de_CH    German / Switzerland
de_DE    German / Germany
el_GR    Greek, Modern (1453-) / Greece
en_AU    English / Australia
en_CA    English / Canada
en_GB    English / United Kingdom
en_IE    English / Ireland
en_NZ    English / New Zealand
en_US    English / United States
es_ES    Spanish / Spain
et_EE    Estonian / Estonia
eu_ES    Basque / Spain
fi_FI    Finnish / Finland
fr_BE    French / Belgium
fr_CA    French / Canada
fr_CH    French / Switzerland
fr_FR    French / France
he_IL    Hebrew / Israel
hr_HR    Croatian / Croatia
hu_HU    Hungarian / Hungary
hy_AM    Armenian / Armenia
is_IS    Icelandic / Iceland
it_CH    Italian / Switzerland
it_IT    Italian / Italy
ja_JP    Japanese / Japan
kk_KZ    Kazakh / Kazakhstan
ko_KR    Korean / Korea, Republic of
lt_LT    Lithuanian / Lithuania
nl_BE    Dutch / Belgium
nl_NL    Dutch / Netherlands
no_NO    Norwegian / Norway
pl_PL    Polish / Poland
pt_BR    Portuguese / Brazil
pt_PT    Portuguese / Portugal
ro_RO    Romanian / Romania
ru_RU    Russian / Russian Federation
sk_SK    Slovak / Slovakia
sl_SI    Slovenian / Slovenia
sr_YU    Serbian / Yugoslavia
sv_SE    Swedish / Sweden
tr_TR    Turkish / Turkey
uk_UA    Ukrainian / Ukraine
zh_CN    Chinese / China
zh_HK    Chinese / Hong Kong
zh_TW    Chinese / Taiwan, Province of China

As for Japanese locale ja_JP, following options are defined by default, and set LANG environment as ja_JP. Environment variable name can be changed by env option.

LOCALE:     --ja_JP  (raw)
            --ja-JP  (dash)
            --jaJP   (long)
            --jajp   (long_lc)
LANGUAGE:   --ja     (language)
TERRITORY:  --JP     (territory)
            --jp     (territory_lc)

Short language option (--ja) is defined in the alphabetical order of the territory code, so the option --en is assigned to en_AU. But if the same territory name is found as language, it takes precedence; German is used in three locales (de_AT, de_CH, de_DE) but option --de is defined as de_DE.

Territory options (--JP and --jp) are defined only when the same language option is not defined by other entry, and only single entry can be found for the territory. Option for Switzerland is not defined because there are three entries (de_CH, fr_CH, it_CH). Territory option --AM is assigned to hy_AM, but language option --am is assigned to am_ET.

OPTION

Option parameter can be given with setopt function called with module declaration.

command -Mi18n::setopt(name[=value])

BUGS

Support only UTF-8.

SEE ALSO

LICENSE

Copyright (C) 2020-2025 Kazumasa Utashiro.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Kazumasa Utashiro