A django model & fixture containing common languages and culture codes
Project description
django-languages-plus provides models and fixtures for working with both common languages and ‘culture codes’ or locale codes, like pt-BR.
Note that this is only a small (but popular) subset of all living languages, and is not even a comprehensive set of the ISO 639 languages. It does however include the endonym/autonym/exonym.
The Language model contains all ISO 639-1 languages and related information from http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
The model provides the following fields (original wikipedia.org column name in parentheses).
name_en (ISO Language Name)
name_native (Native Name)
iso_639_1 (639-1)
iso_639_2T = (639-2/T)
iso_639_2B = (639-2/B)
iso_639_3 = (639-3)
family = (Language Family)
countries_spoken
Installation
pip install django-languages-plus
Usage
Add languages_plus to your INSTALLED_APPS
Migrate your database and load the language data fixture:
python manage.py migrate python manage.py loaddata languages_data.json.gz
In your code use:
from languages_plus.models import Language lang = Language.objects.get(iso_639_1='en')
Generating Culture Codes (ex: pt_BR)
django-countries-plus(https://pypi.python.org/pypi/django-countries-plus) is now an explicit requirement. After installing both packages you can run the following command once to associate the two datasets and generate a list of culture codes (pt_BR for example):
from languages_plus.utils import associate_countries_and_languages associate_countries_and_languages()
Requirements
django-countries-plus >= 1.
Django: Tested against the LTS versions of 3, 4, and the latest of 5. Python 3
Running Tests
Does the code actually work?
$ poetry install $ poetry run pytest
Or for the full tox suite:
$ poetry install $ pip install tox $ tox
