Make django.utils.translation.trans_real.get_supported_language_variant public API

[Iacopo Spalletti]

How about making django.utils.translation.trans_real.get_supported_language_variant part of the public API?

A use case for this: Check if a given language is within the ones listed in LANGUAGES, including the sublanguages, as stated in ​https://docs.djangoproject.com/en/1.10/topics/i18n/translation/:

This example restricts languages that are available for automatic selection to German and English (and any sublanguage, like de-ch or en-us).

Example: ​https://github.com/django-parler/django-parler/issues/156

Making this public will involve:

• Adding documentation
• Exposing it in django.utils.translation

[Ingo Klöcker]

I think it makes sense to make it public API. It also seems to be fairly easy to do.

[Iacopo Spalletti]

I will work on a patch

[Lee Cartwright]

It's been a while since this ticket was updated. Are there any objections to me taking it on?

[Sebastian Sangervasi]

This seems to have gone unattended for four months, so I worked on it as a first contribution. I have a pull request ready to go, so I'm going to claim this.

[Sebastian Sangervasi]

I have submitted a pull request: ​https://github.com/django/django/pull/8682

I followed procedure for the creation of new tests and all tests pass. However, I had some questions about how tests are being done for translation. I'm going to ask these these questions on the pull request, but I can move them here if that is preferred.

[Sebastian Sangervasi]

My patch has been reviewed and, after some documentation updates, should be ready to merge into 2.1.

[Tim Graham <timograham@…>]

In 7905815:

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