Metadata-Version: 2.1
Name: django-jangle
Version: 0.2a2
Summary: IETF BCP 47 / RFC 5646 language tags in Django
Project-URL: Homepage, https://github.com/egginabucket/jangle
Project-URL: Documentation, https://jangle.readthedocs.io/en/latest/
Author-email: Hannah Einstein <hannah.a.einstein@gmail.com>
License-File: LICENSE.txt
Keywords: django,iso 639,language tags,rfc 5646,rfc5646
Classifier: Framework :: Django :: 4.1
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.10
Requires-Dist: django>=4.1
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: django-stubs; extra == 'dev'
Requires-Dist: hatch; extra == 'dev'
Requires-Dist: ipython; extra == 'dev'
Requires-Dist: isort; extra == 'dev'
Requires-Dist: sphinx; extra == 'dev'
Requires-Dist: wheel; extra == 'dev'
Description-Content-Type: text/markdown

# jangle

IETF BCP 47 / RFC 5646 language tags in Django

---

[![PyPI Version](https://img.shields.io/pypi/v/django-jangle.svg)](https://pypi.org/project/django-jangle/)
[![License](https://img.shields.io/pypi/l/django-jangle.svg)](https://pypi.org/project/django-jangle/)
[![Python Versions](https://img.shields.io/pypi/pyversions/django-jangle.svg)](https://pypi.org/project/django-jangle/)
[![Read the Docs](https://img.shields.io/readthedocs/jangle.svg)](https://jangle.readthedocs.io/en/latest/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

## Use in your project!

Install jangle from PyPI:

`pip install django-jangle`

...or the latest version from GitHub:

`pip install git+https://github.com/egginabucket/jangle.git`

Add jangle to your project's installed apps:

```
# settings.py

INSTALLED_APPS = [
    ...
    "jangle",
]
```

Migrate database:

`python manage.py migrate`

Save jangle data to the project's database:

`python manage.py loadjangledata`

## Documentation

Documentation is available at [jangle.readthedocs.io](https://jangle.readthedocs.io/en/latest/). Currently a work in progress.

## Some data provided

- [ISO 15924 scripts](https://www.unicode.org/iso15924/) from unicode.org
- [ISO 639-1, 639-2/b, 639-2/t](https://www.loc.gov/standards/iso639-2/langhome.html) and [639-5](https://www.loc.gov/standards/iso639-5/) codes and names from the Library of Congress
- [ISO 639-3 code set, names and macrolanguages](https://iso639-3.sil.org/code_tables/download_tables) from SIL International
- ISO 3166-1 and UN M.49 regions - currently a WIP
- Full [IANA subtag registry](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry) saved across various tables, including grandfathered and redundant tags. Linked with other standards and used to construct and verify language tags
