babel/old/babel-test: babel/core.py annotate

annotate babel/core.py @ 41:e967fbafcda1

Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed.

author	cmlenz
date	Wed, 06 Jun 2007 12:12:44 +0000
parents	3b314a78015d
children	83f3f70c6ca3

rev	line source
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	1 # -- coding: utf-8 --
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	2 #
12 a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	3 # Copyright (C) 2007 Edgewall Software
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	4 # All rights reserved.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	5 #
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	6 # This software is licensed as described in the file COPYING, which
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	7 # you should have received as part of this distribution. The terms
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	8 # are also available at http://babel.edgewall.org/wiki/License.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	9 #
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	10 # This software consists of voluntary contributions made by many
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	11 # individuals. For the exact contribution history, see the revision
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	12 # history and logs, available at http://babel.edgewall.org/log/.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	13
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	14 """Core locale representation and locale data access gateway."""
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	15
39 3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	16 import os
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	17
26 710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	18 from babel import localedata
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	19
39 3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	20 __all__ = ['UnknownLocaleError', 'Locale', 'getdefault', 'negotiate', 'parse']
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	21 __docformat__ = 'restructuredtext en'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	22
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	23
31 b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	24 class UnknownLocaleError(Exception):
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	25 """Exception thrown when a locale is requested for which no locale data
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	26 is available.
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	27 """
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	28
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	29 def __init__(self, identifier):
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	30 """Create the exception.
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	31
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	32 :param identifier: the identifier string of the unsupported locale
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	33 """
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	34 Exception.__init__(self, 'unknown locale %r' % identifier)
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	35 self.identifier = identifier
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	36
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	37
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	38 class Locale(object):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	39 """Representation of a specific locale.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	40
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	41 >>> locale = Locale('en', territory='US')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	42 >>> repr(locale)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	43 '<Locale "en_US">'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	44 >>> locale.display_name
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	45 u'English (United States)'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	46
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	47 A `Locale` object can also be instantiated from a raw locale string:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	48
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	49 >>> locale = Locale.parse('en-US', sep='-')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	50 >>> repr(locale)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	51 '<Locale "en_US">'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	52
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	53 `Locale` objects provide access to a collection of locale data, such as
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	54 territory and language names, number and date format patterns, and more:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	55
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	56 >>> locale.number_symbols['decimal']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	57 u'.'
31 b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	58
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	59 If a locale is requested for which no locale data is available, an
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	60 `UnknownLocaleError` is raised:
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	61
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	62 >>> Locale.parse('en_DE')
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	63 Traceback (most recent call last):
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	64 ...
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	65 UnknownLocaleError: unknown locale 'en_DE'
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	66
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	67 :see: `IETF RFC 3066 <http://www.ietf.org/rfc/rfc3066.txt>`_
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	68 """
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	69
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	70 def __init__(self, language, territory=None, variant=None):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	71 """Initialize the locale object from the given identifier components.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	72
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	73 >>> locale = Locale('en', 'US')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	74 >>> locale.language
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	75 'en'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	76 >>> locale.territory
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	77 'US'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	78
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	79 :param language: the language code
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	80 :param territory: the territory (country or region) code
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	81 :param variant: the variant code
31 b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	82 :raise `UnknownLocaleError`: if no locale data is available for the
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	83 requested locale
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	84 """
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	85 self.language = language
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	86 self.territory = territory
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	87 self.variant = variant
41 e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	88 self.__data = None
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	89
31 b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	90 identifier = str(self)
41 e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	91 if not localedata.exists(identifier):
31 b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	92 raise UnknownLocaleError(identifier)
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	93
39 3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	94 def default(cls, category=None):
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	95 """Return the system default locale for the specified category.
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	96
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	97 >>> for name in ['LANGUAGE', 'LC_ALL', 'LC_CTYPE']:
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	98 ... os.environ[name] = ''
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	99 >>> os.environ['LANG'] = 'fr_FR.UTF-8'
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	100 >>> Locale.default('LC_MESSAGES')
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	101 <Locale "fr_FR">
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	102
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	103 :param category: one of the ``LC_XXX`` environment variable names
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	104 :return: the value of the variable, or any of the fallbacks
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	105 (``LANGUAGE``, ``LC_ALL``, ``LC_CTYPE``, and ``LANG``)
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	106 :rtype: `Locale`
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	107 """
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	108 return cls(getdefault(category))
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	109 default = classmethod(default)
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	110
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	111 def parse(cls, identifier, sep='_'):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	112 """Create a `Locale` instance for the given locale identifier.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	113
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	114 >>> l = Locale.parse('de-DE', sep='-')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	115 >>> l.display_name
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	116 u'Deutsch (Deutschland)'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	117
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	118 If the `identifier` parameter is not a string, but actually a `Locale`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	119 object, that object is returned:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	120
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	121 >>> Locale.parse(l)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	122 <Locale "de_DE">
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	123
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	124 :param identifier: the locale identifier string
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	125 :param sep: optional component separator
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	126 :return: a corresponding `Locale` instance
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	127 :rtype: `Locale`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	128 :raise `ValueError`: if the string does not appear to be a valid locale
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	129 identifier
31 b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	130 :raise `UnknownLocaleError`: if no locale data is available for the
b6ff3e4b43e5 Raise error on unsupported locales. Closes #5. cmlenz parents: 28 diff changeset	131 requested locale
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	132 """
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	133 if type(identifier) is cls:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	134 return identifier
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	135 return cls(*parse(identifier, sep=sep))
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	136 parse = classmethod(parse)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	137
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	138 def __repr__(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	139 return '<Locale "%s">' % str(self)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	140
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	141 def __str__(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	142 return '_'.join(filter(None, [self.language, self.territory,
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	143 self.variant]))
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	144
41 e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	145 def _data(self):
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	146 if self.__data is None:
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	147 self.__data = localedata.load(str(self))
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	148 return self.__data
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	149 _data = property(_data)
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	150
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	151 def display_name(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	152 retval = self.languages.get(self.language)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	153 if self.territory:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	154 variant = ''
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	155 if self.variant:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	156 variant = ', %s' % self.variants.get(self.variant)
41 e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	157 retval += ' (%s%s)' % (self.territories.get(self.territory),
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	158 variant)
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	159 return retval
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	160 display_name = property(display_name, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	161 The localized display name of the locale.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	162
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	163 >>> Locale('en').display_name
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	164 u'English'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	165 >>> Locale('en', 'US').display_name
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	166 u'English (United States)'
41 e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	167 >>> Locale('sv').display_name
e967fbafcda1 Load locale data lazily to avoid penalizing usage of `Locale` objects when no locale data is actually needed. cmlenz parents: 39 diff changeset	168 u'svenska'
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	169
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	170 :type: `unicode`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	171 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	172
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	173 #{ General Locale Display Names
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	174
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	175 def languages(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	176 return self._data['languages']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	177 languages = property(languages, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	178 Mapping of language codes to translated language names.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	179
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	180 >>> Locale('de', 'DE').languages['ja']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	181 u'Japanisch'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	182
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	183 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	184 :see: `ISO 639 <http://www.loc.gov/standards/iso639-2/>`_
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	185 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	186
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	187 def scripts(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	188 return self._data['scripts']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	189 scripts = property(scripts, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	190 Mapping of script codes to translated script names.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	191
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	192 >>> Locale('en', 'US').scripts['Hira']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	193 u'Hiragana'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	194
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	195 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	196 :see: `ISO 15924 <http://www.evertype.com/standards/iso15924/>`_
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	197 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	198
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	199 def territories(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	200 return self._data['territories']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	201 territories = property(territories, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	202 Mapping of script codes to translated script names.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	203
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	204 >>> Locale('es', 'CO').territories['DE']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	205 u'Alemania'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	206
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	207 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	208 :see: `ISO 3166 <http://www.iso.org/iso/en/prods-services/iso3166ma/>`_
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	209 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	210
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	211 def variants(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	212 return self._data['variants']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	213 variants = property(variants, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	214 Mapping of script codes to translated script names.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	215
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	216 >>> Locale('de', 'DE').variants['1901']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	217 u'alte deutsche Rechtschreibung'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	218
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	219 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	220 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	221
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	222 #{ Number Formatting
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	223
26 710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	224 def currencies(self):
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	225 return self._data['currency_names']
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	226 currencies = property(currencies, doc="""\
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	227 Mapping of currency codes to translated currency names.
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	228
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	229 >>> Locale('en').currencies['COP']
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	230 u'Colombian Peso'
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	231 >>> Locale('de', 'DE').currencies['COP']
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	232 u'Kolumbianischer Peso'
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	233
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	234 :type: `dict`
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	235 """)
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	236
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	237 def currency_symbols(self):
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	238 return self._data['currency_symbols']
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	239 currency_symbols = property(currency_symbols, doc="""\
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	240 Mapping of currency codes to symbols.
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	241
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	242 >>> Locale('en').currency_symbols['USD']
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	243 u'US$'
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	244 >>> Locale('en', 'US').currency_symbols['USD']
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	245 u'$'
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	246
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	247 :type: `dict`
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	248 """)
710090104678 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime. cmlenz parents: 22 diff changeset	249
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	250 def number_symbols(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	251 return self._data['number_symbols']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	252 number_symbols = property(number_symbols, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	253 Symbols used in number formatting.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	254
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	255 >>> Locale('fr', 'FR').number_symbols['decimal']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	256 u','
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	257
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	258 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	259 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	260
12 a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	261 def decimal_formats(self):
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	262 return self._data['decimal_formats']
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	263 decimal_formats = property(decimal_formats, doc="""\
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	264 Locale patterns for decimal number formatting.
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	265
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	266 >>> Locale('en', 'US').decimal_formats[None]
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	267 <NumberPattern u'#,##0.###'>
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	268
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	269 :type: `dict`
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	270 """)
a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	271
22 7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	272 def percent_formats(self):
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	273 return self._data['percent_formats']
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	274 percent_formats = property(percent_formats, doc="""\
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	275 Locale patterns for percent number formatting.
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	276
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	277 >>> Locale('en', 'US').percent_formats[None]
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	278 <NumberPattern u'#,##0%'>
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	279
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	280 :type: `dict`
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	281 """)
7d37639a7411 Implemented babel.numbers.format_percent jonas parents: 15 diff changeset	282
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	283 #{ Calendar Information and Date Formatting
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	284
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	285 def periods(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	286 return self._data['periods']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	287 periods = property(periods, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	288 Locale display names for day periods (AM/PM).
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	289
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	290 >>> Locale('en', 'US').periods['am']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	291 u'AM'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	292
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	293 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	294 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	295
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	296 def days(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	297 return self._data['days']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	298 days = property(days, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	299 Locale display names for weekdays.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	300
15 76985c08a339 Minor date formatting improvements. cmlenz parents: 12 diff changeset	301 >>> Locale('de', 'DE').days['format']['wide'][3]
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	302 u'Donnerstag'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	303
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	304 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	305 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	306
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	307 def months(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	308 return self._data['months']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	309 months = property(months, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	310 Locale display names for months.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	311
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	312 >>> Locale('de', 'DE').months['format']['wide'][10]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	313 u'Oktober'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	314
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	315 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	316 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	317
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	318 def quarters(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	319 return self._data['quarters']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	320 quarters = property(quarters, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	321 Locale display names for quarters.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	322
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	323 >>> Locale('de', 'DE').quarters['format']['wide'][1]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	324 u'1. Quartal'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	325
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	326 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	327 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	328
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	329 def eras(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	330 return self._data['eras']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	331 eras = property(eras, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	332 Locale display names for eras.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	333
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	334 >>> Locale('en', 'US').eras['wide'][1]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	335 u'Anno Domini'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	336 >>> Locale('en', 'US').eras['abbreviated'][0]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	337 u'BC'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	338
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	339 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	340 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	341
28 11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	342 def time_zones(self):
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	343 return self._data['time_zones']
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	344 time_zones = property(time_zones, doc="""\
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	345 Locale display names for time zones.
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	346
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	347 >>> Locale('en', 'US').time_zones['America/Los_Angeles']['long']['standard']
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	348 u'Pacific Standard Time'
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	349 >>> Locale('en', 'US').time_zones['Europe/Dublin']['city']
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	350 u'Dublin'
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	351
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	352 :type: `dict`
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	353 """)
11278622ede9 Import basic timezone info from CLDR (see #3). Still missing a couple other pieces in the puzzle. cmlenz parents: 26 diff changeset	354
34 3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	355 def zone_aliases(self):
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	356 return self._data['zone_aliases']
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	357 zone_aliases = property(zone_aliases, doc="""\
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	358 Mapping of time zone aliases to their respective canonical identifer.
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	359
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	360 >>> Locale('en').zone_aliases['UTC']
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	361 'Etc/GMT'
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	362
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	363 :type: `dict`
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	364 :note: this doesn't really belong here, as it does not change between
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	365 locales
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	366 """)
3666f3d3df15 Extended time-zone support. cmlenz parents: 33 diff changeset	367
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	368 def first_week_day(self):
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	369 return self._data['week_data']['first_day']
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	370 first_week_day = property(first_week_day, doc="""\
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	371 The first day of a week.
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	372
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	373 >>> Locale('de', 'DE').first_week_day
15 76985c08a339 Minor date formatting improvements. cmlenz parents: 12 diff changeset	374 0
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	375 >>> Locale('en', 'US').first_week_day
15 76985c08a339 Minor date formatting improvements. cmlenz parents: 12 diff changeset	376 6
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	377
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	378 :type: `int`
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	379 """)
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	380
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	381 def weekend_start(self):
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	382 return self._data['week_data']['weekend_start']
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	383 weekend_start = property(weekend_start, doc="""\
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	384 The day the weekend starts.
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	385
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	386 >>> Locale('de', 'DE').weekend_start
15 76985c08a339 Minor date formatting improvements. cmlenz parents: 12 diff changeset	387 5
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	388
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	389 :type: `int`
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	390 """)
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	391
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	392 def weekend_end(self):
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	393 return self._data['week_data']['weekend_end']
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	394 weekend_end = property(weekend_end, doc="""\
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	395 The day the weekend ends.
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	396
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	397 >>> Locale('de', 'DE').weekend_end
15 76985c08a339 Minor date formatting improvements. cmlenz parents: 12 diff changeset	398 6
8 9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	399
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	400 :type: `int`
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	401 """)
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	402
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	403 def min_week_days(self):
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	404 return self._data['week_data']['min_days']
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	405 min_week_days = property(min_week_days, doc="""\
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	406 The minimum number of days in a week so that the week is counted as the
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	407 first week of a year or month.
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	408
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	409 >>> Locale('de', 'DE').min_week_days
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	410 4
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	411
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	412 :type: `int`
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	413 """)
9132c9218745 Pull in some supplemental data from the CLDR, for things like the first day of the week. cmlenz parents: 1 diff changeset	414
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	415 def date_formats(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	416 return self._data['date_formats']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	417 date_formats = property(date_formats, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	418 Locale patterns for date formatting.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	419
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	420 >>> Locale('en', 'US').date_formats['short']
12 a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	421 <DateTimePattern u'M/d/yy'>
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	422 >>> Locale('fr', 'FR').date_formats['long']
12 a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	423 <DateTimePattern u'd MMMM yyyy'>
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	424
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	425 :type: `dict`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	426 """)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	427
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	428 def time_formats(self):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	429 return self._data['time_formats']
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	430 time_formats = property(time_formats, doc="""\
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	431 Locale patterns for time formatting.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	432
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	433 >>> Locale('en', 'US').time_formats['short']
12 a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	434 <DateTimePattern u'h:mm a'>
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	435 >>> Locale('fr', 'FR').time_formats['long']
12 a2c54ef107c2 * Removed pkg_resources/setuptools requirement from various places. cmlenz parents: 9 diff changeset	436 <DateTimePattern u'HH:mm:ss z'>
9 3be73c6f01f1 Add basic support for number format patterns. jonas parents: 8 diff changeset	437
3be73c6f01f1 Add basic support for number format patterns. jonas parents: 8 diff changeset	438 :type: `dict`
3be73c6f01f1 Add basic support for number format patterns. jonas parents: 8 diff changeset	439 """)
3be73c6f01f1 Add basic support for number format patterns. jonas parents: 8 diff changeset	440
33 0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	441 def datetime_formats(self):
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	442 return self._data['datetime_formats']
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	443 datetime_formats = property(datetime_formats, doc="""\
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	444 Locale patterns for datetime formatting.
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	445
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	446 >>> Locale('en').datetime_formats[None]
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	447 u'{1} {0}'
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	448 >>> Locale('th').datetime_formats[None]
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	449 u'{1}, {0}'
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	450
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	451 :type: `dict`
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	452 """)
0740b6d31799 * Import datetime patterns from CLDR. cmlenz parents: 31 diff changeset	453
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	454
39 3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	455 def getdefault(category=None):
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	456 """Returns the system default locale for a given category, based on
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	457 environment variables.
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	458
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	459 >>> for name in ['LANGUAGE', 'LC_ALL', 'LC_CTYPE']:
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	460 ... os.environ[name] = ''
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	461 >>> os.environ['LANG'] = 'fr_FR.UTF-8'
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	462 >>> getdefault('LC_MESSAGES')
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	463 'fr_FR'
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	464
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	465 :param category: one of the ``LC_XXX`` environment variable names
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	466 :return: the value of the variable, or any of the fallbacks (``LANGUAGE``,
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	467 ``LC_ALL``, ``LC_CTYPE``, and ``LANG``)
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	468
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	469 :rtype: `str`
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	470 """
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	471 varnames = (category, 'LANGUAGE', 'LC_ALL', 'LC_CTYPE', 'LANG')
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	472 for name in filter(None, varnames):
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	473 locale = os.getenv(name)
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	474 if locale:
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	475 return '_'.join(filter(None, parse(locale)))
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	476
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	477 def negotiate(preferred, available):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	478 """Find the best match between available and requested locale strings.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	479
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	480 >>> negotiate(['de_DE', 'en_US'], ['de_DE', 'de_AT'])
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	481 'de_DE'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	482 >>> negotiate(['de_DE', 'en_US'], ['en', 'de'])
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	483 'de'
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	484
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	485 :param preferred: the list of locale strings preferred by the user
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	486 :param available: the list of locale strings available
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	487 :return: the locale identifier for the best match, or `None` if no match
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	488 was found
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	489 :rtype: `str`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	490 """
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	491 for locale in preferred:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	492 if locale in available:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	493 return locale
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	494 parts = locale.split('_')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	495 if len(parts) > 1 and parts[0] in available:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	496 return parts[0]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	497 return None
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	498
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	499 def parse(identifier, sep='_'):
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	500 """Parse a locale identifier into a ``(language, territory, variant)``
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	501 tuple.
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	502
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	503 >>> parse('zh_CN')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	504 ('zh', 'CN', None)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	505
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	506 The default component separator is "_", but a different separator can be
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	507 specified using the `sep` parameter:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	508
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	509 >>> parse('zh-CN', sep='-')
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	510 ('zh', 'CN', None)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	511
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	512 :param identifier: the locale identifier string
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	513 :param sep: character that separates the different parts of the locale
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	514 string
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	515 :return: the ``(language, territory, variant)`` tuple
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	516 :rtype: `tuple`
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	517 :raise `ValueError`: if the string does not appear to be a valid locale
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	518 identifier
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	519
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	520 :see: `IETF RFC 3066 <http://www.ietf.org/rfc/rfc3066.txt>`_
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	521 """
39 3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	522 if '.' in identifier:
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	523 # this is probably the charset/encoding, which we don't care about
3b314a78015d Move function for determining the system default locale to `babel.core`, and make it available as a class method on `Locale`. cmlenz parents: 34 diff changeset	524 identifier = identifier.split('.', 1)[0]
1 f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	525 parts = identifier.split(sep)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	526 lang, territory, variant = parts[0].lower(), None, None
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	527 if not lang.isalpha():
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	528 raise ValueError('expected only letters, got %r' % lang)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	529 if len(parts) > 1:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	530 territory = parts[1].upper().split('.', 1)[0]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	531 if not territory.isalpha():
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	532 raise ValueError('expected only letters, got %r' % territory)
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	533 if len(parts) > 2:
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	534 variant = parts[2].upper().split('.', 1)[0]
f71ca60f2a4a Import of initial code base. cmlenz parents: diff changeset	535 return lang, territory, variant

Mercurial > babel > old > babel-test

annotate babel/core.py @ 41:e967fbafcda1