Django 1.8.2 文档

"本地特色"附加功能

由于历史因素,Django自带了django.contrib.localflavor -- 各种各样的代码片段,有助于在特定的国家地区或文化中使用。为了便于维护以及减少Django代码库的体积,这些代码现在在Django之外单独发布。

详见官方文档:

这些代码托管在GIthub上面,https://github.com/django/django-localflavor

如何迁移

如果你使用了老版本的django.contrib.localflavor包,或者 django-localflavor-* 的模板之一,执行这两个简单的步骤就可以更新你的代码:

  1. 在PyPI中安装第三方的django-localflavor 包。

  2. 修改你应用的导入语句来引用新的包。

    例如,将:

    from django.contrib.localflavor.fr.forms import FRPhoneNumberField
    

    ...改为:

    from localflavor.fr.forms import FRPhoneNumberField
    

新的包中的代码和以前一样(它是直接从Django中复制出来的),所以你并不用担心功能上的向后兼容问题。只需要修改导入语句。

弃用政策

在 Django 1.5中,导入django.contrib.localflavor会产生 DeprecationWarning异常。也就是说你的代码还可以继续工作,但是你应该尽快修改它。

在Django 1.6中,导入 django.contrib.localflavor将不会继续工作。