早就听说了django-debug-toolbar的大名,但一直没有尝试过,是不是有点太OUT啦?!今天偶然又看到了它,版本已经更新到
0.8.1了,于是就下载了最新版本,试用了一下。配置过程本来很简单,但也经过了一番小折腾,这里记录下来,分享给后来人。
首先,请猛击
这里下
载,我下载了当前的最新release版本0.8.1,我的环境是XP+Python2.5+Django1.1.1。接下来按照官方的文档进行配置。
1.解压缩下载来的安装包,执行setup.py install进行安装。官方文档说第一步先添加debug_toolbar目
录到PATHONPATH,其实是没有必要的,安装后已经自动将该目录添加进去了(文档没有更新?)。如果不塌实,可以用下列命令查看一下:
如果没有的话,使用如下命令添加:
sys.path.append('C:\Python25\Lib\site-packages\django_debug_toolbar-0.8.1-py2.5.egg\debug_toolbar')
请注意python的安装路径与实际保持一致。
2.修改django站点的settings.py,进行配置,共有4处。
- 安装debug_toolbar的app,在INSTALLED_APPS中增加如下行:
- 安装debug_toolbar的中间件,在MIDDLEWARE_CLASSES中增加如下行:
'debug_toolbar.middleware.DebugToolbarMiddleware',
文档提示说,如果你的站点启用了压缩中间件:GZipMiddleware,则必须将这一行放到它的后面。反正放到最后一行就对了:)
- 增加INTERNAL_IPS设置,添加如下行代码:
INTERNAL_IPS = ('127.0.0.1',)
- 设置模板,添加debug_toolbar的模板目录到TEMPLATE_DIRS:
'C:/Python25/Lib/site-packages/django_debug_toolbar-0.8.1-py2.5.egg/debug_toolbar/templates',
好了,到这里大功即已告成。注意,如果你是为了测试debug_tool创建了一个新的站点,务必要渲染一个模板,让站点有一个可以访问的页面,否
则是得不到debug_tool的界面的。我就是因为这个原因配置完成后看不到效果,纠结了很久:(。貌似新版本才有这样的限制,见别人配置的旧版本的截
图,在It’s work界面,debug_tool就已经显示出来了。
另外0.8.1跟老版本的UI有很大的改观,不再位于页面的顶部,而放到了页面的右侧,颜色也不再是django的墨绿了,很cool哦:
右侧显示的项目是可以定制的,在settings.py中增加如下配置项,将不需要的项目注释掉即可:
DEBUG_TOOLBAR_PANELS = (
'debug_toolbar.panels.version.VersionDebugPanel',
'debug_toolbar.panels.timer.TimerDebugPanel',
'debug_toolbar.panels.settings_vars.SettingsVarsDebugPanel',
'debug_toolbar.panels.headers.HeaderDebugPanel',
'debug_toolbar.panels.request_vars.RequestVarsDebugPanel',
'debug_toolbar.panels.template.TemplateDebugPanel',
'debug_toolbar.panels.sql.SQLDebugPanel',
'debug_toolbar.panels.signals.SignalDebugPanel',
'debug_toolbar.panels.logger.LoggingPanel',
)
还可以有更灵活的配置,请
猛击这里围
观。好了,开始
debug_toolbar这件利器的体验之旅吧!
本文出自 “江湖” 博客,请务必保留此出处http://firefish.blog.51cto.com/298258/269855