mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-09-26 20:19:16 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Fixed #27449 -- Added django.utils.translation.get_supported_language_variant().

Browse source
This commit is contained in:
Sebastian Sangervasi 2017-06-27 16:50:26 -07:00 • committed by Tim Graham
parent 5033999153
commit 7905815510
5 changed files with 74 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/ref/utils.txt
View file

@ -1092,6 +1092,23 @@ functions without the ``u``.
for whether its path begins with a language code listed in the
:setting:`LANGUAGES` setting.
.. function:: get_supported_language_variant(lang_code, strict=False)
.. versionadded:: 2.1
Returns ``lang_code`` if it's in the :setting:`LANGUAGES` setting, possibly
selecting a more generic variant. For example, ``'es'`` is returned if
``lang_code`` is ``'es-ar'`` and ``'es'`` is in :setting:`LANGUAGES` but
``'es-ar'`` isn't.
If ``strict`` is ``False`` (the default), a country-specific variant may
be returned when neither the language code nor its generic variant is found.
For example, if only ``'es-co'`` is in :setting:`LANGUAGES`, that's
returned for ``lang_code``\s like ``'es'`` and ``'es-ar'``. Those matches
aren't returned if ``strict=True``.
Raises :exc:`LookupError` if nothing is found.
.. function:: to_locale(language)
Turns a language name (en-us) into a locale name (en_US).

3
docs/releases/2.1.txt
View file

@ -162,7 +162,8 @@ Generic Views
Internationalization
~~~~~~~~~~~~~~~~~~~~
* ...
* Added the :meth:`~django.utils.translation.get_supported_language_variant`
function.
Management Commands
~~~~~~~~~~~~~~~~~~~