Hi,
there is another update for Fluent Anvil! It know comes with extensive data from the IETF Language Subtag Registry and the Common Locale Data Repository.
The IETF Language Subtag Registry practically defines tags for all known languages (including almost extinct ones). Fluent Anvil comes with a preprocessed copy of this registry (excluding obsolete and duplicate tags). You can easily use it to create dropdowns that allow your users to define a locale. For example, your users may upload a document and provide the locale it is written in.
You can access this registry by using one of the following functions:
from fluent_anvil.lib import fluent
# Returns a dictionary with language tags as keys and the name of the language as value.
# Example:
# {
# 'soa': 'Thai Song',
# 'adf': 'Dhofari Arabic',
# 'atv': 'Northern Altai',
# 'aqm': 'Atohwaim',
# ...
# }
fluent.get_language_options()
# Returns a dictionary with region tags as keys and the name of the region as value.
# Example:
# {
# '419': 'Latin America',
# 'TL': 'Timor-Leste',
# 'GD': 'Grenada',
# 'SA': 'Saudi Arabia',
# 'LU': 'Luxembourg',
# 'ID': 'Indonesia',
# 'PF': 'French Polynesia',
# ...
# }
fluent.get_region_options()
# Returns a dictionary with script tags as keys and the name of the script as value.
# Example:
# {
# 'Glag': 'Glagolitic',
# 'Loma': 'Loma',
# 'Batk': 'Batak',
# 'Avst': 'Avestan',
# 'Khmr': 'Khmer',
# ...
# }
fluent.get_script_options()
While IETF language tags are used to compose an arbitrary locale code (even nonsensical ones like “de-SA” for German as spoken in Saudi Arabia), the Common Locale Data Repository (CLDR) provides locale information like country names, month names, currency names, currency formatting, etc. for real locale codes such as “yue-Hant” for Traditional Cantonese. You can obtain all available locale options by using:
from fluent_anvil.lib import fluent
# Returns a dictionary with locale codes as keys and the name of the locale as value.
# Example:
# {
# 'en-MS': 'English (Montserrat)',
# 'ksh': 'Colognian',
# 'fr-CF': 'French (Central African Republic)',
# 'wae': 'Walser',
# 'pt-LU': 'Portuguese (Luxembourg)',
# 'fr': 'French',
# 'en-JE': 'English (Jersey)',
# ...
# }
fluent.get_locale_options()
You can also obtain possible currency options like this:
from fluent_anvil.lib import fluent
# Returns a dictionary with currency tags as keys and the name of the currency as value.
# Example:
# {
# 'IQD': 'Iraqi Dinar',
# 'SDP': 'Sudanese Pound (1957–1998)',
# 'ARL': 'Argentine Peso Ley (1970–1983)',
# 'ESA': 'Spanish Peseta (A account)',
# 'MAD': 'Moroccan Dirham',
# 'AWG': 'Aruban Florin',
# 'CHF': 'Swiss Franc',
# 'GNF': 'Guinean Franc',
# ...
# }
fluent.get_currency_options()
All names returned by the get_[something]_options() (i.e. the dictionary values) are given in the selected locale or one of the selected fallback locales (as set by fluent.set_locale()) if the user’s browser can translate them. If not, the names are returned in English. If you would rather omit the name than bother your users with an English translation, you can do so by setting the translatable_only parameter of these functions to True.
All these functions also have a style parameter that can be set to one of the following:
- fluent.STYLE_DIALECT_NARROW ; e.g. “Traditional Chinese (Hong Kong)”
- fluent.STYLE_DIALECT_SHORT
- fluent.STYLE_DIALECT_LONG
- fluent.STYLE_STANDARD_NARROW ; e.g. “Chinese (Traditional, Hong Kong)”
- fluent.STYLE_STANDARD_SHORT
- fluent.STYLE_STANDARD_LONG
Note that not all styles lead to a different result for all subtags or locale codes. In fact, the results are often the same for multiple styles. This is not a bug, because how the styles are interpreted depends on the selected output locale (as set by fluent.set_locale()) as well as the locale code or subtag that shall be translated.
If you already have a subtag, locale code, or currency code, you can translate it into the locale selected by fluent.set_locale() like this:
from fluent_anvil.lib import fluent
# Returns "American English"
fluent.get_locale_name("en-US")
# Returns "Germany"
fluent.get_region_name("DE")
# Returns "Latin"
fluent.get_script_name("Latn")
# Returns "Icelandic Króna"
fluent.get_currency_name("ISK")
The style parameter explained above is also available for all get_[something]_name() functions.
More information is available on Fluent Anvil’s Github Repository.
Everything described above is available starting now!
Enjoy! 