如何调试 Mako 模板？

Question

到目前为止，我发现当 Mako 模板编码不正确时，不可能生成可用的回溯。

除了迭代每一行代码之外，还有什么方法可以调试模板吗？

Answer 1

Mako 实际上提供了一种非常好的方法来跟踪模板中的错误：

from mako import exceptions

try:
    template = lookup.get_template(uri)
    print template.render()
except:
    print exceptions.html_error_template().render()

Answer 2

查看 Flask-Mako 源代码，我发现了一个名为 MAKO_TRANSLATE_EXCEPTIONS。

在 Flask 应用程序配置中将其设置为 False，您将从模板中得到很好的异常。 这完成了与 @Mariano 建议相同的事情，而不需要编辑源代码。 显然，这个参数是在马里亚诺回答后添加的。

Answer 3

我把它们分解成碎片，然后当我发现问题时重新组装这些碎片。

不好，但是很难判断一个大而复杂的模板出了什么问题。

Answer 4

我对 Mako 的主要不满是很难看出模板中发生了什么。 由于模板代码是内存中的可运行对象，因此调试器无法查看它。

一种解决方案是将模板代码写入文件，然后使用该文件作为标准 python 模块重新运行模板。 然后你就可以随心所欲地调试了。

一个例子：

import sys
from mako import exceptions, template 
from mako.template import DefTemplate
from mako.runtime import _render

<Do Great Stuff>

try:
    template.render(**arguments))
except:
    # Try to re-create the error using a proper file template
    # This will give a clearer error message.
    with open('failed_template.py', 'w') as out:
        out.write(template._code)
    import failed_template
    data = dict(callable=failed_template.render_body, **arguments)
    try:
        _render(DefTemplate(template, failed_template.render_body),
                failed_template.render_body,
                [],
                data)
    except:
        msg = '<An error occurred when rendering template for %s>\n'%arguments
        msg += exceptions.text_error_template().render()
        print(msg, file=sys.stderr)
        raise

Answer 5

使用flask_mako，我发现更容易跳过TemplateError 生成并忽略异常。 即在flask_mako.py 中，注释掉导致TemplateError 的部分，然后进行引发：

def _render(template, context, app):
 """Renders the template and fires the signal"""
app.update_template_context(context)
try:
    rv = template.render(**context)
    template_rendered.send(app, template=template, context=context)
    return rv
except:
    #translated = TemplateError(template)                                                                                                                 
    #raise translated                                                                                                                                     
    raise

}

然后您将看到导致问题的常规Python 异常以及模板中的行号。

Answer 6

将两个最佳答案与我自己的特殊酱相结合：

from flask.ext.mako import render_template as render_template_1
from mako import exceptions

app.config['MAKO_TRANSLATE_EXCEPTIONS'] = False    # seems to be necessary

def render_template(*args, **kwargs):
    kwargs2 = dict(**kwargs)
    kwargs2['config'] = app.config     # this is irrelevant, but useful
    try:
        return render_template_1(*args, **kwargs2)
    except:
        if app.config.get('DEBUG'):
            return exceptions.html_error_template().render()
        raise

它包装了库存“render_template”函数：

• 捕获异常，以及
  • 如果进行调试，则渲染回溯
  • 如果不进行调试，请再次引发异常，以便将其记录下来
• 使配置可以从页面访问（不相关）