简化 Django 开发的八个 Python 包

简化Django开发的八个Python包

简化Django开发的八个Python包

作者：JeffTriplett

译者：BeliteX

这个月的Python专栏将介绍一些Django包，它们有益于你的工作，以及你的个人或业余工程。

Django开发者们，在这个月的Python专栏中，我们会介绍一些能帮忙你们的软件包。这些软件包是我们最喜欢的Django库，能够节省开发时间，减少样板代码，通常来说，这会让我们的生活更加轻松。我们为Django应用准备了六个包，为Django的REST框架准备了两个包。几乎所有我们的工程里，都用到了这些包，真的，不是说笑。

不过在继续阅读之前，请先看看我们关于让Django管理后台更平安的几个提示，以及这篇关于5个最受欢迎的开源Django包的文章。

有用又省时的工具汇合：django-extensions

django-extensions这个Django包非常受欢迎，全是有用的工具，比方下面这些管理命令：

shell_plus翻开Django的管理shell，这个shell已经自动导入了所有的数据库模型。在测试复杂的数据关系时，就不需要再从几个不同的应用里做导入操作了。

clean_pyc删除工程目录下所有位置的.pyc文件

create_template_tags在指定的应用下，创立模板标签的目录结构。

describe_form输出模型的表单定义，可以粘贴到forms.py文件中。〔需要注意的是，这种办法创立的是普通Django表单，而不是模型表单。〕

notes输出你工程里所有带TODO、FIXME等标记的注释。

Django-extensions还包括几个有用的抽象基类，在定义模型时，它们能满足常见的模式。当你需要下列模型时，可以继承这些基类：

TimeStampedModel：这个模型的基类包含了created字段和modified字段，还有一个save()办法，在适当的场景下，该办法自动更新created和modified字段的值。

ActivatorModel：如果你的模型需要像status、activate_date和deactivate_date这样的字段，可以使用这个基类。它还自带了一个启用.active()和.inactive()查询集的manager。

TitleDescriptionModel和TitleSlugDescriptionModel：这两个模型包括了title和description字段，其中description字段还包括slug，它根据title字段自动产生。

django-extensions还有其他更多的功能，也许对你的工程有帮忙，所以，去浏览一下它的文档吧！

12因子应用的配置：django-environ

在Django工程的配置方面，django-environ提供了合乎12因子应用办法论的管理办法。它是另外一些库的汇合，包括envparse和honcho等。安装了django-environ之后，在工程的根目录创立一个.env文件，用这个文件去定义那些随环境不同而不同的变量，或者需要保密的变量。〔比方API密钥，是否启用调试，数据库的URL等〕

然后，在工程的settings.py中引入environ，并参考官方文档的例子设置好environ.PATH()和environ.Env()。就可以通过env('VARIABLE_NAME')来获取.env文件中定义的变量值了。

创立出色的管理命令：django-click

django-click是基于Click的，〔我们之前推荐过两次Click)，它对编写Django管理命令很有帮忙。这个库没有很多文档，但是代码仓库中有个寄存测试命令的目录，非常有参考价值。django-click根本的HelloWorld命令是这样写的：

#app_name.managementmands.hello.py

importdjclickasclick

@clickmand()

@click.argument('name')

defcommand(name):

click.secho(f'Hello,{name}')

在命令行下调用它，这样执行即可：

>>./manage.pyhelloLacey

Hello,Lacey

处理有限状态机：django-fsm

django-fsm给Django的模型添加了有限状态机的支持。如果你管理一个新闻网站，想用类似于写作中、编辑中、已发布来流转文章的状态，django-fsm能帮你定义这些状态，还能管理状态变化的规那么与限制。

Django-fsm为模型提供了FSMField字段，用来定义模型实例的状态。用django-fsm的@transition修饰符，可以定义状态变化的办法，并处理状态变化的任何副作用。

虽然django-fsm文档很轻量，不过Django中的工作流〔状态〕这篇GitHubGist对有限状态机和django-fsm做了非常好的介绍。

联系人表单：#django-contact-form

联系人表单可以说是网站的标配。但是不要自己去写全部的样板代码，用django-contact-form在几分钟内就可以搞定。它带有一个可选的能过滤垃圾邮件的表单类〔也有不过滤的普通表单类〕和一个ContactFormView基类，基类的办法可以覆盖或自定义修改。而且它还能引导你完成模板的创立，好让表单正常工作。

用户注册和认证：django-allauth

django-allauth是一个Django应用，它为用户注册、登录/注销、密码重置，还有第三方用户认证〔比方GitHub或〕提供了视图、表单和URL，支持邮件地址作为用户名的认证方式，而且有大量的文档记录。第一次用的时候，它的配置可能会让人有点晕头转向；请仔细阅读安装表明，在自定义你的配置时要专注，确保启用某个功能的所有配置都用对了。

处理DjangoREST框架的用户认证：django-rest-auth

如果Django开发中波及到对外提供API，你很可能用到了DjangoRESTFramework〔DRF〕。如果你在用DRF，则你应该试试django-rest-auth，它提供了用户注册、登录/注销，密码重置和社交媒体认证的端点〔是通过添加django-allauth的支持来实现的，这两个包协作得很好〕。

DjangoREST框架的API可视化：django-rest-swagger

DjangoRESTSwagger提供了一个功能丰盛的用户界面，用来和DjangoREST框架的API交互。你只需要安装DjangoRESTSwagger，把它添加到Django工程的已安装应用中，然后在urls.py中添加Swagger的视图和URL模式就可以了，剩下的事情交给API的docstring处理。

API的用户界面按照a