为涡轮齿轮2提供调试工具栏
tgext.debugbar的Python项目详细描述
关于调试工具栏
debugbar为TurboGears2框架提供了一个调试工具栏。
外露部分为:
- 控制器和渲染时间报告
- 控制器配置文件
- 请求参数、标题、属性和环境
- sqlalchemy查询报告和计时
- 解释并显示执行的sqlalchemy查询的结果
- 列出安装的控制器、它们的路径和公开的方法
- 记录消息
安装
tgext.debugbar既可以从pypi安装,也可以从bitbucket安装:
easy_install tgext.debugbar
应该只对大多数用户有效
与插头一起使用
与任何其他可插入的扩展一样,debugbar可以是 通过内部的Pluggables接口激活 您的app_cfg.py:
from tgext.pluggable import plug plug(base_config, 'tgext.debugbar')
然后调试栏将检查debugconfig选项 当它为false时禁用自身。
在不可插入的情况下使用
而Pluggables接口使 将选项传递到调试栏,您可能希望避免 出于各种原因使用它。在这种情况下你可以 通过添加以下内容启用debugbar 项目行app_cfg.py:
from tgext.debugbar import enable_debugbar enable_debugbar(base_config)
启用日志
当您的响应是json、ajax请求或任何其他 一种不是纯html页面的内容,debugbar 在你的反应中没有注入。 这是为了防止它干扰您的输出 可能会把东西弄坏。
有些情况下,您可能有兴趣访问 从debugbar获取一些信息,即使输出 不是HTML。例如,你可能有兴趣知道 已经执行了哪些查询来检索json响应。
要启用记录此类信息,可以传递enable_logs=True 激活debugbar的plug调用的选项。
发明模式
debugbar提供了发明模式,这样的特性受到了启发 通过原则上的发明来加速实验和原型制作 你的网站。当发明模式是启用网页时 将在您更改时自动更新,作为控制器、模板 或者css改变。
发明模式可以通过传递^{tt6}来启用$ 激活debugbar的plug调用的选项。
如果要禁用css文件的发明模式,可以启用 发明模式,然后传递inventing_css=False选项。