""" Locale support.

The module provides low-level access to the C lib's locale APIs

and adds high level number formatting APIs as well as a locale

aliasing engine to complement these.

The aliasing engine includes support for many commonly used locale

names and maps them to values suitable for passing to the C lib's

setlocale() function. It also includes default encodings for all

supported locale names.

"""

import sys, encodings, encodings.aliases

from builtins import str as _builtin_str

import functools

# Try importing the _locale module.

#

# If this fails, fall back on a basic 'C' locale emulation.

# Yuck: LC_MESSAGES is non-standard: can't tell whether it exists before

# trying the import. So __all__ is also fiddled at the end of the file.

__all__ = ["getlocale", "getdefaultlocale", "getpreferredencoding", "Error",

"setlocale", "resetlocale", "localeconv", "strcoll", "strxfrm",

"str", "atof", "atoi", "format", "format_string", "currency",

"normalize", "LC_CTYPE", "LC_COLLATE", "LC_TIME", "LC_MONETARY",

"LC_NUMERIC", "LC_ALL", "CHAR_MAX"]

def _strcoll(a,b):

""" strcoll(string,string) -> int.

Compares two strings according to the locale.

"""

return cmp(a,b)

def _strxfrm(s):

""" strxfrm(string) -> string.

Returns a string that behaves for cmp locale-aware.

"""

return s

try:

from _locale import *

except ImportError:

# Locale emulation

CHAR_MAX = 127

LC_ALL = 6

LC_COLLATE = 3

LC_CTYPE = 0

LC_MESSAGES = 5

LC_MONETARY = 4

LC_NUMERIC = 1

LC_TIME = 2

Error = ValueError

def localeconv():

""" localeconv() -> dict.

Returns numeric and monetary locale-specific parameters.

"""

# 'C' locale default values

return {'grouping': [127],

'currency_symbol': '',

'n_sign_posn': 127,

'p_cs_precedes': 127,

'n_cs_precedes': 127,

'mon_grouping': [],

'n_sep_by_space': 127,

'decimal_point': '.',

'negative_sign': '',

'positive_sign': '',

'p_sep_by_space': 127,

'int_curr_symbol': '',

'p_sign_posn': 127,

'thousands_sep': '',

'mon_thousands_sep': '',

'frac_digits': 127,

'mon_decimal_point': '',

'int_frac_digits': 127}

def setlocale(category, value=None):

""" setlocale(integer,string=None) -> string.

Activates/queries locale processing.

"""

if value not in (None, '', 'C'):

raise Error('_locale emulation only supports "C" locale')

return 'C'

# These may or may not exist in _locale, so be sure to set them.

if 'strxfrm' not in globals():

strxfrm = _strxfrm

if 'strcoll' not in globals():

strcoll = _strcoll

_localeconv = localeconv

# With this dict, you can override some items of localeconv's return value.

# This is useful for testing purposes.

_override_localeconv = {}

@functools.wraps(_localeconv)

def localeconv():

d = _localeconv()

if _override_localeconv:

d.update(_override_localeconv)

return d

### Number formatting APIs

# Author: Martin von Loewis

# improved by Georg Brandl

#perform the grouping from right to left

def _group(s, monetary=False):

conv = localeconv()

thousands_sep = conv[monetary and 'mon_thousands_sep' or 'thousands_sep']

grouping = conv[monetary and 'mon_grouping' or 'grouping']

if not grouping:

return (s, 0)

result = ""

seps = 0

spaces = ""

if s[-1] == ' ':

sp = s.find(' ')

spaces = s[sp:]

s = s[:sp]

while s and grouping:

# if grouping is -1, we are done

if grouping[0] == CHAR_MAX:

break

# 0: re-use last group ad infinitum

elif grouping[0] != 0:

#process last group

group = grouping[0]

grouping = grouping[1:]

if result:

result = s[-group:] + thousands_sep + result

seps += 1

else:

result = s[-group:]

s = s[:-group]

if s and s[-1] not in "0123456789":

# the leading string is only spaces and signs

return s + result + spaces, seps

if not result:

return s + spaces, seps

if s:

result = s + thousands_sep + result

seps += 1

return result + spaces, seps

def format(percent, value, grouping=False, monetary=False, *additional):

"""Returns the locale-aware substitution of a %? specifier

(percent).

additional is for format strings which contain one or more

'*' modifiers."""

# this is only for one-percent-specifier strings and this should be checked

if percent[0] != '%':

raise ValueError("format() must be given exactly one %char "

"format specifier")

if additional:

formatted = percent % ((value,) + additional)

else:

formatted = percent % value

# floats and decimal ints need special action!

if percent[-1] in 'eEfFgG':

seps = 0

parts = formatted.split('.')

if grouping:

parts[0], seps = _group(parts[0], monetary=monetary)

decimal_point = localeconv()[monetary and 'mon_decimal_point'

or 'decimal_point']

formatted = decimal_point.join(parts)

while seps:

sp = formatted.find(' ')

if sp == -1: break

formatted = formatted[:sp] + formatted[sp+1:]

seps -= 1

elif percent[-1] in 'diu':

if grouping:

formatted = _group(formatted, monetary=monetary)[0]

return formatted

import re, operator

_percent_re = re.compile(r'%(?:\((?P<key>.*?)\))?'

r'(?P<modifiers>[-#0-9 +*.hlL]*?)[eEfFgGdiouxXcrs%]')

def format_string(f, val, grouping=False):

"""Formats a string in the same way that the % formatting would use,

but takes the current locale into account.

Grouping is applied if the third parameter is true."""

percents = list(_percent_re.finditer(f))

new_f = _percent_re.sub('%s', f)

if isinstance(val, tuple):

new_val = list(val)

i = 0

for perc in percents:

starcount = perc.group('modifiers').count('*')

new_val[i] = format(perc.group(), new_val[i], grouping, False, *new_val[i+1:i+1+starcount])

del new_val[i+1:i+1+starcount]

i += (1 + starcount)

val = tuple(new_val)

elif operator.isMappingType(val):

for perc in percents:

key = perc.group("key")

val[key] = format(perc.group(), val[key], grouping)

else:

# val is a single value

val = format(percents[0].group(), val, grouping)

return new_f % val

def currency(val, symbol=True, grouping=False, international=False):

"""Formats val according to the currency settings

in the current locale."""

conv = localeconv()

# check for illegal values

digits = conv[international and 'int_frac_digits' or 'frac_digits']

if digits == 127:

raise ValueError("Currency formatting is not possible using "

"the 'C' locale.")

s = format('%%.%if' % digits, abs(val), grouping, monetary=True)

# '<' and '>' are markers if the sign must be inserted between symbol and value

s = '<' + s + '>'

if symbol:

smb = conv[international and 'int_curr_symbol' or 'currency_symbol']

precedes = conv[val<0 and 'n_cs_precedes' or 'p_cs_precedes']

separated = conv[val<0 and 'n_sep_by_space' or 'p_sep_by_space']

if precedes:

s = smb + (separated and ' ' or '') + s

else:

s = s + (separated and ' ' or '') + smb

sign_pos = conv[val<0 and 'n_sign_posn' or 'p_sign_posn']

sign = conv[val<0 and 'negative_sign' or 'positive_sign']

if sign_pos == 0:

s = '(' + s + ')'

elif sign_pos == 1:

s = sign + s

elif sign_pos == 2:

s = s + sign

elif sign_pos == 3:

s = s.replace('<', sign)

elif sign_pos == 4:

s = s.replace('>', sign)

else:

# the default if nothing specified;

# this should be the most fitting sign position

s = sign + s

return s.replace('<', '').replace('>', '')

def str(val):

"""Convert float to integer, taking the locale into account."""

return format("%.12g", val)

def atof(string, func=float):

"Parses a string as a float according to the locale settings."

#First, get rid of the grouping

ts = localeconv()['thousands_sep']

if ts:

string = string.replace(ts, '')

#next, replace the decimal point with a dot

dd = localeconv()['decimal_point']

if dd:

string = string.replace(dd, '.')

#finally, parse the string

return func(string)

def atoi(str):

"Converts a string to an integer according to the locale settings."

return atof(str, int)

def _test():

setlocale(LC_ALL, "")

#do grouping

s1 = format("%d", 123456789,1)

print(s1, "is", atoi(s1))

#standard formatting

s1 = str(3.14)

print(s1, "is", atof(s1))

### Locale name aliasing engine

# Author: Marc-Andre Lemburg, [email protected]

# Various tweaks by Fredrik Lundh <[email protected]>

# store away the low-level version of setlocale (it's

# overridden below)

_setlocale = setlocale

def normalize(localename):

""" Returns a normalized locale code for the given locale

name.

The returned locale code is formatted for use with

setlocale().

If normalization fails, the original name is returned

unchanged.

If the given encoding is not known, the function defaults to

the default encoding for the locale code just like setlocale()

does.

"""

# Normalize the locale name and extract the encoding

fullname = localename.lower()

if ':' in fullname:

# ':' is sometimes used as encoding delimiter.

fullname = fullname.replace(':', '.')

if '.' in fullname:

langname, encoding = fullname.split('.')[:2]

fullname = langname + '.' + encoding

else:

langname = fullname

encoding = ''

# First lookup: fullname (possibly with encoding)

norm_encoding = encoding.replace('-', '')

norm_encoding = norm_encoding.replace('_', '')

lookup_name = langname + '.' + encoding

code = locale_alias.get(lookup_name, None)

if code is not None:

return code

#print 'first lookup failed'

# Second try: langname (without encoding)

code = locale_alias.get(langname, None)

if code is not None:

#print 'langname lookup succeeded'

if '.' in code:

langname, defenc = code.split('.')

else:

langname = code

defenc = ''

if encoding:

# Convert the encoding to a C lib compatible encoding string

norm_encoding = encodings.normalize_encoding(encoding)

#print 'norm encoding: %r' % norm_encoding

norm_encoding = encodings.aliases.aliases.get(norm_encoding,

norm_encoding)

#print 'aliased encoding: %r' % norm_encoding

encoding = locale_encoding_alias.get(norm_encoding,

norm_encoding)

else:

encoding = defenc

#print 'found encoding %r' % encoding

if encoding:

return langname + '.' + encoding

else:

return langname

else:

return localename

def _parse_localename(localename):

""" Parses the locale code for localename and returns the

result as tuple (language code, encoding).

The localename is normalized and passed through the locale

alias engine. A ValueError is raised in case the locale name

cannot be parsed.

The language code corresponds to RFC 1766. code and encoding

can be None in case the values cannot be determined or are

unknown to this implementation.

"""

code = normalize(localename)

if '@' in code:

# Deal with locale modifiers

code, modifier = code.split('@')

if modifier == 'euro' and '.' not in code:

# Assume Latin-9 for @euro locales. This is bogus,

# since some systems may use other encodings for these

# locales. Also, we ignore other modifiers.

return code, 'iso-8859-15'

if '.' in code:

return tuple(code.split('.')[:2])

elif code == 'C':

return None, None

raise ValueError('unknown locale: %s' % localename)

def _build_localename(localetuple):

""" Builds a locale code from the given tuple (language code,

encoding).

No aliasing or normalizing takes place.

"""

language, encoding = localetuple

if language is None:

language = 'C'

if encoding is None:

return language

else:

return language + '.' + encoding

def getdefaultlocale(envvars=('LC_ALL', 'LC_CTYPE', 'LANG', 'LANGUAGE')):

""" Tries to determine the default locale settings and returns

them as tuple (language code, encoding).

According to POSIX, a program which has not called

setlocale(LC_ALL, "") runs using the portable 'C' locale.

Calling setlocale(LC_ALL, "") lets it use the default locale as

defined by the LANG variable. Since we don't want to interfere

with the current locale setting we thus emulate the behavior

in the way described above.

To maintain compatibility with other platforms, not only the

LANG variable is tested, but a list of variables given as

envvars parameter. The first found to be defined will be

used. envvars defaults to the search path used in GNU gettext;

it must always contain the variable name 'LANG'.

Except for the code 'C', the language code corresponds to RFC

1766. code and encoding can be None in case the values cannot

be determined.

"""

try:

# check if it's supported by the _locale module

import _locale

code, encoding = _locale._getdefaultlocale()

except (ImportError, AttributeError):

pass

else:

# make sure the code/encoding values are valid

if sys.platform == "win32" and code and code[:2] == "0x":

# map windows language identifier to language name

code = windows_locale.get(int(code, 0))

# ...add other platform-specific processing here, if

# necessary...

return code, encoding

# fall back on POSIX behaviour

import os

lookup = os.environ.get

for variable in envvars:

localename = lookup(variable,None)

if localename:

if variable == 'LANGUAGE':

localename = localename.split(':')[0]

break

else:

localename = 'C'

return _parse_localename(localename)

def getlocale(category=LC_CTYPE):

""" Returns the current setting for the given locale category as

tuple (language code, encoding).

category may be one of the LC_* value except LC_ALL. It

defaults to LC_CTYPE.

Except for the code 'C', the language code corresponds to RFC

1766. code and encoding can be None in case the values cannot

be determined.

"""

localename = _setlocale(category)

if category == LC_ALL and ';' in localename:

raise TypeError('category LC_ALL is not supported')

return _parse_localename(localename)

def setlocale(category, locale=None):

""" Set the locale for the given category. The locale can be

a string, a locale tuple (language code, encoding), or None.

Locale tuples are converted to strings the locale aliasing

engine. Locale strings are passed directly to the C lib.

category may be given as one of the LC_* values.

"""

if locale and not isinstance(locale, _builtin_str):

# convert to string

locale = normalize(_build_localename(locale))

return _setlocale(category, locale)

def resetlocale(category=LC_ALL):

""" Sets the locale for category to the default setting.

The default setting is determined by calling

getdefaultlocale(). category defaults to LC_ALL.

"""

_setlocale(category, _build_localename(getdefaultlocale()))

if sys.platform in ('win32', 'darwin', 'mac'):

# On Win32, this will return the ANSI code page

# On the Mac, it should return the system encoding;

# it might return "ascii" instead

def getpreferredencoding(do_setlocale = True):

"""Return the charset that the user is likely using."""

import _locale

return _locale._getdefaultlocale()[1]

else:

# On Unix, if CODESET is available, use that.

try:

CODESET

except NameError:

# Fall back to parsing environment variables :-(

def getpreferredencoding(do_setlocale = True):

"""Return the charset that the user is likely using,

by looking at environment variables."""

res = getdefaultlocale()[1]

if res is None:

# LANG not set, default conservatively to ASCII

res = 'ascii'

return res

else:

def getpreferredencoding(do_setlocale = True):

"""Return the charset that the user is likely using,

according to the system configuration."""

if do_setlocale:

oldloc = setlocale(LC_CTYPE)

setlocale(LC_CTYPE, "")

result = nl_langinfo(CODESET)

setlocale(LC_CTYPE, oldloc)

return result

else:

return nl_langinfo(CODESET)

### Database

#

# The following data was extracted from the locale.alias file which

# comes with X11 and then hand edited removing the explicit encoding

# definitions and adding some more aliases. The file is usually

# available as /usr/lib/X11/locale/locale.alias.

#

#

# The local_encoding_alias table maps lowercase encoding alias names

# to C locale encoding names (case-sensitive). Note that normalize()

# first looks up the encoding in the encodings.aliases dictionary and

# then applies this mapping to find the correct C lib name for the

# encoding.

#

locale_encoding_alias = {

# Mappings for non-standard encoding names used in locale names

'437': 'C',

'c': 'C',

'en': 'ISO8859-1',

'jis': 'JIS7',

'jis7': 'JIS7',

'ajec': 'eucJP',

# Mappings from Python codec names to C lib encoding names

'ascii': 'ISO8859-1',

'latin_1': 'ISO8859-1',

'iso8859_1': 'ISO8859-1',

'iso8859_10': 'ISO8859-10',

'iso8859_11': 'ISO8859-11',

'iso8859_13': 'ISO8859-13',

'iso8859_14': 'ISO8859-14',

'iso8859_15': 'ISO8859-15',

'iso8859_2': 'ISO8859-2',

'iso8859_3': 'ISO8859-3',

'iso8859_4': 'ISO8859-4',

'iso8859_5': 'ISO8859-5',

'iso8859_6': 'ISO8859-6',

'iso8859_7': 'ISO8859-7',

'iso8859_8': 'ISO8859-8',

'iso8859_9': 'ISO8859-9',

'iso2022_jp': 'JIS7',

'shift_jis': 'SJIS',

'tactis': 'TACTIS',

'euc_jp': 'eucJP',

'euc_kr': 'eucKR',

'utf_8': 'UTF8',

'koi8_r': 'KOI8-R',

'koi8_u': 'KOI8-U',

# XXX This list is still incomplete. If you know more

# mappings, please file a bug report. Thanks.

}

#

# The locale_alias table maps lowercase alias names to C locale names

# (case-sensitive). Encodings are always separated from the locale

# name using a dot ('.'); they should only be given in case the

# language name is needed to interpret the given encoding alias

# correctly (CJK codes often have this need).

#

# Note that the normalize() function which uses this tables

# removes '_' and '-' characters from the encoding part of the

# locale name before doing the lookup. This saves a lot of

# space in the table.

#

# MAL 2004-12-10:

# Updated alias mapping to most recent locale.alias file

# from X.org distribution using makelocalealias.py.

#

# These are the differences compared to the old mapping (Python 2.4

# and older):

#

# updated 'bg' -> 'bg_BG.ISO8859-5' to 'bg_BG.CP1251'

# updated 'bg_bg' -> 'bg_BG.ISO8859-5' to 'bg_BG.CP1251'

# updated 'bulgarian' -> 'bg_BG.ISO8859-5' to 'bg_BG.CP1251'

# updated 'cz' -> 'cz_CZ.ISO8859-2' to 'cs_CZ.ISO8859-2'

# updated 'cz_cz' -> 'cz_CZ.ISO8859-2' to 'cs_CZ.ISO8859-2'

# updated 'czech' -> 'cs_CS.ISO8859-2' to 'cs_CZ.ISO8859-2'

# updated 'dutch' -> 'nl_BE.ISO8859-1' to 'nl_NL.ISO8859-1'

# updated 'et' -> 'et_EE.ISO8859-4' to 'et_EE.ISO8859-15'

# updated 'et_ee' -> 'et_EE.ISO8859-4' to 'et_EE.ISO8859-15'

# updated 'fi' -> 'fi_FI.ISO8859-1' to 'fi_FI.ISO8859-15'

# updated 'fi_fi' -> 'fi_FI.ISO8859-1' to 'fi_FI.ISO8859-15'

# updated 'iw' -> 'iw_IL.ISO8859-8' to 'he_IL.ISO8859-8'

# updated 'iw_il' -> 'iw_IL.ISO8859-8' to 'he_IL.ISO8859-8'

# updated 'japanese' -> 'ja_JP.SJIS' to 'ja_JP.eucJP'

# updated 'lt' -> 'lt_LT.ISO8859-4' to 'lt_LT.ISO8859-13'

# updated 'lv' -> 'lv_LV.ISO8859-4' to 'lv_LV.ISO8859-13'

# updated 'sl' -> 'sl_CS.ISO8859-2' to 'sl_SI.ISO8859-2'

# updated 'slovene' -> 'sl_CS.ISO8859-2' to 'sl_SI.ISO8859-2'

# updated 'th_th' -> 'th_TH.TACTIS' to 'th_TH.ISO8859-11'

# updated 'zh_cn' -> 'zh_CN.eucCN' to 'zh_CN.gb2312'

# updated 'zh_cn.big5' -> 'zh_TW.eucTW' to 'zh_TW.big5'

# updated 'zh_tw' -> 'zh_TW.eucTW' to 'zh_TW.big5'

#

# MAL 2008-05-30:

# Updated alias mapping to most recent locale.alias file

# from X.org distribution using makelocalealias.py.

#

# These are the differences compared to the old mapping (Python 2.5

# and older):

#

# updated 'cs_cs.iso88592' -> 'cs_CZ.ISO8859-2' to 'cs_CS.ISO8859-2'

# updated 'serbocroatian' -> 'sh_YU.ISO8859-2' to 'sr_CS.ISO8859-2'

# updated 'sh' -> 'sh_YU.ISO8859-2' to 'sr_CS.ISO8859-2'

# updated 'sh_hr.iso88592' -> 'sh_HR.ISO8859-2' to 'hr_HR.ISO8859-2'

# updated 'sh_sp' -> 'sh_YU.ISO8859-2' to 'sr_CS.ISO8859-2'

# updated 'sh_yu' -> 'sh_YU.ISO8859-2' to 'sr_CS.ISO8859-2'

# updated 'sp' -> 'sp_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sp_yu' -> 'sp_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sr' -> 'sr_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sr@cyrillic' -> 'sr_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sr_sp' -> 'sr_SP.ISO8859-2' to 'sr_CS.ISO8859-2'

# updated 'sr_yu' -> 'sr_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sr_yu.cp1251@cyrillic' -> 'sr_YU.CP1251' to 'sr_CS.CP1251'

# updated 'sr_yu.iso88592' -> 'sr_YU.ISO8859-2' to 'sr_CS.ISO8859-2'

# updated 'sr_yu.iso88595' -> 'sr_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sr_yu.iso88595@cyrillic' -> 'sr_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

# updated 'sr_yu.microsoftcp1251@cyrillic' -> 'sr_YU.CP1251' to 'sr_CS.CP1251'

# updated 'sr_yu.utf8@cyrillic' -> 'sr_YU.UTF-8' to 'sr_CS.UTF-8'

# updated 'sr_yu@cyrillic' -> 'sr_YU.ISO8859-5' to 'sr_CS.ISO8859-5'

locale_alias = {

'a3': 'a3_AZ.KOI8-C',

'a3_az': 'a3_AZ.KOI8-C',

'a3_az.koi8c': 'a3_AZ.KOI8-C',

'af': 'af_ZA.ISO8859-1',

'af_za': 'af_ZA.ISO8859-1',

'af_za.iso88591': 'af_ZA.ISO8859-1',

'am': 'am_ET.UTF-8',

'am_et': 'am_ET.UTF-8',

'american': 'en_US.ISO8859-1',

'american.iso88591': 'en_US.ISO8859-1',

'ar': 'ar_AA.ISO8859-6',

'ar_aa': 'ar_AA.ISO8859-6',

'ar_aa.iso88596': 'ar_AA.ISO8859-6',

'ar_ae': 'ar_AE.ISO8859-6',

'ar_ae.iso88596': 'ar_AE.ISO8859-6',

'ar_bh': 'ar_BH.ISO8859-6',

'ar_bh.iso88596': 'ar_BH.ISO8859-6',

'ar_dz': 'ar_DZ.ISO8859-6',

'ar_dz.iso88596': 'ar_DZ.ISO8859-6',

'ar_eg': 'ar_EG.ISO8859-6',

'ar_eg.iso88596': 'ar_EG.ISO8859-6',

'ar_iq': 'ar_IQ.ISO8859-6',

'ar_iq.iso88596': 'ar_IQ.ISO8859-6',

'ar_jo': 'ar_JO.ISO8859-6',

'ar_jo.iso88596': 'ar_JO.ISO8859-6',

'ar_kw': 'ar_KW.ISO8859-6',

'ar_kw.iso88596': 'ar_KW.ISO8859-6',

'ar_lb': 'ar_LB.ISO8859-6',

'ar_lb.iso88596': 'ar_LB.ISO8859-6',

'ar_ly': 'ar_LY.ISO8859-6',

'ar_ly.iso88596': 'ar_LY.ISO8859-6',

'ar_ma': 'ar_MA.ISO8859-6',

'ar_ma.iso88596': 'ar_MA.ISO8859-6',

'ar_om': 'ar_OM.ISO8859-6',

'ar_om.iso88596': 'ar_OM.ISO8859-6',

'ar_qa': 'ar_QA.ISO8859-6',

'ar_qa.iso88596': 'ar_QA.ISO8859-6',

'ar_sa': 'ar_SA.ISO8859-6',

'ar_sa.iso88596': 'ar_SA.ISO8859-6',

'ar_sd': 'ar_SD.ISO8859-6',

'ar_sd.iso88596': 'ar_SD.ISO8859-6',

'ar_sy': 'ar_SY.ISO8859-6',

'ar_sy.iso88596': 'ar_SY.ISO8859-6',

'ar_tn': 'ar_TN.ISO8859-6',

'ar_tn.iso88596': 'ar_TN.ISO8859-6',

'ar_ye': 'ar_YE.ISO8859-6',

'ar_ye.iso88596': 'ar_YE.ISO8859-6',

'arabic': 'ar_AA.ISO8859-6',

'arabic.iso88596': 'ar_AA.ISO8859-6',

'az': 'az_AZ.ISO8859-9E',

'az_az': 'az_AZ.ISO8859-9E',

'az_az.iso88599e': 'az_AZ.ISO8859-9E',

'be': 'be_BY.CP1251',

'be_by': 'be_BY.CP1251',

'be_by.cp1251': 'be_BY.CP1251',

'be_by.microsoftcp1251': 'be_BY.CP1251',

'bg': 'bg_BG.CP1251',

'bg_bg': 'bg_BG.CP1251',

'bg_bg.cp1251': 'bg_BG.CP1251',

'bg_bg.iso88595': 'bg_BG.ISO8859-5',

'bg_bg.koi8r': 'bg_BG.KOI8-R',

'bg_bg.microsoftcp1251': 'bg_BG.CP1251',

'bn_in': 'bn_IN.UTF-8',

'bokmal': 'nb_NO.ISO8859-1',

'bokm\xe5l': 'nb_NO.ISO8859-1',

'br': 'br_FR.ISO8859-1',

'br_fr': 'br_FR.ISO8859-1',

'br_fr.iso88591': 'br_FR.ISO8859-1',

'br_fr.iso885914': 'br_FR.ISO8859-14',

'br_fr.iso885915': 'br_FR.ISO8859-15',

'br_fr.iso885915@euro': 'br_FR.ISO8859-15',

'br_fr.utf8@euro': 'br_FR.UTF-8',

'br_fr@euro': 'br_FR.ISO8859-15',

'bs': 'bs_BA.ISO8859-2',

'bs_ba': 'bs_BA.ISO8859-2',

'bs_ba.iso88592': 'bs_BA.ISO8859-2',

'bulgarian': 'bg_BG.CP1251',

'c': 'C',

'c-french': 'fr_CA.ISO8859-1',

'c-french.iso88591': 'fr_CA.ISO8859-1',

'c.en': 'C',

'c.iso88591': 'en_US.ISO8859-1',

'c_c': 'C',

'c_c.c': 'C',

'ca': 'ca_ES.ISO8859-1',

'ca_es': 'ca_ES.ISO8859-1',

'ca_es.iso88591': 'ca_ES.ISO8859-1',

'ca_es.iso885915': 'ca_ES.ISO8859-15',

'ca_es.iso885915@euro': 'ca_ES.ISO8859-15',

'ca_es.utf8@euro': 'ca_ES.UTF-8',

'ca_es@euro': 'ca_ES.ISO8859-15',

'catalan': 'ca_ES.ISO8859-1',

'cextend': 'en_US.ISO8859-1',

'cextend.en': 'en_US.ISO8859-1',

'chinese-s': 'zh_CN.eucCN',

'chinese-t': 'zh_TW.eucTW',

'croatian': 'hr_HR.ISO8859-2',

'cs': 'cs_CZ.ISO8859-2',

'cs_cs': 'cs_CZ.ISO8859-2',

'cs_cs.iso88592': 'cs_CS.ISO8859-2',

'cs_cz': 'cs_CZ.ISO8859-2',

'cs_cz.iso88592': 'cs_CZ.ISO8859-2',

'cy': 'cy_GB.ISO8859-1',

'cy_gb': 'cy_GB.ISO8859-1',

'cy_gb.iso88591': 'cy_GB.ISO8859-1',

'cy_gb.iso885914': 'cy_GB.ISO8859-14',

'cy_gb.iso885915': 'cy_GB.ISO8859-15',

'cy_gb@euro': 'cy_GB.ISO8859-15',

'cz': 'cs_CZ.ISO8859-2',

'cz_cz': 'cs_CZ.ISO8859-2',

'czech': 'cs_CZ.ISO8859-2',

'da': 'da_DK.ISO8859-1',

'da_dk': 'da_DK.ISO8859-1',

'da_dk.88591': 'da_DK.ISO8859-1',

'da_dk.885915': 'da_DK.ISO8859-15',

'da_dk.iso88591': 'da_DK.ISO8859-1',

'da_dk.iso885915': 'da_DK.ISO8859-15',

'da_dk@euro': 'da_DK.ISO8859-15',

'danish': 'da_DK.ISO8859-1',

'danish.iso88591': 'da_DK.ISO8859-1',

'dansk': 'da_DK.ISO8859-1',

'de': 'de_DE.ISO8859-1',

'de_at': 'de_AT.ISO8859-1',

'de_at.iso88591': 'de_AT.ISO8859-1',

'de_at.iso885915': 'de_AT.ISO8859-15',

'de_at.iso885915@euro': 'de_AT.ISO8859-15',

'de_at.utf8@euro': 'de_AT.UTF-8',

'de_at@euro': 'de_AT.ISO8859-15',

'de_be': 'de_BE.ISO8859-1',

'de_be.iso88591': 'de_BE.ISO8859-1',

'de_be.iso885915': 'de_BE.ISO8859-15',

'de_be.iso885915@euro': 'de_BE.ISO8859-15',

'de_be.utf8@euro': 'de_BE.UTF-8',

'de_be@euro': 'de_BE.ISO8859-15',

'de_ch': 'de_CH.ISO8859-1',

'de_ch.iso88591': 'de_CH.ISO8859-1',

'de_ch.iso885915': 'de_CH.ISO8859-15',

'de_ch@euro': 'de_CH.ISO8859-15',

'de_de': 'de_DE.ISO8859-1',

'de_de.88591': 'de_DE.ISO8859-1',

'de_de.885915': 'de_DE.ISO8859-15',

'de_de.885915@euro': 'de_DE.ISO8859-15',

'de_de.iso88591': 'de_DE.ISO8859-1',

'de_de.iso885915': 'de_DE.ISO8859-15',

'de_de.iso885915@euro': 'de_DE.ISO8859-15',

'de_de.utf8@euro': 'de_DE.UTF-8',

'de_de@euro': 'de_DE.ISO8859-15',

'de_lu': 'de_LU.ISO8859-1',

'de_lu.iso88591': 'de_LU.ISO8859-1',

'de_lu.iso885915': 'de_LU.ISO8859-15',

'de_lu.iso885915@euro': 'de_LU.ISO8859-15',

'de_lu.utf8@euro': 'de_LU.UTF-8',

'de_lu@euro': 'de_LU.ISO8859-15',

'deutsch': 'de_DE.ISO8859-1',

'dutch': 'nl_NL.ISO8859-1',

'dutch.iso88591': 'nl_BE.ISO8859-1',

'ee': 'ee_EE.ISO8859-4',

'ee_ee': 'ee_EE.ISO8859-4',

'ee_ee.iso88594': 'ee_EE.ISO8859-4',

'eesti': 'et_EE.ISO8859-1',

'el': 'el_GR.ISO8859-7',

'el_gr': 'el_GR.ISO8859-7',

'el_gr.iso88597': 'el_GR.ISO8859-7',

'el_gr@euro': 'el_GR.ISO8859-15',

'en': 'en_US.ISO8859-1',

'en.iso88591': 'en_US.ISO8859-1',

'en_au': 'en_AU.ISO8859-1',

'en_au.iso88591': 'en_AU.ISO8859-1',

'en_be': 'en_BE.ISO8859-1',

'en_be@euro': 'en_BE.ISO8859-15',

'en_bw': 'en_BW.ISO8859-1',

'en_bw.iso88591': 'en_BW.ISO8859-1',

'en_ca': 'en_CA.ISO8859-1',

'en_ca.iso88591': 'en_CA.ISO8859-1',

'en_gb': 'en_GB.ISO8859-1',

'en_gb.88591': 'en_GB.ISO8859-1',

'en_gb.iso88591': 'en_GB.ISO8859-1',

'en_gb.iso885915': 'en_GB.ISO8859-15',

'en_gb@euro': 'en_GB.ISO8859-15',

'en_hk': 'en_HK.ISO8859-1',

'en_hk.iso88591': 'en_HK.ISO8859-1',

'en_ie': 'en_IE.ISO8859-1',

'en_ie.iso88591': 'en_IE.ISO8859-1',

'en_ie.iso885915': 'en_IE.ISO8859-15',

'en_ie.iso885915@euro': 'en_IE.ISO8859-15',

'en_ie.utf8@euro': 'en_IE.UTF-8',

'en_ie@euro': 'en_IE.ISO8859-15',

'en_in': 'en_IN.ISO8859-1',

'en_nz': 'en_NZ.ISO8859-1',

'en_nz.iso88591': 'en_NZ.ISO8859-1',

'en_ph': 'en_PH.ISO8859-1',

'en_ph.iso88591': 'en_PH.ISO8859-1',

'en_sg': 'en_SG.ISO8859-1',

'en_sg.iso88591': 'en_SG.ISO8859-1',

'en_uk': 'en_GB.ISO8859-1',

'en_us': 'en_US.ISO8859-1',

'en_us.88591': 'en_US.ISO8859-1',

'en_us.885915': 'en_US.ISO8859-15',

'en_us.iso88591': 'en_US.ISO8859-1',

'en_us.iso885915': 'en_US.ISO8859-15',

'en_us.iso885915@euro': 'en_US.ISO8859-15',

'en_us@euro': 'en_US.ISO8859-15',

'en_us@euro@euro': 'en_US.ISO8859-15',

'en_za': 'en_ZA.ISO8859-1',

'en_za.88591': 'en_ZA.ISO8859-1',

'en_za.iso88591': 'en_ZA.ISO8859-1',

'en_za.iso885915': 'en_ZA.ISO8859-15',

'en_za@euro': 'en_ZA.ISO8859-15',

'en_zw': 'en_ZW.ISO8859-1',

'en_zw.iso88591': 'en_ZW.ISO8859-1',

'eng_gb': 'en_GB.ISO8859-1',

'eng_gb.8859': 'en_GB.ISO8859-1',

'english': 'en_EN.ISO8859-1',

'english.iso88591': 'en_EN.ISO8859-1',

'english_uk': 'en_GB.ISO8859-1',

'english_uk.8859': 'en_GB.ISO8859-1',

'english_united-states': 'en_US.ISO8859-1',

'english_united-states.437': 'C',

'english_us': 'en_US.ISO8859-1',

'english_us.8859': 'en_US.ISO8859-1',

'english_us.ascii': 'en_US.ISO8859-1',

'eo': 'eo_XX.ISO8859-3',

'eo_eo': 'eo_EO.ISO8859-3',

'eo_eo.iso88593': 'eo_EO.ISO8859-3',

'eo_xx': 'eo_XX.ISO8859-3',

'eo_xx.iso88593': 'eo_XX.ISO8859-3',

'es': 'es_ES.ISO8859-1',

'es_ar': 'es_AR.ISO8859-1',

'es_ar.iso88591': 'es_AR.ISO8859-1',

'es_bo': 'es_BO.ISO8859-1',

'es_bo.iso88591': 'es_BO.ISO8859-1',

'es_cl': 'es_CL.ISO8859-1',

'es_cl.iso88591': 'es_CL.ISO8859-1',

'es_co': 'es_CO.ISO8859-1',

'es_co.iso88591': 'es_CO.ISO8859-1',

'es_cr': 'es_CR.ISO8859-1',

'es_cr.iso88591': 'es_CR.ISO8859-1',

'es_do': 'es_DO.ISO8859-1',

'es_do.iso88591': 'es_DO.ISO8859-1',

'es_ec': 'es_EC.ISO8859-1',

'es_ec.iso88591': 'es_EC.ISO8859-1',

'es_es': 'es_ES.ISO8859-1',

'es_es.88591': 'es_ES.ISO8859-1',

'es_es.iso88591': 'es_ES.ISO8859-1',

'es_es.iso885915': 'es_ES.ISO8859-15',

'es_es.iso885915@euro': 'es_ES.ISO8859-15',

'es_es.utf8@euro': 'es_ES.UTF-8',

'es_es@euro': 'es_ES.ISO8859-15',

'es_gt': 'es_GT.ISO8859-1',

'es_gt.iso88591': 'es_GT.ISO8859-1',

'es_hn': 'es_HN.ISO8859-1',

'es_hn.iso88591': 'es_HN.ISO8859-1',

'es_mx': 'es_MX.ISO8859-1',

'es_mx.iso88591': 'es_MX.ISO8859-1',

'es_ni': 'es_NI.ISO8859-1',

'es_ni.iso88591': 'es_NI.ISO8859-1',

'es_pa': 'es_PA.ISO8859-1',

'es_pa.iso88591': 'es_PA.ISO8859-1',

'es_pa.iso885915': 'es_PA.ISO8859-15',

'es_pa@euro': 'es_PA.ISO8859-15',

'es_pe': 'es_PE.ISO8859-1',

'es_pe.iso88591': 'es_PE.ISO8859-1',

'es_pe.iso885915': 'es_PE.ISO8859-15',

'es_pe@euro': 'es_PE.ISO8859-15',

'es_pr': 'es_PR.ISO8859-1',

'es_pr.iso88591': 'es_PR.ISO8859-1',

'es_py': 'es_PY.ISO8859-1',

'es_py.iso88591': 'es_PY.ISO8859-1',

'es_py.iso885915': 'es_PY.ISO8859-15',

'es_py@euro': 'es_PY.ISO8859-15',

'es_sv': 'es_SV.ISO8859-1',

'es_sv.iso88591': 'es_SV.ISO8859-1',

'es_sv.iso885915': 'es_SV.ISO8859-15',

'es_sv@euro': 'es_SV.ISO8859-15',

'es_us': 'es_US.ISO8859-1',

'es_us.iso88591': 'es_US.ISO8859-1',

'es_uy': 'es_UY.ISO8859-1',

'es_uy.iso88591': 'es_UY.ISO8859-1',

'es_uy.iso885915': 'es_UY.ISO8859-15',

'es_uy@euro': 'es_UY.ISO8859-15',

'es_ve': 'es_VE.ISO8859-1',

'es_ve.iso88591': 'es_VE.ISO8859-1',

'es_ve.iso885915': 'es_VE.ISO8859-15',

'es_ve@euro': 'es_VE.ISO8859-15',

'estonian': 'et_EE.ISO8859-1',

'et': 'et_EE.ISO8859-15',

'et_ee': 'et_EE.ISO8859-15',

'et_ee.iso88591': 'et_EE.ISO8859-1',

'et_ee.iso885913': 'et_EE.ISO8859-13',

'et_ee.iso885915': 'et_EE.ISO8859-15',

'et_ee.iso88594': 'et_EE.ISO8859-4',

'et_ee@euro': 'et_EE.ISO8859-15',

'eu': 'eu_ES.ISO8859-1',

'eu_es': 'eu_ES.ISO8859-1',

'eu_es.iso88591': 'eu_ES.ISO8859-1',

'eu_es.iso885915': 'eu_ES.ISO8859-15',

'eu_es.iso885915@euro': 'eu_ES.ISO8859-15',

'eu_es.utf8@euro': 'eu_ES.UTF-8',

'eu_es@euro': 'eu_ES.ISO8859-15',

'fa': 'fa_IR.UTF-8',

'fa_ir': 'fa_IR.UTF-8',

'fa_ir.isiri3342': 'fa_IR.ISIRI-3342',

'fi': 'fi_FI.ISO8859-15',

'fi_fi': 'fi_FI.ISO8859-15',

'fi_fi.88591': 'fi_FI.ISO8859-1',

'fi_fi.iso88591': 'fi_FI.ISO8859-1',

'fi_fi.iso885915': 'fi_FI.ISO8859-15',

'fi_fi.iso885915@euro': 'fi_FI.ISO8859-15',

'fi_fi.utf8@euro': 'fi_FI.UTF-8',

'fi_fi@euro': 'fi_FI.ISO8859-15',

'finnish': 'fi_FI.ISO8859-1',

'finnish.iso88591': 'fi_FI.ISO8859-1',

'fo': 'fo_FO.ISO8859-1',

'fo_fo': 'fo_FO.ISO8859-1',

'fo_fo.iso88591': 'fo_FO.ISO8859-1',

'fo_fo.iso885915': 'fo_FO.ISO8859-15',

'fo_fo@euro': 'fo_FO.ISO8859-15',

'fr': 'fr_FR.ISO8859-1',

'fr_be': 'fr_BE.ISO8859-1',

'fr_be.88591': 'fr_BE.ISO8859-1',

'fr_be.iso88591': 'fr_BE.ISO8859-1',

'fr_be.iso885915': 'fr_BE.ISO8859-15',

'fr_be.iso885915@euro': 'fr_BE.ISO8859-15',

'fr_be.utf8@euro': 'fr_BE.UTF-8',

'fr_be@euro': 'fr_BE.ISO8859-15',

'fr_ca': 'fr_CA.ISO8859-1',

'fr_ca.88591': 'fr_CA.ISO8859-1',

'fr_ca.iso88591': 'fr_CA.ISO8859-1',