简化 Django 开发的八个 Python 包

编译:linux中国-belitex,英文:Jeff Triplett

https://linux.cn/article-10085-1.html

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

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

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

有用又省时的工具集合:django-extensions

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

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

删除项目目录下所有位置的 .pyc 文件

在指定的应用下,创建模板标签的目录结构。

输出模型的表单定义,可以粘贴到文件中。(需要注意的是,这种方法创建的是普通 Django 表单,而不是模型表单。)

输出你项目里所有带 TODO、FIXME 等标记的注释。

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

:这个模型的基类包含了字段和字段,还有一个方法,在适当的场景下,该方法自动更新和字段的值。

:如果你的模型需要像、和这样的字段,可以使用这个基类。它还自带了一个启用和查询集的 manager。

和:这两个模型包括了和字段,其中字段还包括,它根据字段自动产生。

django-extensions 还有其他更多的功能,也许对你的项目有帮助,所以,去浏览一下它的文档吧!

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

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

然后,在项目的中引入,并参考官方文档的例子设置好和。就可以通过来获取文件中定义的变量值了。

创建出色的管理命令:django-click

django-click是基于Click的,(我们之前推荐过…两次Click),它对编写 Django 管理命令很有帮助。这个库没有很多文档,但是代码仓库中有个存放测试命令的目录,非常有参考价值。 django-click 基本的 Hello World 命令是这样写的:

# app_name.management.commands.hello.py

importdjclickasclick

@click.command()

@click.argument('name')

defcommand(name):

click.secho(f'Hello, ')

在命令行下调用它,这样执行即可:

>>./manage.py hello Lacey

Hello,Lacey

处理有限状态机:django-fsm

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

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

虽然 django-fsm 文档很轻量,不过Django 中的工作流(状态)这篇 GitHub Gist 对有限状态机和 django-fsm 做了非常好的介绍。

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

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

用户注册和认证:django-allauth

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

处理 Django REST 框架的用户认证:django-rest-auth

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

Django REST 框架的 API 可视化:django-rest-swagger

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

API 的用户界面按照 app 的维度展示了所有端点和可用方法,并列出了这些端点的可用操作,而且它提供了和 API 交互的功能(比如添加/删除/获取记录)。django-rest-swagger 从 API 视图中的 docstrings 生成每个端点的文档,通过这种方法,为你的项目创建了一份 API 文档,这对你,对前端开发人员和用户都很有用。

【关于投稿】

如果大家有原创好文投稿,请直接给公号发送留言。

① 留言格式:

【投稿】+《 文章标题》+ 文章链接

② 示例:

【投稿】《不要自称是程序员,我十多年的 IT 职场总结》:http://blog.jobbole.com/94148/

③ 最后请附上您的个人简介哈~

看完本文有收获?请转发分享给更多人

关注「Python开发者」,提升Python技能

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20181006B1O3XW00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券