8

Is there any python library to get a list of countries for a specific language code where it is an official or commonly used language?

For example, language code of "fr" is associated with 29 countries where French is an official language plus 8 countries where it's commonly used.

Jon Seigel
  • 12,251
  • 8
  • 58
  • 92
jack
  • 17,261
  • 37
  • 100
  • 125

5 Answers5

19

Despite the accepted answer, as far as I can tell none of the xml files underlying pycountry contains a way to map languages to countries. It contains lists of languages and their iso codes, and lists of countries and their iso codes, plus other useful stuff, but not that.

Similarly, the Babel package is great but after digging around for a while I couldn't find any way to list all languages for a particular country. The best you can do is the 'most likely' language: https://stackoverflow.com/a/22199367/202168

So I had to get it myself...

import lxml.etree
import urllib.request

def get_territory_languages():
    url = "https://raw.githubusercontent.com/unicode-org/cldr/master/common/supplemental/supplementalData.xml"
    langxml = urllib.request.urlopen(url)
    langtree = lxml.etree.XML(langxml.read())

    territory_languages = {}
    for t in langtree.find('territoryInfo').findall('territory'):
        langs = {}
        for l in t.findall('languagePopulation'):
            langs[l.get('type')] = {
                'percent': float(l.get('populationPercent')),
                'official': bool(l.get('officialStatus'))
            }
        territory_languages[t.get('type')] = langs
    return territory_languages

You probably want to store the result of this in a file rather than calling across the web every time you need it.

This dataset contains 'unofficial' languages as well, you may not want to include those, here's some more example code:

TERRITORY_LANGUAGES = get_territory_languages()

def get_official_locale_ids(country_code):
    country_code = country_code.upper()
    langs = TERRITORY_LANGUAGES[country_code].items()
    # most widely-spoken first:
    langs.sort(key=lambda l: l[1]['percent'], reverse=True)
    return [
        '{lang}_{terr}'.format(lang=lang, terr=country_code)
        for lang, spec in langs if spec['official']
    ]

get_official_locale_ids('es')
>>> ['es_ES', 'ca_ES', 'gl_ES', 'eu_ES', 'ast_ES']
Anentropic
  • 32,188
  • 12
  • 99
  • 147
8

Look for the Babel package. It has a pickle file for each supported locale. See the list() function in the localedata module for getting a list of ALL locales. Then write some code to split the locales into (language, country) etc etc

John Machin
  • 81,303
  • 11
  • 141
  • 189
1

As requested by @NoahSantacruz, I add this as a separate answer to make it easier to pick it up. At least since 2017, the easiest method from far is:

babel.languages.get_territory_language_info()

See the docs http://babel.pocoo.org/en/latest/api/languages.html#babel.languages.get_territory_language_info

Rmatt
  • 1,287
  • 1
  • 16
  • 30
-1

Check out Ethnologue

Be careful though...

India has a lot of official languages.

Jed Fox
  • 2,979
  • 5
  • 28
  • 38
NinjaCat
  • 9,974
  • 9
  • 44
  • 64
-2

pycountry (seriously). You can get it from the Package Index.

doug
  • 69,080
  • 24
  • 165
  • 199
  • 7
    I just had a look at the documentation for it, and it doesn't seem like you can provide a language code, and get a list of all the countries that use that language – a_m0d Apr 21 '10 at 06:08
  • might be worth checking again--the reason i say that is because I used this package for a similar purpose (currencies)--*but* i wasn't able to use the interface. Instead i had to work directly with the five XML databases provided in the package. – doug Apr 21 '10 at 06:25