Metadata-Version: 2.1
Name: django-language-fields
Version: 1.0.0
Summary: A pluggable django app that provides a comprehensive language and region choices field
Home-page: https://gitlab.com/smm-guru/django-region-language-fields
Author: Ryan Castner, Evgeny Basmov
Author-email: ryancastner@gmail.com, coykto@gmail.com
License: MIT
Keywords: django,language,languages,region,regions,fields
Platform: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Environment :: Web Environment
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License

========================
django-language-fields
========================

Language and Region Fields for Django apps. Includes all language choices from the IANA Language Subtag Registry.

Included is:

* ``LanguageField``, a model field
* ``RegionField``, a model field

Installation
============

::

    pip install django-language-fields


Basic usage
===========

Add ``languages`` to the list of the installed apps in
your ``settings.py`` file::

    INSTALLED_APPS = [
        ...
        'languages',
        ...
    ]

Then, you can use it like any regular model field::

    from languages.fields import LanguageField, RegionField

    class MyModel(models.Model):
        ..
        language = LanguageField()
        ..

    class MyModel(models.Model):
        ..
        region = RegionField()
        ..

Internally, LanguageField and RegionField are based upon ``CharField`` and by default
represented as strings.

As with ``CharField``'s, it is discouraged to use ``null=True`` use ``blank=True`` if you want to make it a non-required field.


