|
@@ -1,53 +0,0 @@
|
|
|
-==========================
|
|
|
-The "local flavor" add-ons
|
|
|
-==========================
|
|
|
-
|
|
|
-Historically, Django has shipped with ``django.contrib.localflavor`` --
|
|
|
-assorted pieces of code that are useful for particular countries or cultures.
|
|
|
-This code is now distributed separately from Django, for easier maintenance
|
|
|
-and to trim the size of Django's codebase.
|
|
|
-
|
|
|
-See the official documentation for more information:
|
|
|
-
|
|
|
- https://django-localflavor.readthedocs.org/
|
|
|
-
|
|
|
-.. _localflavor-packages:
|
|
|
-
|
|
|
-Code is hosted on github at https://github.com/django/django-localflavor.
|
|
|
-
|
|
|
-.. _localflavor-how-to-migrate:
|
|
|
-
|
|
|
-How to migrate
|
|
|
-==============
|
|
|
-
|
|
|
-If you've used the old ``django.contrib.localflavor`` package or one of the
|
|
|
-temporary ``django-localflavor-*`` releases, follow these two easy steps to
|
|
|
-update your code:
|
|
|
-
|
|
|
-1. Install the third-party ``django-localflavor`` package from PyPI.
|
|
|
-
|
|
|
-2. Change your app's import statements to reference the new package.
|
|
|
-
|
|
|
- For example, change this::
|
|
|
-
|
|
|
- from django.contrib.localflavor.fr.forms import FRPhoneNumberField
|
|
|
-
|
|
|
- ...to this::
|
|
|
-
|
|
|
- from localflavor.fr.forms import FRPhoneNumberField
|
|
|
-
|
|
|
-The code in the new package is the same (it was copied directly from Django),
|
|
|
-so you don't have to worry about backwards compatibility in terms of
|
|
|
-functionality. Only the imports have changed.
|
|
|
-
|
|
|
-.. _localflavor-deprecation-policy:
|
|
|
-
|
|
|
-Deprecation policy
|
|
|
-==================
|
|
|
-
|
|
|
-In Django 1.5, importing from ``django.contrib.localflavor`` will result in a
|
|
|
-``DeprecationWarning``. This means your code will still work, but you should
|
|
|
-change it as soon as possible.
|
|
|
-
|
|
|
-In Django 1.6, importing from ``django.contrib.localflavor`` will no longer
|
|
|
-work.
|