strainer 0.1.4

提供中间件，用于检测和纠正通过大多数Python Web框架使用的标准WSGI协议提供服务的Web页面的错误。默认情况下，验证错误使用标准Python日志模块记录到“strainer.middleware”通道。

您应该阅读您的Web框架的文档，以了解如何获取负责提供您的网站的“WSGI应用程序”。例如，在Pylons中，可以在config/middleware.py文件中添加以下代码。

将HTML/XHTML/XML格式正确性验证添加到您的WSGI应用程序中

>>> from strainer.middleware import WellformednessCheckerMiddleware
>>> app = WellformednessCheckerMiddleware(app)

这使用expat解析器来检测大多数语法错误和标签不匹配，但它不会执行更严格的检查，例如检测不允许的子标签或属性，以使文档结构符合XHTML DTD。为此，您应安装最新版本的lxml（例如，“easy_install lxml”），并使用XHTMLValidatorMiddleware，代码如下

>>> from strainer.middleware import XHTMLValidatorMiddleware
>>> app = XHTMLValidatorMiddleware(app)

将JSON验证添加到您的WSGI应用程序中

>>> from strainer.middleware import JSONValidatorMiddleware
>>> app = JSONValidatorMiddleware(app)

如果您的Web框架没有为记录到“strainer.middleware”通道的错误消息提供替代处理器，您可以使用以下方式将它们打印到sys.stderr

>>> import logging
>>> logging.basicConfig()

将自动纠正常见的HTML和XHTML错误添加到您的WSGI应用程序中

>>> from strainer.middleware import XHTMLifyMiddleware
>>> app = XHTMLifyMiddleware(app)

这有些实验性，但如果有更多的人使用它并给我们发送错误报告，它将改进得更快...

与所有（或至少大多数）WSGI中间件一样，您也可以将它们组合

>>> app = XHTMLifyMiddleware(app)
>>> app = XHTMLValidatorMiddleware(app)
>>> app = JSONValidatorMiddleware(app)

本包中的中间件内部缓冲输出（这违反了PEP 333规范，但似乎不可避免），因此最好在中间件堆栈的顶部使用它们。