django应用程序开发助手
django-app-helper的Python项目详细描述
警告
这个项目以前叫做djangocms助手。已经改名了 在版本2.0中澄清它不限于django cms应用程序。
有关详细信息,请参见Migrating from djangocms-helper to django-app-helper。
django应用程序开发助手
django app helper是一组命令和helper方法 使可重用django应用程序的开发和测试更加容易。
它诞生于Django CMS生态系统中,提供了很多实用性 开发、运行和测试Django CMS应用程序的功能。
这是django cms自己的develop.py脚本的修改版本,修改后 处理通用应用程序开发过程。
支持的版本
Python:2.7、3.5、3.6、3.7
django:1.11、2.0、2.1
Django CMS:3.4、3.5、3.6
新版本可能可以工作,但尚未测试。
常见选项
- --cms:加载配置以正确运行基于django cms的应用程序;
- --extra-settings:设置额外设置的助手文件的路径;请参阅 Project settings with Django App Helper了解详细信息;
用法
命令必须在主插件目录(即 目录作为setup.py文件),因为它需要导入与 当前目录。
基本的命令结构是:
django-app-helper <application> <command> [options ...]
其中,<;application>;是django应用程序名,<;command>;是其中之一 可用命令的。每个命令的选项都不同。
基本测试等级
基本测试类可用于提供帮助程序和方法 在开发或兼容性垫片期间执行重复任务 (尤其是对于django cms)。
警告
版本1.2中的更改可能会减少测试中执行的查询数 呈现插件。
如果您使用assertNumQueries(或类似的),则 产生意外故障。
请在升级django应用程序帮助程序之前检查代码。
引导
要使用django-app-helper引导项目,您可能需要查看cookiecutter-djangopackage-helper,即django-app-helper的cookiecutter模板。
使用它遵循usage
流道
通过使用设置文件中的集成runned,您将能够运行 不调用django-app-helper的命令:请参见Integrated runner 供参考。
安装
从PIP安装:
pip install django-app-helper
从源安装:
pip install git+https://github.com/nephila/django-app-helper#egg=django-app-helper
要求
- django cms可选;仅在使用--cms选项时才需要
- docopt
- 毒性
- DJ数据库URL
文档
文档可以在readthedocs上找到。