安装django-extensions¶
概要: | 安装django-extensions |
---|
下载和安装¶
通过 pip
或 easy_install
安装¶
可以通过 pip
或 easy_install
安装 django-extensions
$ pip install django-extensions
或:
$ easy_install django-extensions
下载源码安装¶
从 http://pypi.python.org/pypi/django-extensions/ 下载最新的源码.解压缩后,在目录下执行Python安装命令:
python setup.py install
...这样就可以自动安装了. 注: 这是Python默认的包安装方式.
在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命令依赖的程序或库没有安装(或不在当前的环境中),那么这条命令被执行时会抛出异常,并提示缺少的依赖程序或库.
版本控制¶
django-extensions
目前被托管在github上: https://github.com/django-extensions/django-extensions
django command extensions 的dev版本在包含了新特性的同时还可以稳定运行,在正式环境下也推荐使用 [2].
使用git命令克隆 django-extensions
源码到本地:
git clone git://github.com/django-extensions/django-extensions.git
下载源码后可以在项目根目录下执行 python setup.py install
安装,或将 extensions 目录添加到Python环境变量中.最通用的做法是创建一个软连接指向代码的目录,并将软连接添加到Python环境变量中.比如Python的site-packages目录 [3]:
ln -sf /full/path/to/django-extensions/django_extensions /usr/lib/python2.7/site-packages/django_extensions
检查django-extensions是否被正确安装,在Python的shell中输入下面命令 [4]:
>>> import django_extensions
>>> django_extensions.VERSION
(1, 2, 5)
注意:通过git克隆出来的代码比通过源包(pypi)安装的代码版本更新.通过源码安装虽然可能会包含bug或兼容性问题,但也会包含一些新特性.
[1] | vcard是电子名片的格式 |
[2] | 在线上的服务中同样可以使用dev版的command extensions,不过通过pip安装时只会安装stable版本,如果要用dev就要手动安装.注意: 这里推荐的是 command extensions ,而不是 django-extensions |
[3] | Python的环境变量可以在多个地方,译者不认为建立代码目录软连接到系统环境变量的方式不够优美,推荐使用pip安装 |
[4] | 或在shell中执行 python -c ‘import django_extensions;print django_extensions.VERSION’ |