installation_instructions.rst

安装django-extensions

概要:	安装django-extensions

安装

在项目中使用

通过 pip 安装

通过 pip 安装 django-extensions

$ pip install django-extensions

给 django-extensions 贡献代码

django-extensions 代码托管在github:

https://github.com/django-extensions/django-extensions

克隆项目后就可以修改源码

开发版本中的 django command extensions 已经十分稳定, 并能够让你更新到最新的修复代码.

安装开发版本的代码:

$ pip install -e git+https://github.com/django-extensions/django-extensions.git#egg=django-extensions

然后在 src/django-extensions 目录下可以看到源码

并且在你的PYTHONPATH环境变量中已经可以使用django-extensions了. 打开命令行, 检查一下是否可用:

>>> import django_extensions
>>> django_extensions.VERSION
(0, 8)

注意: 这种版本的代码会和正式发布的代码有些不同. 可能包含未知bug和兼容性问题, 但总体来说, 还是值得一试的.

在Django中使用

在Django项目的配置文件中,把 django_extensions 添加到 INSTALLED_APPS 列表中:

INSTALLED_APPS = (
    ...
    'django_extensions',
)

这样就可以在Django的命令行中使用 django-extensions 提供的扩展命令了.

再次运行 ./manage.py help 命令时,就可以看到新的命令.

有些新增的命令依赖其它程序或Python库,例如 [1]

• 'export_emails' 需要 python vobject 模块来创建vcard文件
• 'graph_models' 需要 pygraphviz 库来渲染图片文件.

如果执行的django-extensions命令依赖的程序或库没有安装(或不在当前的环境中),那么这条命令被执行时会抛出异常,并提示缺少的依赖程序或库.

[1]	vcard是电子名片的格式