cgitbCGI脚本的回溯管理器

源代码 Lib / cgitb.py


cgitb模块为Python脚本提供了一个特殊的异常处理程序。(它的名称有点误导。它最初设计用于在CGI脚本的HTML中显示大量的追踪信息。后来被推广到alsodis以明文形式显示此信息。)此模块激活后,如果发生anuncaught异常,将显示详细的格式化报告。Thereport包含一个回溯,显示每个级别的源代码的摘录,以及当前运行功能的参数和局部变量的值,以帮助您调试问题。或者,您可以将此信息保存到文件中,而不是将其发送到浏览器.

要启用此功能,只需将其添加到CGI脚本的顶部:

import cgitbcgitb.enable()

enable()函数控制是否在浏览器中显示报告以及报告是否记录到文件以进行后期分析.

cgitb.enabledisplay=1, logdir=None, context=5, format=”html

这个功能导致cgitb模块通过设置sys.excepthook.

的值来接管解释器对异常的默认处理可选参数display默认为1并且可以设置为0tosuppress将回溯发送到浏览器。如果参数logdir存在,则将回溯报告写入文件。的价值 logdir应该是放置这些文件的目录。可选参数context是在回溯中当前源代码行周围显示的上下文行数;这默认为5。如果可选参数format"html",输出格式为HTML。任何其他值都会强制输出纯文本。默认值为"html".

cgitb.textinfo, context=5

此函数处理info(包含sys.exc_info()结果的3元组),将其回溯格式化为文本并将结果作为字符串返回。可选参数context是在回溯中显示当前源代码行周围的上下文行数;这默认为5.

cgitb.htmlinfo, context=5

这个函数处理info所描述的异常(包含sys.exc_info()结果的3元组)),将其回溯格式化为HTML并将结果作为字符串返回。可选参数context是在回溯中显示当前源代码行周围的上下文行的数量;这默认为5.

cgitb.handlerinfo=None

此函数使用默认设置处理异常(即在浏览器中显示isport,但不记录到文件)。这可以在您捕获异常并想要使用cgitb报告时使用。可选的info参数应该是一个包含异常类型,exceptionvalue和traceback对象的3元组,就像sys.exc_info()返回的元组一样。如果没有提供info参数,则可以从sys.exc_info().